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

Synopsis

snapTogetherCtx [-clearSelection boolean] [-exists] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-name string] [-setOrientation boolean] [-snapPolygonFace boolean] [contextName]

snapTogetherCtx is undoable, queryable, and editable.

The snapTogetherCtx command creates a tool for snapping surfaces together.

Return value

string(name of the new context)

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

Flags

clearSelection, exists, history, image1, image2, image3, name, setOrientation, snapPolygonFace
Long name (short name) Argument types Properties
-exists(-ex) 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.
-setOrientation(-so) boolean createqueryedit
Sets whether the tool should orient as well as moving an item. Default true.
-clearSelection(-cs) boolean createqueryedit
Sets whether the tool should clear the selection on entry to the tool. Default true.
-snapPolygonFace(-spf) boolean createqueryedit
Sets whether the tool should snap the cursor to polygon face centers. Default false.

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 be used more than once in a command.

MEL examples

// Create two nurbs spheres, then move them apart
sphere -r 3 -n nurbsSphere1;
move 5 0 0;
sphere -r 3 -n nurbsSphere2;
move -5 0 0;

// Create a new snap together tool context, set it to move objects only, then switch to it
// You can use this tool to snap two spheres together
snapTogetherCtx -so 0  snapTogetherCtx1;
setToolTo snapTogetherCtx1;