Go to: Synopsis. Return value. Flags. Python examples.
spaceLocator([absolute=boolean], [name=string], [position=[linear, linear, linear]], [relative=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
spaceLocator is undoable, queryable, and editable.
The command creates a locator at the specified position
in space. By default it is created at (0,0,0).
| string[] | The name for the new locator in space. |
In query mode, return type is based on queried flag.
absolute, name, position, relative
| Long name (short name) |
Argument types |
Properties |
|
absolute(a)
|
boolean
|
 
|
|
If set, the locator's position is in world space.
|
|
name(n)
|
string
|
|
|
|
position(p)
|
[linear, linear, linear]
|
|
|
Location in 3-dimensional space where locator is to be created.
|
|
relative(r)
|
boolean
|
|
|
If set, the locator's position is relative to its local space. The locator is created in relative mode by default.
|
|
|
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.
|
import maya.cmds as cmds
# Creates a space locator at (1, 1, 1).
cmds.spaceLocator( p=(1, 1, 1) )
# Creates a space locator at (1, 1, 1) in inches.
cmds.spaceLocator( p=('1in', '1in', '1in') )
# Creates a space locator at the default position (0, 0, 0).
cmds.spaceLocator()