Skip to content

UV Kit 2.0#

Installation#

Compatibility#

Maya 2018 2019 2020 2022

How to install#

  1. Extract the RS_Assets folder from the RS_Assets.zip

  2. Extract RS_UV_Kit.pyc either from RS_UV_Kit_M2020_and_below.zip or RS_UV_Kit_M2022.zip (depending on your Maya Version)

  3. Copy RS_UV_Kit.pyc or RS_UV_Kit.py (Studio Version) and the RS_Assets folder to:

    Attention

    If an RS_Assets folder already exists in the location below, please copy the RS_UV_Kit folder (from inside the extracted RS_Assets folder) and paste it into the RS_Assets folder in the location below.

    Windows

    1
    \Users\USERNAME\Documents\maya\MAYAVERSION\scripts
    

    Linux

    1
    $HOME/maya/MAYAVERSION/scripts
    

    Mac

    1
    $HOME/Library/Preferences/Autodesk/maya/MAYAVERSION/scripts
    
  4. Launch / Restart Maya

  5. In Maya, open a Python Tab in the Script Editor and execute :

    Attention

    Please make sure that there are no Space characters in front of each code line.

    Maya 2020 and below

    1
    2
    3
    import RS_UV_Kit
    reload(RS_UV_Kit)
    RS_UV_Kit.MainClass_UVKit.show_uvKit_dialog()
    

    Maya 2022

    1
    2
    3
    4
    from importlib import reload
    import RS_UV_Kit
    reload(RS_UV_Kit)
    RS_UV_Kit.MainClass_UVKit.show_uvKit_dialog()
    

    Maintain settings during a Maya instance

    The code above will load a new instance of the tool every time it is executed. To maintain the settings during a Maya session, even if the tool is closed, use the code below:

    1
    2
    import RS_UV_Kit
    RS_UV_Kit.MainClass_UVKit.show_uvKit_dialog()
    

Environment Variables#

  1. To set and use a custom folder location, please open the Maya.env file.

    The Maya.env file is located here

    Windows

    1
    \Users\USERNAME\Documents\maya\MAYAVERSION
    

    Linux

    1
    $HOME/maya/MAYAVERSION
    

    Mac

    1
    $HOME/Library/Preferences/Autodesk/maya/MAYAVERSION
    
  2. Add the following lines to the Maya.env file:

    1
    2
    3
    MAYA_SCRIPT_PATH = path\to\your\custom\script\folder
    PYTHONPATH = path\to\your\custom\script\folder
    RS_TOOLS_PATH = path\to\your\custom\script\folder
    

    Attention

    1. Replace path\to\your\custom\script\folder with the actual path to your scripts.
    2. Make sure there is no forward slash (/) or backward slash (\) at the end of the path.

Interface Basics#

Tool Menu#

Screenshot   UV Tools

Screenshot   UV Editor / UV Sets Editor

Screenshot   About / Links / Shortcuts

Tool Settings#

Indicator

A blue line underneath an icon indicates that optional tool settings are available.

Screenshot

How to open?

Open the settings with a RMB 2 click.

Position & What settings are open?
  1. The settings widget will appear at the bottom of the tool.

  2. The background of an icon button turns dark gray to indicate it's settings are currently open.

Screenshot

How to close?

To close the settings page RMB 2 click the active button again.

Tooltips#

  1. Hover over a button until a tooltip shows up.
  2. Tooltips include information about available Modifier Alt Ctrl Shift and RMB 2 settings options.

Screenshot

Please make sure that tooltips are enabled!

In Maya's main menu go to:

Windows > Settings / Preferences > Preferences > Interface > Help

and check DisplayToolClips under PopupHelp

Expand / Collapse tabs#

It is possible to expand or collapse all tabs on an active page.

Expand

Ctrl   click on Screenshot

Collapse

Alt   click on Screenshot

Note

A settings page will automatically close when expand or collapse all tabs is used.

Keyboard Shortcuts#

It is possible to control aspects of the tools interface with keyboard shortcuts.

Access pages

1   -   UV Tools Page

2   -   About Page

3   -   Toggle Tool Menu Visibility

Requirements

The tool needs to have focus, for the shortcuts to work.

Expand / collapse tabs

 Ctrl   +   1   to expand all tabs on the UV Tools Page

  Alt   +   1   to collapse all tabs on the UV Tools Page

Attention

This only works on the currently active page.

Minimize to main menu

 Alt   +   3 to minimize the tool

Screenshot

UV Editor / UV Sets Editor#

Open UV Editor:   LMB 1 click   Screenshot

Open UV Sets Editor:   Alt   click   Screenshot

About Page#

Access the About page by clicking on Screenshot

The page contains information about the tool, several web links and an option to set up hotkey shortcuts.

Interface - About Page#

Screenshot

Create Hotkey Shortcuts#

Click on the Create Hotkey Shortcuts button to make a UV Kit launch function available within Maya's hotkey editor.

Screenshot

Info

Access the Hotkey Editor under Windows > Settings/Preferences > Hotkey Editor

