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

Synopsis

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, queryable, and 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.

Flags

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.

Return value


string (name of the new plane)

Python examples

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