Unwrap_UVW Modifier - Select and Transform

 

   

Unwrap_UVW Modifier - Main Topic

   

Modifier Classes - Quick Navigation

   

The following methods provide access to the sub-object selection in the Edit UVWs Floater and allow the transformation of mapping sub-object elements through MAXScript:

   

Selection Lock State

Methods:

<boolean><Unwrap_UVW>.getLock() 

Returns the state of the selection Lock.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setLock <boolean>lock 

Sets the state of the selection Lock.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Vertex Weight (Soft Selection)

Methods:

<float><Unwrap_UVW>.getVertexWeight <integer>index 

Returns the Vertex Weight of the specified vertex.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setVertexWeight <integer>index <float>weight 

Sets the Vertex Weight of the specified vertex to the supplied value.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.isWeightModified <integer>index 

Returns true if the specified vertex has been affected by soft selection, false otherwise.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.modifyWeight <integer>index <boolean>modify 

Sets whether the specified vertex should be modified by soft selection.

If a vertex is modified it ignores regular UI soft selection and the vertex soft selection weight is locked to it current state and can only be changed by thesetVertexWeightmethod.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Convert Selection

Methods:

<void><Unwrap_UVW>.vertToEdgeSelect() 

Convert the Vertex Selection to Edge Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.vertToFaceSelect() 

Convert the Vertex Selection to Face Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.edgeToVertSelect() 

Convert the Edge Selection to Vertex Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.edgeToFaceSelect() 

Convert the Edge Selection to Face Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.faceToVertSelect() 

Convert the Face Selection to Vertex Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.faceToEdgeSelect() 

Convert the Face Selection to Edge Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Select Inverted and Overlapped Faces

<void><Unwrap_UVW>.selectInvertedFaces() 

Selects the inverted faces.

Exposed via unwrap4 interface in 3ds Max 7 and higher.

   

<void><Unwrap_UVW>.selectOverlappedFaces() 

Selects overlapped faces.

Corresponds to the Select>Select Overlapped Faces option in the Edit UVWs dialog menu bar.

Exposed via unwrap5 interface in 3ds Max 8 and higher.

   

Selection Modes

Methods:

<void><Unwrap_UVW>.expandSelection() 

Presses the "Grow Texture Selection" button.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.contractSelection() 

Presses the "Shrink Texture Selection" button.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<boolean><Unwrap_UVW>.getTVElementMode() 

Returns the state of the Select Element checkbox in the Selection Modes group of the Editor’s panel.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setTVElementMode <boolean>mode 

Sets the state of the Select Element checkbox in the Selection Modes group of the Editor’s panel.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.options() 

Presses the Options... button in the edit floater.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

Paint Selection

Methods:

<boolean><Unwrap_UVW>.getPaintSelectMode() 

Returns the PaintSelect Mode.

When set to true , the tiled images are blended to the background color or black

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setPaintSelectMode <boolean>paint 

Sets the PaintSelect Mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<integer><Unwrap_UVW>.getPaintSelectSize() 

Returns the size of the paint select brush. Will be clamped between 1 and 15.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setPaintSelectSize <integer>size 

Sets the size of the PaintSelect brush. Will be clamped between 1 and 15.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.paintSelectIncSize() 

Increments the PaintSelect brush size by 1.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.paintSelectDecSize() 

Decrements the PaintSelect brush size by 1.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Vertex Selection

Methods:

<bitArray><Unwrap_UVW>.getSelectedVertices() 

Returns the current selected texture vertices in the edit floater as a bitarray.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.selectVertices <bitArray>selection 

Selects texture vertices in the edit floater dialog.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<boolean><Unwrap_UVW>.isVertexSelected <integer>index 

Returns a boolean value which indicates whether a texture vertex is selected.

index (integer) - The index of the vertex to check.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.GetSelectionFromFace() 

Takes the current polygon selection and uses it to select the texture vertices that are associated with it.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

Selected Edges

Methods:

<bitArray><Unwrap_UVW>.getSelectedEdges() 

Returns the edge selection from the Editor as bitarray.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.selectEdges <bitArray>selection 

