Go to: Synopsis. Return value. Related. Flags. Python examples.
nurbsPlane([axis=[float, float, float]], [caching=boolean], [constructionHistory=boolean], [degree=int], [lengthRatio=float], [name=string], [nodeState=int], [object=boolean], [patchesU=int], [patchesV=int], [pivot=[float, float, float]], [polygon=int], [width=linear])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
nurbsPlane is undoable, queryable, and editable.
The nurbsPlane command creates a new NURBS Plane and return the name
of the new surface. It creates an unit plane with center at origin by
default.
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
cone, cylinder, nurbsPlane, sphere, torus
axis, caching, constructionHistory, degree, lengthRatio, name, nodeState, object, patchesU, patchesV, pivot, polygon, width
| Long name (short name) |
Argument types |
Properties |
width(w)
|
linear
|
  
|
|
The width of the plane
Default: 1.0
|
|
lengthRatio(lr)
|
float
|
|
|
The ratio of "length" to "width" of the plane.
Default: 1.0
|
|
patchesU(u)
|
int
|
|
|
The number of spans in the U direction.
Default: 1
|
|
patchesV(v)
|
int
|
|
|
The number of spans in the V direction.
Default: 1
|
|
degree(d)
|
int
|
|
|
The degree of the resulting surface
1 - linear,
2 - quadratic,
3 - cubic,
5 - quintic,
7 - heptic
Default: 3
|
|
pivot(p)
|
[float, float, float]
|
|
|
The primitive's pivot point
|
|
axis(ax)
|
[float, float, float]
|
|
|
|
| Advanced flags |
caching(cch)
|
boolean
|
|
|
Modifies the node caching mode. See the node documentation for more information.
Note: For advanced users only.
|
|
nodeState(nds)
|
int
|
|
|
Modifies the node state. See the node documentation for more information.
Note: For advanced users only.
|
|
| Common flags |
name(n)
|
string
|
|
|
Name the resulting object
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node
|
|
polygon(po)
|
int
|
|
|
The value of this argument controls the type of the object
created by this operation
- 0: nurbs surface
- 1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)
- 2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)
- 3: Bezier surface
- 4: subdivision surface solid (use nurbsToSubdivPref to set the
parameters for the conversion)
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
import maya.cmds as cmds
# Create default plane
cmds.nurbsPlane()
# Create a degree 3 plane with 4 spans in each direction
cmds.nurbsPlane( d=3, u=4, v=4 )
# Create plane that is twice as long as it is wide
cmds.nurbsPlane( w=3, lr=2 )