Scripting

To use Unwrella through MEL script use the command ‘unwrella’

Some of the previously available properties have been deprecated to simplify usage of the plug-in. Those properties can still be used without causing an error for backwards compatibility but they will no longer affect the plug-in operation.

Flags

-mapchannel (-mc) : string

Destination UV set. This is where the generated UV map will be stored.

-unwrap_type (-t) : int

Unwrap type used by Unwrella: 0 - Standard unwrap type optimized for organic shapes, 1 - Unwrap type for hard surface shapes.

-stretch (-st) : float

The amount of stretching allowed. 0.0 means no stretching is allowed, 1.0 means any amount of stretching can be used.

-padding (-pad) : int

Distance between charts in the texture.

-width (-w) : int

Texture width of the UV and the baked map.

-height (-h) : int

Texture height of the UV and the baked map.

-high_quality (-hq) : boolean

Use high quality unwrap mode. This will consume more space in RAM and take longer, but will produce more accurate results. (Less stretch, charts packed tighter.)

-use_grooves (-ug) : boolean

If True the unwrapping process will automatically add borders to edges at grooves between mesh faces.

-groove_angle (-ga) : float

Defines the angle used for the automatic groove borders.

-use_ridges (-ur) : boolean

If True the unwrapping process will automatically add borders to edges at ridges between mesh faces.

-ridge_angle (-ra) : float

Defines the angle used for the automatic ridge borders.

-tile_mode (-tm) : boolean

If True the unwrapped charts will be distributed across multiple tiles beyond the 0.0 - 1.0 coordinate range. If False all charts will be placed within the 0.0 - 1.0 range.

-tile_columns (-tc) : int

The number of horizontal tiles along the U coordinate.

-tile_number (-tn) : int

The maximum number of tiles to be used. If more charts exist they will be grouped together automativally.

-keep_seams (-ks) : boolean

If True the unwrapping process will retain already existing borders as long as the given constraints allow. If False all already existing borders are discarded and Unwrella places new borders autonomously.

Example Script

This example creates a sphere, applies the modifier to it and unwraps it with a very small amount of stretching.

polySphere -r 10;
unwrella -st 0.01 -pad 1 -w 1000 -h 1000 -hq true;