Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

texLatticeDeformContext( contextName , [envelope=float], [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [latticeColumns=uint], [latticeRows=uint], [name=string], [snapPixelMode=boolean], [useBoundingRect=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

texLatticeDeformContext is undoable, queryable, and editable.

This command creates a context which may be used to deform UV maps with lattice manipulator. This context only works in the texture UV editor.

Return value

string

In query mode, return type is based on queried flag.

Flags

envelope, exists, history, image1, image2, image3, latticeColumns, latticeRows, name, snapPixelMode, useBoundingRect
Long name (short name) Argument types Properties
exists(ex) boolean create
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
image1(i1) string createqueryedit
image2(i2) string createqueryedit
image3(i3) string createqueryedit
Contexts support up to three icons that represent the tool associated with the context.
history(ch) boolean create
If this is a tool command, turn the construction history on for the tool in question.
name(n) string create
If this is a tool command, name the tool appropriately.
latticeColumns(lc) uint createqueryedit
Specifies the number column points the lattice contains. The maximum size lattice is restricted to 8 columns.
latticeRows(lr) uint createqueryedit
Specifies the number of rows the lattice contains. The maximum size lattice is restricted to 8 rows.
envelope(ev) float createqueryedit
Specifies the influence of the lattice.
snapPixelMode(spm) boolean createqueryedit
Specifies the influenced uv points should be snapped to a pixel center or corner.
useBoundingRect(ubr) boolean createqueryedit
When constructing the lattice use the bounding box of the selected UVs for the extents of the lattice. When this is disabled the extents of the marquee selections are used as the extents for the lattice.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# Create a lattice manipulator with 4 x 4 lattice.
#
cmds.texLatticeDeformContext( 'latticeContext', latticeColumns=4, latticeRows=4 )