pymel.core.modeling.plane

plane(*args, **kwargs)

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:

Long name (short name)		Argument Types	Properties
length (l)		float
	The length of plane. linearmeans that this flag can handle values with units.
name (n)		unicode
	Name the resulting object Flag can have multiple arguments, passed either as a tuple or a list.
position (p)		float, float, float
	3D position where the centre of the plane is positioned. linearmeans that this flag can handle values with units.
rotation (r)		float, float, float
	The rotation of plane. anglemeans that this flag can handle values with units.
size (s)		float
	The combined size (size x size) of plane. linearmeans that this flag can handle values with units.
width (w)		float
	The width of plane. linearmeans that this flag can handle values with units.

Derived from mel command maya.cmds.plane

Example:

import pymel.core as pm

# Creates a plane of size (10x10) with center at (1,1,1)
pm.plane( p=(1, 1, 1), s=10 )
# Result: nt.Transform(u'plane1') #

# Creates a plane of size (10x10) with center at (1,1,1) using various units
pm.plane( p=('1ft', '1ft', '1ft'), s='10in', r=('30deg', '30deg', '45deg') )
# Result: nt.Transform(u'plane2') #