Go to: Synopsis. Return value. Flags. Python examples.
plane([length=linear], [name=string], [position=[linear, linear, linear]], [rotation=[angle, angle, angle]], [size=linear], [width=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
plane is undoable, NOT queryable, and NOT editable.
The command creates a sketch plane (also known as a "construction plane")
in space. To create an object (such as a NURBS curve, joint chain or
polygon) on a construction plane, you need to first make the plane live.
See also the makeLive command.
| string | (name of the new plane) |
length, name, position, rotation, size, width
| Long name (short name) |
Argument types |
Properties |
position(p)
|
[linear, linear, linear]
|
|
|
3D position where the centre of the plane is positioned.
"linear" means that this flag can handle values with units.
|
|
size(s)
|
linear
|
|
|
The combined size (size x size) of plane.
"linear" means that this flag can handle values with units.
|
|
width(w)
|
linear
|
|
|
The width of plane.
"linear" means that this flag can handle values with units.
|
|
length(l)
|
linear
|
|
|
The length of plane.
"linear" means that this flag can handle values with units.
|
|
rotation(r)
|
[angle, angle, angle]
|
|
|
The rotation of plane.
"angle" means that this flag can handle values with units.
|
|
name(n)
|
string
|
|
|
Name the resulting object
|
|
|
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 plane of size (10x10) with center at (1,1,1)
cmds.plane( p=(1, 1, 1), s=10 )
# Creates a plane of size (10x10) with center at (1,1,1) using various units
cmds.plane( p=('1ft', '1ft', '1ft'), s='10in', r=('30deg', '30deg', '45deg') )