Set the edge selection in the Editor using the supplied bitarray.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.isEdgeSelected <integer>index 

Returns true if the indexed edge is selected, false otherwise.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Selected Faces

Methods:

<bitArray><Unwrap_UVW>.getSelectedFaces() 

Returns the face selection from the Editor as bitarray.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.selectFaces <bitArray>selection 

Sets the face selection in the Editor using the supplied bitArray.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.isFaceSelected <integer>index 

Returns true if the specified indexed face is selected, false otherwise.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Polygon Mode

Methods:

<boolean><Unwrap_UVW>.getPolygonMode() 

Returns the state of the Polygon mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setPolygonMode <boolean>mode 

Sets the state of the Polygon mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.polygonSelect() 

Performs Polygon Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

UV Edge Mode

Methods:

<boolean><Unwrap_UVW>.getUVEdgeMode() 

Returns the UV Edge Mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setUVEdgeMode <boolean>uvEdgeMode 

Sets the UV Edge Mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.uvEdgeSelect() 

Selects UV Edge Loops. Select any number of edges and call this method to select all edges that build an edge loop with the original selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Old Selection Method

Methods:

<boolean><Unwrap_UVW>.getOldSelMethod() 

Returns false when the new selection method is used, false when the old selection method is used. In the old selection mode, drag selection always uses back faces and single pick mode ignore back faces.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setOldSelMethod <boolean>oldSelMethod 

Sets the selection method. False means use the new selection method, true means use the old selection method.

This method lets you set the system back to the old selection method where drag selection always uses back faces and single pick mode ignore back faces. This will override the Ignore Back Faces mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Transform Selected

Methods:

<void><Unwrap_UVW>.moveSelected <point3>offset 

Moves the selected sub-objects at the specified offset.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.rotateSelectedCenter <float>angle 

Rotates the selected sub-objects at the specified angle using the selection center.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.rotateSelected <float>angle <point3>axis 

Moves the selected sub-objects at the specified offset about the specified axis.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.scaleSelectedCenter <float>scale <integer>dir 

Scales the selected sub-objects by the specified amount using the selection center.

The dir integer defines the direction of scaling as follows:

0 - scale both X and Y

1 - scale X only

2 - scale Y only

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.ScaleSelected <float>scale <integer>dir <point3>axis 

Scales the selected sub-objects by the specified amount using the specified axis.

The dir integer defines the scaling mode as follows:

0 - scale both X and Y

1 - scale X only

2 - scale Y only

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Scale Selected XY

Methods:

<void><Unwrap_UVW>.scaleSelectedXY <float>scaleX <float>scaleY <point3>axis 

Scales the current selection non-uniformly using the separate X and Y scale values. Uses the axis Point3 value as center.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Transform Selected Vertices

Methods:

<void><Unwrap_UVW>.moveSelectedVertices <point3>offset 

Moves the selected texture vertices by the specified offset.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.rotateSelectedVerticesCenter <float>angle 

Rotates the selected vertices around their center point.

angle (float) - The angle in radians that you want to rotate the selection by.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.RotateSelectedVertices <float>angle <point3>axis 

Rotates the selected vertices around a specific axis

where

angle is the angle in radians that you want to rotate the selection by.

axis is the axis that you want to rotate the selected vertices about. This is in the space of the window.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.scaleSelectedVerticesCenter <float>scale <integer>dir 

Scales the selected points around their center,

where

scale is the amount that you want to scale by.

dir is the direction you want to scale in:

0 - Scales uniform

1 - Scales in the x

2 - Scales in the y

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.scaleSelectedVertices <float>scale <integer>dir <point3>axis 

Scales the selected points around their center around the axis

where

scale is the amount that you want to scale by.

dir is the direction you want to scale in:

0 - Scales uniform

1 - Scales in the x

2 - Scales in the y

axis (point3) - The axis that you want to scale the selected vertices along. This is in the space of the window.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.moveX <float>p 

This sets the selected vertices x values in absolute coordinates.

<float>p- The absolute position along the x axis.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.moveY <float>p 

This sets the selected vertices y values in absolute coordinates.

<float> p - The absolute position along the y axis.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.moveZ <float>p 

