Go to: Synopsis. Return value. Flags. Python examples.
nurbsSquare([caching=boolean], [center=[linear, linear, linear]], [centerX=linear], [centerY=linear], [centerZ=linear], [constructionHistory=boolean], [degree=int], [name=string], [nodeState=int], [normal=[linear, linear, linear]], [normalX=linear], [normalY=linear], [normalZ=linear], [object=boolean], [sideLength1=linear], [sideLength2=linear], [spansPerSide=int])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
nurbsSquare is undoable, queryable, and editable.
The nurbsSquare command creates a square
| string[] | Object name and node name |
In query mode, return type is based on queried flag.
caching, center, centerX, centerY, centerZ, constructionHistory, degree, name, nodeState, normal, normalX, normalY, normalZ, object, sideLength1, sideLength2, spansPerSide
| Long name (short name) |
Argument types |
Properties |
normal(nr)
|
[linear, linear, linear]
|
  
|
|
The normal of the plane in which the square will lie.
|
|
normalX(nrx)
|
linear
|
|
|
X of the normal direction.
Default: 0
|
|
normalY(nry)
|
linear
|
|
|
Y of the normal direction.
Default: 0
|
|
normalZ(nrz)
|
linear
|
|
|
Z of the normal direction.
Default: 1
|
|
center(c)
|
[linear, linear, linear]
|
|
|
The center point of the square.
|
|
centerX(cx)
|
linear
|
|
|
X of the center point.
Default: 0
|
|
centerY(cy)
|
linear
|
|
|
Y of the center point.
Default: 0
|
|
centerZ(cz)
|
linear
|
|
|
Z of the center point.
Default: 0
|
|
sideLength1(sl1)
|
linear
|
|
|
The length of a side on the square.
Default: 1.0
|
|
sideLength2(sl2)
|
linear
|
|
|
The length of an adjacent side on the square.
Default: 1.0
|
|
degree(d)
|
int
|
|
|
The degree of the resulting circle:
1 - linear,
2 - quadratic,
3 - cubic,
5 - quintic,
7 - heptic
Default: 3
|
|
spansPerSide(sps)
|
int
|
|
|
The number of spans per side determines the resolution of the square.
Default: 1
|
|
| 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
|
|
|
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.
|
|
constructionHistory(ch)
|
boolean
|
|
|
Turn the construction history on or off
|
|
object(o)
|
boolean
|
|
|
Create the result, or just the dependency node
|
|
|
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 degree 1 square with side length 2, center (0,0,0) on the
# x-y plane
cmds.nurbsSquare( nr=(0, 0, 1), d=1, c=(0, 0, 0), sl1=2, sl2=2 )
# create degree 2 rectangle with length 2,4 at origin on the x-y plane
cmds.nurbsSquare( d=2, nr=(0, 0, 1), c=(0, 0, 0), sl1=2, sl2=4 )
# create square of degree 3,side lengths 3, 4 spans per side
cmds.nurbsSquare( nr=(0, 0, 1), c=(0, 0, 0), d=3, sl1=3, sl2=3, sps=4 )