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.
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. Flag can have multiple arguments, passed either as a tuple or a list.

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