MAXScript Language Reference > 3ds Max Objects > Modifier : MAXWrapper and SpacewarpModifier : MAXWrapper > Modifier and SpacewarpModifier Types > Modifiers > UVW Modifiers > Unwrap_UVW : Modifier >

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