pymel.core.modeling.nurbsSquare

nurbsSquare(*args, **kwargs)

The nurbsSquare command creates a square

Flags:

Long name (short name)		Argument Types	Properties
caching (cch)		bool
	Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
center (c)		float, float, float
	The center point of the square.
centerX (cx)		float
	X of the center point. Default:0
centerY (cy)		float
	Y of the center point. Default:0
centerZ (cz)		float
	Z of the center point. Default:0
constructionHistory (ch)		bool
	Turn the construction history on or off
degree (d)		int
	The degree of the resulting circle: 1 - linear, 2 - quadratic, 3 - cubic, 5 - quintic, 7 - heptic Default:3
name (n)		unicode
	Name the resulting object
nodeState (nds)		int
	Modifies the node state. See the node documentation for more information. Note:For advanced users only. Common flags
normal (nr)		float, float, float
	The normal of the plane in which the square will lie.
normalX (nrx)		float
	X of the normal direction. Default:0
normalY (nry)		float
	Y of the normal direction. Default:0
normalZ (nrz)		float
	Z of the normal direction. Default:1
object (o)		bool
	Create the result, or just the dependency node Flag can have multiple arguments, passed either as a tuple or a list.
sideLength1 (sl1)		float
	The length of a side on the square. Default:1.0
sideLength2 (sl2)		float
	The length of an adjacent side on the square. Default:1.0
spansPerSide (sps)		int
	The number of spans per side determines the resolution of the square. Default:1 Advanced flags

Derived from mel command maya.cmds.nurbsSquare

Example:

import pymel.core as pm

# create degree 1 square with side length 2, center (0,0,0) on the
# x-y plane
pm.nurbsSquare( nr=(0, 0, 1), d=1, c=(0, 0, 0), sl1=2, sl2=2 )
# Result: [nt.Transform(u'nurbsSquare1'), nt.MakeNurbsSquare(u'makeNurbsSquare1')] #

# create degree 2 rectangle with length 2,4 at origin on the x-y plane
pm.nurbsSquare( d=2, nr=(0, 0, 1), c=(0, 0, 0), sl1=2, sl2=4 )
# Result: [nt.Transform(u'nurbsSquare2'), nt.MakeNurbsSquare(u'makeNurbsSquare2')] #

# create square of degree 3,side lengths 3, 4 spans per side
pm.nurbsSquare( nr=(0, 0, 1), c=(0, 0, 0), d=3, sl1=3, sl2=3, sps=4 )
# Result: [nt.Transform(u'nurbsSquare3'), nt.MakeNurbsSquare(u'makeNurbsSquare3')] #