This sets the selected vertices xzvalues in absolute coordinates.

<float>p- The absolute position along the z axis.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<point3><Unwrap_UVW>.getVertexPosition <time>time <integer>index 

Returns the position of the vertex as a Point3 value.

time (timevalue) - The time at which you wan to check.

index (integer) - The index of the vertex.

Exposed via unwrap interface in 3ds Max 4 and higher.

<void><Unwrap_UVW>.SetVertexPosition <time>time <integer>index <point3>pos 

This sets the position of a UVW vertex at a specific time.

<time> time - The time at what you want to set the pos.

<integer> index - The index of the vertex.

<point3> pos - The position of the vertex in UVW space.

Exposed via unwrap interface in 3ds Max 4 and higher.

<void><Unwrap_UVW>.setVertexPosition2 <time>time <integer>index <point3>pos <boolean>hold <boolean>update 

An extended version of the .setVertexPosition() method with additional arguments controlling Undo Buffer Holding and Updating.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.getRotationsRespectAspect() 

Returns true if the rotations respect the aspect, false otherwise.

Exposed via unwrap4 interface in 3ds Max 7 and higher.

   

<void><Unwrap_UVW>.setRotationsRespectAspect <boolean>respect 

Sets whether rotations will respect the aspect or not.

Exposed via unwrap4 interface in 3ds Max 7 and higher.

Selected Polygons

Methods:

<bitArray><Unwrap_UVW>.getSelectedPolygons() 

Returns the selected polygons in the view port as a bitarray.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.selectPolygons <bitArray>selection 

Selects the polygons in the view ports.

<bitArray> sel - The polygons to select.

Exposed via unwrap interface in 3ds Max4 and higher.

   

<boolean><Unwrap_UVW>.isPolygonSelected <integer>index 

Returns whether a polygon is selected or not.

<integer> index - Index of the polygon to check.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<void><Unwrap_UVW>.selectPolygonsUpdate <bitArray>selection <boolean>update 

Selects the faces supplied by the bitArray. When update is given as true, updates the selection display. This selection method gives you an option to not update the view if you are doing lots of face processing.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.selectFacesByNormal <point3>normal <float>threshold <boolean>update 

Selects the faces whose face normals are within the given threshold relatively to the supplied normal. When update is given as true, updates the selection display.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.selectClusterByNormal <float>threshold <integer>faceIndexSeed <boolean>relative <boolean>update 

Select a cluster based on the supplied threshold value starting with the faceIndexSeed face.

When relative is supplied as true, the threshold will be measured relatively to the neighbor face (and thus be able to propagate across the whole mesh if needed). When false, the threshold will be measured absolutely to the seed face.

When true is supplied for update, the selection will be updated in the viewports.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.getArea <bitArray>faceSelection <&float>x <&float>y <&float>width <&float>height <&float>areaUVW <&float>areaGeom 

x is Out parameter 
y is Out parameter 
width is Out parameter 
height is Out parameter 
areaUVW is Out parameter 
areaGeom is Out parameter 

Returns the geometry and uvw area, x, y, width and height of the supplied face selection.

Exposed via unwrap4 interface in 3ds Max 7 and higher.

   

Synchronize Selection

Methods:

<boolean><Unwrap_UVW>.getSyncSelectionMode() 

Returns the Sync. to Viewport mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setSyncSelectionMode <boolean>sync 

Sets the Sync. to Viewport mode.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.syncTVSelection() 

Synchronizes the selection in the Editor to reflect the viewport selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<void><Unwrap_UVW>.syncGeomSelection() 

Synchronizes the face selection in the viewport to reflect the Editor’s selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Pivot

Methods:

<void><Unwrap_UVW>.snapPivot <integer>pos 

This lets you quickly snap the free form gizmo pivot to the bounding rectangle.

1 is the center

2 is the lower left of the selection

3 is the lower center of the selection

4 is the lower right of the selection

5 is the right center of the selection

6 is the upper right of the selection

7 is the upper center of the selection

8 is the upper left of the selection

9 is the left center of the selection

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<point3><Unwrap_UVW>.getPivotOffset() 

