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 ../../../_images/create.gif
  The length of plane. linearmeans that this flag can handle values with units.
name / n unicode ../../../_images/create.gif
  Name the resulting object.
position / p float, float, float ../../../_images/create.gif
  3D position where the centre of the plane is positioned. linearmeans that this flag can handle values with units.
rotation / r float, float, float ../../../_images/create.gif
  The rotation of plane. anglemeans that this flag can handle values with units.
size / s float ../../../_images/create.gif
  The combined size (size x size) of plane. linearmeans that this flag can handle values with units.
width / w float ../../../_images/create.gif
  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') #