Unwrap_UVW Modifier - Group

 

   

Unwrap_UVW Modifier - Main Topic

   

Modifier Classes - Quick Navigation

   

The following properties and methods expose the Element Grouping functionality to MAXScript.

   

Group

Properties:

 <Unwrap_UVW>.groupName ArrayParameter default: #() -- string array

Get/set the array of name strings, one element per defined group.

When a group is deleted, its entry on the array will be replaced with a stand-in name "--EMPTYENTRY--".

Setting the array or its elements to new values effectively renames the corresponding Groups.

Available in 3ds Max 2012 and higher.

   

 <Unwrap_UVW>.groupDensity ArrayParameter default: #() -- float array

NEW in 3ds Max 2012: Get/set the array of group densities.

The array will not be resized when a Group is deleted.

Replacing the array or its elements with new float values effectively replaces the Density values of the respective Groups.

Available in 3ds Max 2012 and higher.

EXAMPLE

 --Assuming there are already 3 Groups created using the UI,
$.modifiers[#Unwrap_UVW].groupName --See what the names are...
--> #("__INTERNALCLUSTER_0", "__INTERNALCLUSTER_1", "__INTERNALCLUSTER_2")
$.modifiers[#Unwrap_UVW].groupName[2] = "Test" --Replace second name
-->OK
$.modifiers[#Unwrap_UVW].groupName --Check to see the result
--> #("__INTERNALCLUSTER_0", "Test", "__INTERNALCLUSTER_2")
$.modifiers[#Unwrap_UVW].groupDensity --Look at the Density array
--> #(1.0, 1.0, 1.0)
$.modifiers[#Unwrap_UVW].groupDensity = #(0.8, 0.9, 0.95) --Replace all
--> OK
$.modifiers[#Unwrap_UVW].groupDensity --Look again...
--> #(0.8, 0.9, 0.95)

   

 <Unwrap_UVW>.groupDisplay BooleanClass default: false -- boolean

Get/set the Group Display state.

Available in 3ds Max 2012 and higher.

   

Methods:

<void><Unwrap_UVW>.GroupCreate <string>name

Creates a Group with the specified name by expanding the current map faces selection to element selection.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupDelete <string>name

Deletes the Group with the given name, if it exists. Otherwise does nothing.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupRename <string>name <string>newName

Renames the group specified by the first argument to the name specified by the second argument.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupSelect <string>name

Selects the group with the given name.

The name must be one of the existing group names as returned by the .groupName property.

If the provided name does not exist, this method does nothing.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupCreateBySelection()

Creates a group from the current map faces selection by expanding it to element.

The group will be named automatically according to the pattern "__INTERNALCLUSTER_N" where N is a next free 0-based group index.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupDeleteBySelection()

Deletes the Group containing the element the currently selected map faces are part of (if any).

Equivalent to clicking the "Ungroup Selected" icon in the "Element Properties" rollout of the Edit UVWs Floater panel.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<void><Unwrap_UVW>.GroupSelectBySelection()

Selects the group the currently selected map faces are part of (if any).

Equivalent to clicking the "Select Group" icon in the "Element Properties" rollout of the Edit UVWs Floater panel.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<float><Unwrap_UVW>.GroupGetTexelDensity()

Returns the Group Texel Density as a float.

Corresponds to the value in the "Rescale Priority" spinner in the "Element Properties" rollout of the Edit UVWs Floater panel.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.

   

<float><Unwrap_UVW>.GroupSetTexelDensity <float>value

Sets the Texel Density of the curently selected Group to the specified floating point value.

Corresponds to setting the value in the "Rescale Priority" spinner in the "Element Properties" rollout of the Edit UVWs Floater panel.

Exposed via unwrap6 interface in 3ds Max 2012 and higher.