Returns the pivot offset of the free form gizmo. This is an offset from the center of the selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setPivotOffset <point3>offset 

Sets the free from gizmo’s Pivot offset.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<point3><Unwrap_UVW>.getSelCenter() 

Returns the Selection Center so you can compute the pivot offset from a world uv position.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.getResetPivotOnSelection() 

Returns the Reset Pivot on selection state. When true, the pivot will reset itself to the center of the selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setResetPivotOnSelection <boolean>reset 

Sets the Reset Pivot on selection option. When true, the pivot will reset itself to the center of the selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Selection Inside Gizmo

Methods:

<boolean><Unwrap_UVW>.getAllowSelectionInsideGizmo() 

Returns the state of the Allow Selecting Inside Gizmo option.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setAllowSelectionInsideGizmo <boolean>select 

Allow / Disallow selecting inside the gizmo.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

Soft-Selection

Methods:

<boolean><Unwrap_UVW>.getEnableSoftSelection() 

Returns the state of the Soft Selection On checkbox.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setEnableSoftSelection <boolean>enable 

Sets the state of the Soft Selection On checkbox.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<boolean><Unwrap_UVW>.getLimitSoftSel() 

Returns the state of the Edge Distance checkbox in the Soft Selection group.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setLimitSoftSel <boolean>limit 

When true is supplied as limit, the Edge Distance will be used.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<integer><Unwrap_UVW>.getLimitSoftSelRange() 

Returns the Edge Distance value set in the Soft Selection group.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

<void><Unwrap_UVW>.setLimitSoftSelRange<integer>range 

Sets the Edge Distance value used to limit the Soft Selection.

Exposed via unwrap2 interface in 3ds Max 5 and higher.

   

<integer><Unwrap_UVW>.getFalloffType() 

Returns the falloff type in the edit floater:

1 - Smooth falloff

2 - Linear falloff

3 - Slow Out falloff

4 - Fast Out falloff

Exposed via unwrap interface in 3ds Max 4 and higher.

<void><Unwrap_UVW>.setFalloffType<integer>falloff 

Sets the falloff type in the edit floater, where falloff defines the falloff type:

1 - Smooth falloff

2 - Linear falloff

3 - Slow Out falloff

4 - Fast Out falloff

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<integer><Unwrap_UVW>.getFalloffSpace() 

Returns the Falloff space.

Possible values are:

1 -XY (Local space of the object vertices.)

2 -UV (UVW space of the map vertices.)

Exposed via unwrap interface in 3ds Max 4 and higher.

<void><Unwrap_UVW>.setFalloffSpace<integer>space 

Sets the Falloff Space.

Possible values are:

1 -XY (Local space of the object vertices.)

2 -UV (UVW space of the map vertices.)

Exposed via unwrap interface in 3ds Max 4 and higher.

   

<float><Unwrap_UVW>.getFalloffDist() 

Returns the Falloff distance value.

Exposed via unwrap interface in 3ds Max 4 and higher.

<void><Unwrap_UVW>.setFalloffDist <integer>distance 

Sets the Falloff distance value.

Exposed via unwrap interface in 3ds Max 4 and higher.

   

UV Loop And Ring

Methods:

 <void><Unwrap_UVW>.uvLoop <integer>mode

Performs a UV Loop operation based on the integer argument.

Possible argument values are:

-1 - Shrink the UV Loop

0 - Select the UV Loop

1 - Grow the UV Loop

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

   

 <void><Unwrap_UVW>.uvRing <integer>mode

Performs a UV Ring operation based on the integer argument.

Possible argument values are:

-1 - Shrink the UV Ring

0 - Select the UV Ring

1 - Grow the UV Ring

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

   

UV Align And Space

Methods:

 <void><Unwrap_UVW>.align <boolean>horizontal

Performs an Align operation according to the boolean argument.

Possible argument values are:

true - Align U

false - Align V

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

   

 <void><Unwrap_UVW>.space <boolean>horizontal

Performs an Space operation according to the boolean argument.

Possible argument values are:

true - Space in U

false - Space in V

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