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') )