alignCtx

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

Synopsis

alignCtx [-align] [-anchorFirstObject boolean] [-distribute] [-exists] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-name string] [-showAlignTouch boolean] [contextName]

alignCtx is undoable, queryable, and editable.

Return value

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

Flags

Long name (short name)	Argument types	Properties
-align(-a)
Align objects
-anchorFirstObject(-afo)	boolean
Anchor first or last selected object. Default false. Only applicable when aligning objects.
-distribute(-d)
Distribute objects
-exists(-ex)
Returns true or false depending upon whether the specified object exists. Other flags are ignored.
-history(-ch)	boolean
If this is a tool command, turn the construction history on for the tool in question.
-image1(-i1)	string
First of three possible icons representing the tool associated with the context.
-image2(-i2)	string
Second of three possible icons representing the tool associated with the context.
-image3(-i3)	string
Third of three possible icons representing the tool associated with the context.
-name(-n)	string
If this is a tool command, name the tool appropriately.
-showAlignTouch(-sat)	boolean
Show or hide align touching handles. Default true. Only applicable when aligning objects.

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 a poly sphere and a poly cube, then move them apart
polySphere -r 3 -n pSphere1;
move 5 0 0;
polyCube -w 3 -h 3 -d 3 -n pCube1;
move -5 3 0;
select -r pSphere1 pCube1;

// Create a new align context which is used to align objects, then switch to it
// Now you can use this tool to align objects
alignCtx -a alignCtx1;
setToolTo alignCtx1;