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. “linear” means that this flag can handle values with units.
name (n)		unicode
	Name the resulting objectFlag can appear in Create mode of commandFlag 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. “linear” means that this flag can handle values with units.
rotation (r)		float, float, float
	The rotation of plane. “angle” means that this flag can handle values with units.
size (s)		float
	The combined size (size x size) of plane. “linear” means that this flag can handle values with units.
width (w)		float
	The width of plane. “linear” means that this flag can handle values with units.

Derived from mel command maya.cmds.plane

Example:

import pymel.core as pm

import maya.cmds as cmds

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