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

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

Previous topic

pymel.core.modeling.planarSrf

Next topic

pymel.core.modeling.pointCurveConstraint

Core

Core Modules

Other Modules

This Page