pymel.core.modeling.nurbsPlane

nurbsPlane(*args, **kwargs)

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.

Flags:
Long name (short name) Argument Types Properties
axis (ax) float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The primitive’s axisAdvanced flags
caching (cch) bool ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
constructionHistory (ch) bool ../../../_images/create.gif
 
Turn the construction history on or off
degree (d) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The degree of the resulting surface 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - hepticDefault:3
lengthRatio (lr) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The ratio of “length” to “width” of the plane.Default:1.0
name (n) unicode ../../../_images/create.gif
 

Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.

nodeState (nds) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
Modifies the node state. See the node documentation for more information.Note:For advanced users only.Common flags
object (o) bool ../../../_images/create.gif
 
Create the result, or just the dependency node
patchesU (u) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The number of spans in the U direction.Default:1
patchesV (v) int ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The number of spans in the V direction.Default:1
pivot (p) float, float, float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The primitive’s pivot point
polygon (po) int ../../../_images/create.gif
 

The value of this argument controls the type of the object created by this operation 0: nurbs surface1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)3: Bezier surface4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

width (w) float ../../../_images/create.gif ../../../_images/query.gif ../../../_images/edit.gif
 
The width of the planeDefault:1.0

Derived from mel command maya.cmds.nurbsPlane

Example:

import pymel.core as pm

# Create default plane
pm.nurbsPlane()
# Result: [nt.Transform(u'nurbsPlane1'), nt.MakeNurbPlane(u'makeNurbPlane1')] #

# Create a degree 3 plane with 4 spans in each direction
pm.nurbsPlane( d=3, u=4, v=4 )
# Result: [nt.Transform(u'nurbsPlane2'), nt.MakeNurbPlane(u'makeNurbPlane2')] #

# Create plane that is twice as long as it is wide
pm.nurbsPlane( w=3, lr=2 )
# Result: [nt.Transform(u'nurbsPlane3'), nt.MakeNurbPlane(u'makeNurbPlane3')] #

Previous topic

pymel.core.modeling.nurbsEditUV

Next topic

pymel.core.modeling.nurbsSelect

Core

Core Modules

Other Modules

This Page