Unwrap_UVW Modifier - Group
 
 
 
 

   

Unwrap_UVW Modifier - Main Topic

   

Modifier Classes - Quick Navigation

   

The following properties and methods introduced in 3ds Max 2012 expose the Element Grouping functionality to MAXScript.

   

Group

Properties:

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

NEW in 3ds Max 2012: 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.

   

 <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.

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

NEW in 3ds Max 2012: Get/set the Group Display state.

   

Methods:

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

NEW in 3ds Max 2012: 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.

   

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

NEW in 3ds Max 2012: Deletes the Group with the given name, if it exists. Otherwise does nothing.

Exposed via unwrap6 interface in 3ds Max 2012.

   

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

NEW in 3ds Max 2012: Renames the group specified by the first argument to the name specified by the second argument.

Exposed via unwrap6 interface in 3ds Max 2012.

   

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

NEW in 3ds Max 2012: 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.

   

<void><Unwrap_UVW>.GroupCreateBySelection()

NEW in 3ds Max 2012: 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.

   

<void><Unwrap_UVW>.GroupDeleteBySelection()

NEW in 3ds Max 2012: 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.

   

<void><Unwrap_UVW>.GroupSelectBySelection()

NEW in 3ds Max 2012: 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.

   

<float><Unwrap_UVW>.GroupGetTexelDensity()

NEW in 3ds Max 2012: 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.

   

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

NEW in 3ds Max 2012: 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.