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

Synopsis

lassoContext( string , [exists=boolean], [history=boolean], [image1=string], [image2=string], [image3=string], [name=string])

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

lassoContext is undoable, queryable, and editable.

Creates a context to perform selection via a "lasso". Use for irregular selection regions, where the "marquee-style" select of the "selectContext" is inappropriate.

Return value

stringName of the context created

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

Flags

exists, history, image1, image2, image3, name
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.

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 new lasso context, then switch to it
cmds.lassoContext('lassoContext1')
cmds.setToolTo('lassoContext1')