Unfold Tab#

Interface - Unfold Tools#

Screenshot

Unfold Screenshot#

Automatically cuts selected edges, unfolds (based on Unfold 3D) and packs the shells.

Screenshot

How to use

  1. Make a UV projection of your object. (LMB 1 click Screenshot )

    Tip

    For best results make a Camera instead of an orthographical (X, Y, Z) projection.

  2. Select your desired cutting edges

  3. Click on Screenshot to run the script

Settings

Screenshot

Projection Screenshot#

Create UV texture coordinates for the selected object using a planar projection shape.

How to use

  1. Camera: LMB 1 click Screenshot
  2. X-Axis:   Alt   click Screenshot
  3. Y-Axis:   Ctrl   click Screenshot
  4. Z-Axis:   Shift   click Screenshot

U / V Screenshot#

Unfolds UV selections horizontally, vertically or freely in both directions.

How to use

  1. Horizontal Unfold: LMB 1 click Screenshot
  2. Vertical Unfold:   Alt   click Screenshot
  3. Free Unfold   Ctrl   click Screenshot
  4. Pin selected UVs during Unfold: Add   Shift

Gridify Screenshot#

Automatically unfolds cylindrical shapes based on a cutting edge selection.

How to use

  1. Cylindrical Shape:

    1. Make an edge selection on a cylindrical shape that serves as the cut line

    2. LMB 1 click Screenshot

    Screenshot

  2. Cable with caps:

    1. Make an edge selection that serves as the cut line of the cable

    2.   Alt   click Screenshot

    Screenshot

Layout Tab#

Interface - Layout Tools#

Screenshot

Layout Screenshot#

Arranges the UV shells of objects and scales them uniformly.

How to use

  1. Select objects
  2. Set preferred Shell spacing and Shell rotation in the RMB 2 settings
  3. Layout all objects together:
    1. LMB 1 click Screenshot
    2. Screenshot
  4. Layout each object individually:
    1.   Alt   click Screenshot
    2. Screenshot

Settings

Screenshot

Grid Arrange Screenshot#

Arranges the UV layouts of objects with a uniform scale within a grid pattern.

How to use

  1. Select objects
  2. Set preferred Scale size in the RMB 2 settings
  3. Grid Arrange:
    1. LMB 1 click Screenshot
    2. Screenshot
  4. Grid Arrange and sort by Polygon Count:
    1.   Alt   click Screenshot
    2. Screenshot

Settings

Screenshot

Stack Screenshot#

Stack UV layouts or shells.

How to use

  1. Select objects or UV shells
  2. Set preferred Scale size in the RMB 2 settings (For uniform scale only)
  3. Stack UV Layouts without changing their scale size:
    1. LMB 1 click Screenshot Screenshot
  4. Stack UV Layouts and scale them uniformly:
    1.   Alt   click Screenshot Screenshot
  5. Stack selected UV Shells:
    1.   Ctrl   click Screenshot Screenshot
  6. Unstack selected UV Shells:
    1.   Shift   click Screenshot Screenshot

Settings

Screenshot

Spread Screenshot#

Precisely spread out overlapping UV layouts based on an input value. This operation works with objects and groups.

Screenshot

How to use

  1. Select multiple objects or groups
  2. Set preferred Move size in the RMB 2 settings
  3. Spread:
    1. Right:   LMB 1 click Screenshot
    2. Up:   Alt   click Screenshot
    3. Add   Shift   for opposite directions (Left, Down)

Settings

Screenshot

Modify Tab#

Interface - Modify Tools#

Screenshot

Move Screenshot#

Move selected UVs or UDIMS.

How to use

  1. Move UVs:

    1. Select UVs
    2. Set preferred Move value in the RMB 2 settings
    3. Move:
      1. Right:   LMB 1 click Screenshot
      2. Up:   Alt   click Screenshot
      3. Add   Shift   for opposite directions (Left, Down)

    Screenshot

  2. Move UDIMs:

    1. Select Objects
    2. Set preferred Move value in the RMB 2 settings
    3. Turn UDIM Mode to On
    4. Specify a UDIM Source
    5. Move UDIM:
      1. Right:   LMB 1 click Screenshot
      2. Up:   Alt   click Screenshot
      3. Add   Shift   for opposite directions (Left, Down)

    Screenshot

  3. Move a UDIM to a specific target position:

    1. Select Objects
    2. Turn on both the UDIM and the Target Mode in the RMB 2 settings
    3. Set a Source UDIM (The UDIM you want to move)
    4. Set a Target UDIM (Where you want to move your source)
    5. LMB 1 click Screenshot

    Screenshot

Settings

Screenshot

Rotate Screenshot#

Rotate selected UVs.

How to use

  1. Select UVs or UV Shells
  2. Set preferred Rotation value in the RMB 2 settings
  3. Rotate:

    1. Clockwise:   LMB 1 click Screenshot
    2. Counterclockwise:   Alt   click Screenshot

    Screenshot

  4. Rotate each shell individually:

    1. Add   Shift

    Screenshot

