1. Unfold3D
 1.1 Introduction
 1.2 Commands
2. Unfolding step by step
3. Cutting
 3.1 How to cut ?
 3.2 Where to cut ?
4. Adjusting and packing
5. UNFOLD3D Interface
 5.1 Menus and tools
 5.2 The menu bar
 5.3 The main toolbar
 5.4 The viewport toolbar
 5.5 The edition toolbar
 5.6 Preferences
6. UV Edition
 6.1 Rotation/translation/scaling
 6.2 Pinning
 6.3 Horizontal, vertical constraints
7. Scripting
6. Scripting

7 - Scripting

Command action

Command syntax

Parameter comment

Default value

Load file

-i <file>

file: path to a .obj file

.

Load file with UVs connectivity

-icuv <file>

file: path to a .obj file

.

Load file with UVs connectivity + merge

-icuvmerge <file>

file: path to a .obj file

.

Smooth

-s <n>

n: number of smoothing iterations

.

Auto unfold

-u

.

.

Set maximum number of unfold ite.

-SETmaxnumberunfoldite <n>

n: maximum number of auto unfold iterations

30

Set stop if one chart failed (unfold) (on/off)

-SETstopifunfoldchartfailed <bool>

bool: 0 or 1

0

Set "iteration display" on/off

-SETdisplayeachiter <bool>

bool: 0 or 1. Turn it off (0) to enhance speed

1

Manual unfolding

-uman <n>

n: number of unfold iterations to do

.

Save

-o <file>

file: path to a .obj file

.

Save as a 3d  model

-o3d <file>

file: path to a .obj file

.

Quit

-q

.

.

.


.

.

Surface adjustment

-a

.

.

Set surface adjustement accuracy

-SETsurfadjust <sample>

sample: set the size of the sampling grid; smaller values give better results but take more computing time

1.0

.

.

.

.

Writte a log file

-log <file>

file: path to a .obj file

.

.

.

.

.

Packing

-pack

.

.

Set chart order mode

-SETordermode <val>

val: 0=increasing in size order, 1=decreasing in size order, 2=random

1

Set random seed

-SETrandomseed <int>

int: set ordering of charts for "random" mode

0

Set spacing beetween charts

-SETspacing <percent>

percent: % of total width

1.0

Set chart rotation

-SETchartrotation <angle>

angle: angle in degrees

0.0

Set rotation accuracy

-SETrotaccuracy <angle>

angle: in degrees; smaller values give a more precise packing but a longer computation.

90.0

Set global scale mode

-SETglobalscale <val>

val: 0 = best fit, 1 = squarify, 2 = metric conservation

0

Set chart scaling mode

-SETchartscale <val>

val: 0 = use opening length,1 = use surface

0

Set positioning accuracy

-SETposaccuracy <percent>

percent: % of total width; smaller values give a more precise packing but a longer computation.

0.4

Set global UV rotation

-SETuvrotation <angle>

<angle>: angle in degrees

0.0

7.2 Examples

EXAMPLE 1 : launch Unfold3D, load a model from "file1.obj", apply 10 smoothing iterations , auto unfold, pack, save to "fileout.obj" and quit.

c:\>"c:\Program Files\Unfold3D\unfold3dwizard" -i file1.obj -s 10 -u -pack -o fileout.obj -q

EXAMPLE 2 : launch Unfold3D, load "model1.obj", auto unfold, pack, save, load "model2.obj" , auto unfold, pack, save to and quit.

c:\>"c:\Program Files\Unfold3D\unfold3dwizard" -i model1.obj -u -pack -o model1.obj -i model2.obj -u -pack -o model2.obj -q

IMPORTANT NOTE : : The install path of Unfold3D must appear in the command line :

c:\>"c:\Program Files\Unfold3D\unfold3dwizard" *somme_commands*

If you call the following command: 

c:\Program Files\Unfold3D\>unfold3dwizard *somme_commands*

Unfold3D will not find its dictionnary and all text messages will become "message not found"...