Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

plane [-length linear] [-name string] [-position linear linear linear] [-rotation angle angle angle] [-size linear] [-width linear]

plane is undoable, NOT queryable, and NOT editable.

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.

Return value

string(name of the new plane)

Flags

length, name, position, rotation, size, width
Long name (short name) Argument types Properties
-position(-p) linear linear linear create
3D position where the centre of the plane is positioned. "linear" means that this flag can handle values with units.
-size(-s) linear create
The combined size (size x size) of plane. "linear" means that this flag can handle values with units.
-width(-w) linear create
The width of plane. "linear" means that this flag can handle values with units.
-length(-l) linear create
The length of plane. "linear" means that this flag can handle values with units.
-rotation(-r) angle angle angle create
The rotation of plane. "angle" means that this flag can handle values with units.
-name(-n) string create
Name the resulting object

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// Creates a plane of size (10x10) with center at (1,1,1)
plane -p 1 1 1 -s 10;

// Creates a plane of size (10x10) with center at (1,1,1) using various units
plane -p 1ft 1ft 1ft -s 10in -r 30deg 30deg 45deg;