Settings

Screenshot

Scale Screenshot#

Scale selected UVs by value or locally.

How to use

  1. Scale selected UVs by value:
    1. Select UVs or UV Shells
    2. Set preferred Scale size in the RMB 2 settings
    3. LMB 1 click Screenshot
  2. Scale locally:

    1. Select only 1 UV from each UV Shell you want to scale
    2.   Alt   click Screenshot to launch the scale process
    3. In the new window - Use the Slider to interactively scale the UV shells
    4. Click the Done button to finish the process

    Screenshot

Settings

Screenshot

Orient Screenshot#

Orient selected UV Shells.

How to use

  1. Orient to run parallel with the closest U or V axis: LMB 1 click Screenshot
  2. Orient in X-Axis:   Alt   click Screenshot
  3. Orient in Y-Axis:   Ctrl   click Screenshot
  4. Orient in Z-Axis:   Shift   click Screenshot

Straighten Screenshot#

Straighten selected UVs.

How to use

  1. Straighten selected UVs (works best with small curvatures):
    1. Select UVs or UV Shells
    2. LMB 1 click Screenshot Screenshot
  2. Straighten UV Shells:
    1. Select an edge loop of your UV Shell
    2.   Alt   click Screenshot Screenshot

Distribute Screenshot#

Distribute UV Shells.

How to use

  1. Select UVs or UV Shells
  2. Set preferred Spacing value in the RMB 2 settings
  3. Distribute:
    1. Right: LMB 1 click Screenshot
    2. Up:   Alt   click Screenshot
    3. Add   Shift   for opposite directions (Left, Down)

Settings

Screenshot

Equalizer Screenshot#

Match your Objects UV Layout or UV Shells Texel Density to the size of a specified source.

How to use

  1. For Objects:

    1. Select a source object
    2.   Alt   click Screenshot to get the scale size
    3. Select target objects
    4. LMB 1 click Screenshot to set the scale size

    Screenshot

  2. For UV Shells:

    1. Set preferred Map Size in the RMB 2 settings
    2. Select a UV Shell
    3.   Shift   click Screenshot or click on the Get Button in the RMB 2 settings to get the scale size
    4. Select target UV Shells
    5.   Ctrl   click Screenshot to set the scale size

    Screenshot

Settings

Screenshot

Flip Screenshot#

Flip the position of selected UVs or UV shells

How to use

  1. Flip all selected UVs:
    1. LMB 1 click Screenshot
  2. Flip each UV shell from their individual center point:
    1.   Alt   click Screenshot
  3. Flip all backfacing shells automatically (Select an object or UVs):
    1.   Shift   click Screenshot

Align Screenshot#

Align UV shells to a specified reference.

How to use

  1. Select a source UV shell
  2.   Shift   click Screenshot to set it as a reference
  3. Select UV Shells that you want to align
  4. Align:

    1. Horizontally:   LMB 1 click Screenshot

    Screenshot

    1. Vertically:   Alt   click Screenshot

    Screenshot

    1. Match Position:   Ctrl   click Screenshot

    Screenshot

Utilities#

Interface - Utilities#

Screenshot

UV Shader Screenshot#

Creates two UV Shader with custom texture maps (map size is 1K). Useful to check if your UVs are properly unfolded, oriented and equal in size.

Screenshot

How to use

  1. Create / Delete Shader:
    1. Create:   Ctrl   click Screenshot
    2. Delete:   Shift   +   Ctrl   click Screenshot
  2. Assign / Unassign:
    1. Assign Checker Pattern:   LMB 1 click Screenshot
    2. Assign UV Direction:   Alt   click Screenshot
    3. Unassign Shader:   Shift   click Screenshot
  3. Set preferred Texture size in the RMB 2 settings

Settings

Screenshot

Transfer Screenshot#

Transfer UV layouts from source to target objects.

Screenshot

How to use

  1. Set preferred Sample Space and Scope in the RMB 2 settings

  2. Set Source(s): Select Object(s) and click on the Set Sources button in the RMB 2 settings

    Note

    If you have multiple source objects, the script will copy

    from source 1 to target 1

    from source 2 to target 2

    and so on, until there are no sources left.

  3. Set Targets: Select Object(s) and click on the Set Targets button in the RMB 2 settings

  4. Transfer:   LMB 1 click Screenshot

Shortcuts

Set Sources:   Alt   click Screenshot

Set Targets:   Ctrl   click Screenshot

Settings

Screenshot

Fixes Screenshot#

Automatically fix backfacing face normals or UV Shells.

How to use

  1. Backfacing Face normals: Select objects and LMB 1 click Screenshot Screenshot
  2. Backfacing UV Shells: Select objects and   Alt   click Screenshot Screenshot

Remove UV Sets Screenshot#

Automatically remove UV Sets.

How to use

  1. Add UV Set names to exclude in the RMB 2 settings (UV Sets you don't want to delete)
  2. Select objects and LMB 1 click Screenshot

Settings

Screenshot