Launching the Unwrella user interface


To launch the Unwrella plug-in, select Create UVs->Unwrella from the Polygons menu to open the Unwrella user interface.

In Maya 2016 the menu Create UV’s has been renamed to just UV.

The Unwrella user interface


UV Set - Destination UV set. This is where the generated UV’s will be stored. If you leave the field ‘new’ empty the existing set that is selected in the dropdown will be used. If you enter a name into the field new a UV set with that name will be created and used to store the unwrap result.

Unwrap Mode - Picks the unwrapping method.

  • Organic unwrapping - this mode is suited for irregular shapes.

  • Hard surface - this mode is more suited for many architectural objects where organic unwrapping produces too fragmented results.

Texture stretch - The amount of stretching allowed. 0 means no stretching is allowed, 1 means any amount of stretching can be used.

Gutter padding - Distance between charts in the texture.

Texture Width - Texture width.

Texture Height - Texture height.

Lock Aspect Ratio - While this is enabled Unwrella will produce an unwrap for a square texture map. The Height option is consequently ignored and the width determines both dimensions. Disabling this option allows for unwraps suitable for non-square texture maps.

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

Keep Borders - If checked all UV borders that already exist on the mesh in the currently active UV set will be kept while unwrapping. This results in unwrapping results that are more conformant with certain workflows (i.e. manual texture painting). Please see the chapter about manually placed borders for further information.

Cut Grooves - Adds seams to edges that form a groove. The angle defines the threshold for seam placement. If the angle between the normals is higher than the given angle, a seam will be added.

Cut Ridges - Adds seams to edges that form a ridge. The angle defines the threshold for seam placement. If the angle between the normals is higher than the given angle, a seam will be added.

Tile UV - When this option is enabled the UV charts will not all be put into the default UV area (0.0 - 1.0) but go beyond the 1.0 coordinate and provide multiple UV areas to be used by multiple texture maps.

Tile Columns - This option defines how many UV tile columns exist. By default Unwrella uses 10 columns (spanning from U coordinate 0.0 to 10.0). This is the number of colums used by default in Mari. If more tiles are used multiple rows will be created accordingly.

Max Tile Number - This defines the maximum number of tiles that receive charts. If the amount of UV charts is less or equal this number each chart will have its own tile. If more charts exist some of them will share a tile. Unwrella automatically distributes the charts based on size. Smaller charts sharing a tile will be preferred while larger charts can receive a tile on their own.

Unwrap - Unwrap the UV map. This creates a new modifier node for each selected mesh, calculates the new UV data and writes it into the selected (or new generated) UV Set. Using this button multiple times will add multiple Unwrella nodes to a mesh, not edit the parameters of already erxisting nodes. If you want to change your settings after applying Unwrella use Maya’s attribute editor instead.

The attribute editor interface


Since Unwrella’s calculation is quite time consuming the node does not automatically propagate changes made in this interface or other nodes that are executed before Unwrella’s node to the output. In order to update Unwrella’s output you have to use the Apply button in the attribute editor. See the chapter ‘Updating Unwrella’s output’ for more information. Most settings in this interface correspond to the functionality of the Unwrella user interface. Notable differences are:

Visualization - This checkbox allows you to disable the colored border visualization in the model viewports. By default unwrella draws the borders that were already on the object before unwrella was applied in green color and borders that were added by Unwrella in blue color. This option only toggles the visualization for the current Unwrella node, not for any other Unwrella nodes that are in the scene or even the same graph.

Results - This displays the actual number of charts and the maximum stretch factor that occurs in the unwrapped UV set.