Add a flag to an attribute
Format:
addAttrFlags path flag
Flags: 0 no flags 8 invisible (can't see it) 64 expanded (disclosure triangle) 4096 locked object (lock button toggled) 8192 invisible object (visibility button toggled)
Use caution when manipulating attribute flags for attributes you did not create.
Append an element to an attribute array
Format: appendAttr path value
-r [ use if path is root-relative]
Only use this command on arrays that you have personally created.
See if an attribute exists
Format: set result [attrExists path] -r [use if path is root-relative]
Returns 0 if non-existant, and 1 if found
Add a Limits Constraint to an object
Format: constraints_addLimits objectPath
Add a Look At Constraint to an object
Format: constraints_addLookAt interestPath objectPath
Add an Object Snap Constraint to an object
Format: constraints_addLookAt targetObject objectPath
Add an Orbit Constraint to an object
Format: constraints_addOrbit objectPath
constraints_addOrbit
Add an Orbit Constraint to an object
Format: constraints_addOrbit objectPath
Add a Path Constraint to an object
Format: constraints_addLookAt pathObject objectPath
Duplicate an attribute
-n [name (path)] -r [use if path is root-relative]
Dispose of an attribute, and all of its children
Format: freeAttr path
-r [ use if path is root-relative]
This command cannot be undone. Use it wisely.
Get an attribute
Format: getAttr path
-r [use if path is root-relative]
Get the UniqueID (not sceneID) of an object
Format: getAttrID path -r [use if path is root-relative]
The uniqueID of an object is used for selection, and is unrelated to the object s scene ID.
Returns a list of dependant scene IDs for an object
format: set myList [getDependencies -n objectPath]
Hide or show attributes based on the current selection
-sel [ hides selected objects] -unsel [ hides unselected objects] -none [ hides none (reveals all) ] -cons [ hides construction objects ] -showCons [ shows construction objects ]
Set an attribute
Format: insertAttr path value
-r [ use if path is root-relative] -i [ target index for insertion ]
Only use this command on attribute groups that you have personally created.
Instance an object
-n [name (path) of the object]
Create a new lattice
-xsub [x subdivisions] -ysub [y subdivisions] -zsub [z subdivisions] -w [ width ] -h [ height ] -l [ length ]
There is no name flag as of yet.
Add a Lattice Modifier to an object
-n [ path to an editable NURBS object ] -l [ path to the Lattice ]
lattice_build
build a lattice
-n [path to the lattice]
This command presses the Build button on a Lattice object.
Create a new metaball object
Format: metaball_newMeta type -n name -s system
-n [Emitter name] -s [path to an existing blobby system] Types: system, blob
-s is only required when the type is blob
Check to see if the option key is being held down
no flags
returns 0 or 1
Move an attribute from one group to another
-f [ from - attribute to move ] -t [ to - attribute Group to move it to] -r [ use if path is root-relative]
Use Caution.
newAttr
Creates a new attribute
-n [name] -t [type] -g [group] -r [use if group is root-relative]
Types: boolean, integer, float, slider, color, point2, param2, point3, param3, point4, string, popupmenu, separator, button
Create a button Attribute
-n [name of the button] -t [button title] -c [tcl callback function] -g [ attribute group to place button] -r [ use if group is root-relative ]
For callbacks, declare the proc as follows: proc myButtonProc {nFlag Path} {}
nrb_addModifier type -n object
types: flip disrupt twist taper wave shear quantize spline
Check the respective menu scripts for the actual usage of each modifier type
Auto-Center Tool
-n [name (path) of the object]
Create an editable, bicubic cone
-n [name of cone] -sr [start radius] -er [end radius] -l [length] -us [u steps] -vs [v steps] -ssw, startSweep [start sweep angle] -esw, endSweep [end sweep angle]
Create an editable, bicubic cylinder
-n [name of cylinder] -r [radius] -l [length] -us [u steps] -vs [v steps] -ssw, startSweep [start sweep angle] -esw, endSweep [end sweep angle]
Create an editable, bicubic sphere
-n [name of sphere] -r [radius] -us [u steps] -vs [v steps] -ssw, startSweep [start sweep angle] -esw, endSweep [end sweep angle]
Create an editable, bicubic torus
-n [name of cone] -innerRadius [inner radius] -outerRadius [outer radius] -us [u steps] -vs [v steps] -ssw, startSweep [start sweep angle] -esw, endSweep [end sweep angle]
Construct an editable NURBS mesh from scratch
-parent (optional) Full path to an object under which to create this one -n, -name -us, -uSteps -vs, -vSteps -uo, -uOrder -vo, -vOrder -uc, -uClosed ( 0 or 1 ) -vc, -vClosed ( 0 or 1 )
Then:
-cv for CVs in homogenous coordinates (xyzw)
Example: nrb_buildMesh -n MyMesh -us 2 -vs 2 -cv 0.0 0.0 0.0 1.0 -cv 50.0 50.0 0.0 1.0 -cv 0.0
50.0 0.0 1.0 -cv 0.0 0.0 50.0 1.0
Construct an editable NURBS spline from scratch
-parent (optional) Full path to an object under which to create this one -n, -name -us, -uSteps -uo, -uOrder -uc, -uClosed ( 0 or 1 )
Then: -cv for CVs in homogenous coordinates (xyzw) example: -cv 0.0 0.0 0.0 1.0 -cv 1.0 0.0 0.0 1.0 (etc..)
Close the V Ends of an editable NURBS Surface
-n [name] -r [rounding factor (0.0 to 1.0)]
Convert a NURBS surface to a Polygonal Object
-n [ name (path) of the object ] -m [ conversion mode ( 0 normal: 1 replace original)
Replicate the shape of another NURBS object
-n [object to copy to] -c [object to copy from]
Create a parametric arc primitive
-n [ name ] -r [ radius ] -ssw [start sweep angle] -esw [end sweep angle ]
Create a parametric circle primitive
-n [name] -r [radius]
Create a parametric gear primitive
-n [name] -nt [number of teeth] -ir [inner radius]
-mr [middle radius] -or [outer radius] -bev [bevel percentage]
Create a parametric helix primitive
-n [name] -br [base radius] -tr [top radius] -h [height] -rv [revolutions] -pts [number of points]
Create a parametric ngon primitive
-n [name] -r [radius] -s [sides]
Create a parametric square primitive
-n [name] -w [width] -h [height]
Create a parametric star primitive
-n [name] -ir [inner radius] -or [outer radius] -pts [number of points]
Make every uv span of a surface into an editable NURBS spline
-n [name of object to extract curves]
Evaluate du at a parameter
Format: nrb_evalDerivative {splinePath} param -w
-w [ evaluate in world space ]
Warning: computationally expensive when used from within a tcl script
Evaluate a NURBS spline at a parameter
Format: nrb_evalSpline {splinePath} param -w
-w [ evaluate in world space ]
Warning: computationally expensive when used from within a tcl script
Evaluate a NURBS surface at a parameter
Format: nrb_evalSurface {surfacePath} uParam vParam -w
-w [ evaluate in world space ]
Warning: computationally expensive when used from within a tcl script
Saves a Tag Map for the currently selected NURBS object.
-n [name (path) of the object] -w [Width of the Image] -h [Height of the Image] -f [filename (appears in save dialog)]
Extract curves from selected points in u, v, or both directions
-n [name (path to source object)] -u [ if provided: u splines are created ] -v [ if provided: v splines are created ]
You can use -u, -v, or -u -v to extract.
Create an extrusion object, and assign it to a curve
-n [name of the extrusion] -c [path to the curve to extrude]
Flip, and optionally stitch a NURBS surface
-n [name]
-g [ flip global]
-x [ flip x ]
-y [ flip y ]
-z [ flip z ]
-s [ stitch ]
-u [ stitch u to u ]
-v [ stitch v to v ]
stitch, global, and undesired axis flags need not be included
insert a u or v step to an editable surface or spline
-n [name (path) to target object] -iu [insert u at - default: 0.5] -iv [insert v at - default: 0.5]
-iv cannot be used on curves
Flip the direction of u or v steps, and invert the surface normals
-n [name (path) of target object] -u [ if used: u steps will be inverted ] -v [ if used: v steps will be inverted ]
nrb_join
Appends object 2 to object 1
-obj1 [object] -obj2 [object to append to -obj1] -u [ join in u direction ] -v [ join in v direction ]
You can only join in one direction.
Create a lathe object, and assign its curve
-n [name of lathe] -c [path to curve] -ssw, startSweep [start sweep angle] -esw, endSweep [end sweep angle]
Create a loft object, and enter loft selection mode
-n [name of loft]
Convert a Solid Primitive into an editable NURBS object
-o [object (path) to convert] -r [replace original - 0 = no: 1 = yes]
nrb_mesh
Create a nurbs plane
-n [name] -us [u steps] -vs [v steps] -w [width] -l [length]
Create a Null with 6 NURBS Meshes linked to it
-n [name] -us [u steps] -vs [v steps] -w [width] -l [length] -h [height]
Shift the NURBS origin by n steps in a direction
Format: nrb_origin -n objectPath uDelta vDelta
Remove a u or v step from an editable surface or spline
choices:
-ru [remove U step script.html#: (specify)] -rv [remove V step script.html#: (specify)]
Or -----------------------------
-rsu [remove last selected u step] -rsv [remove last selected v step]
-rv and -rsv cannot be used on curves
Change the number of steps, while preserving the shape of an editable NURBS object
-n [name] -us [desired u steps] -vs [desired v steps]
Move the location of the last picked cv or selected u/v columns and update the Freeform tool
Format: nrb_selectnextPoint uDelta vDelta -n objectName
Set an editable NURBS object s degree
-n [name] -u [u degree] -v [v degree]
nrb_setKnots
Set the Knot type for an editable NURBS object
-n [name] -u [u knot type - quasi or uniform] -v [v knot type - quasi or uniform]
Simplify an Editable NURBS Surface
-n [object to simplify] -u [simplify u direction] -u [simplify v direction]
Create a parametric solid capsule primitive
-n [name] -r [radius] -l [length] -ussw [start sweep angle] -uesw [end sweep angle]
Create a parametric solid cone primitive
-n [name] -sr [start radius] -er [end radius] -ssw [ start sweep angle ] -esw [ end sweep angle ]
Create a parametric solid cube primitive
-n [name] -us [u steps] -vs [v steps] -w [width] -h [height] -l [length]
Create a parametric solid cylinder primitive
-n [name] -r [ radius] -l [length] -ssw [ start sweep angle ] -esw [ end sweep angle ]
Create a parametric solid sphere primitive
-n [name] -r [radius] -ussw [ u start sweep angle ] -uesw [ u end sweep angle ] -vssw [ v start sweep angle ] -vesw [ v end sweep angle ]
Create a parametric solid torus primitive
-n [name] -r1 [minor radius] -r2 [major radius] -ussw [ u start sweep angle ] -uesw [ u end sweep angle ] -vssw [ v start sweep angle ] -vesw [ v end sweep angle ]
Create a parametric solid tube primitive
-n [name] -l [length] -ir [inner radius] -or [outer radius] -ussw [start sweep angle] -uesw [end sweep angle]
Subdivide a NURBS Object
-n [name] -u [u subdivisions] -v [v subdivisions]
nrb_sweep_nurb
Create a sweep object, and assign its curves
-n, -name [name of sweep object] -pc, -profileCurve [profile curve path] -ps, -pathSpline [path object path]
Swap an editable NURBS object s u and v directions
-n [name]
Enter Wrap Tool Selection Mode
-m [mode - 0 = Wrap: 1 = Wrap and Project]
Wrap and Project mode can only be used on splines to create parametric curves.
Returns a list of valid scene IDs for the objects in the scene
format: set myList [objectList]
Create a Null Object
-n [name of the Null] -t [type of Null - ( 1 = Axis: 2 = Cross, 3 = Box, 4 = Border )] -p [ parent - where to create the null ]
Add a new force to a Particle System
Format: particles_addForce type -n name -s system
-n [Name of the Force] -s [Particle System Path]
Force Types: wind, friction, vortex, turbulence, death, life, gravity, colli- sion, accelerator
-s path can be to any particle object - systems, forces, or emitters. The function will automatically change it to the particle system that owns that object.
Create a new emitter for a Particle System
-n [Emitter name] -s [Particle System path]
-s path can be to any particle object - systems, forces, or emitters. The function will automatically change it to the particle system that owns that object.
particles_newSystem
Create a new Particle System within the objects group
no flags
pathFromID
Get a full attribute path from an object s scene ID
Format: set myPath [pathFromID sceneID]
This command should be used in conjunction with objectList.
Generate a prompt message
Format: prompt_newprompt message
Message is limited to 1024 characters. newlines are not allowed.
Generate an alert dialog
Format: prompt_useralert message
Message is limited to 1024 characters.
Undoes undo
Format: redo
removeAttrFlags
Remove a flag from an attribute
Format:
removeAttrFlags path flag
Flags: 0 no flags 8 invisible (can't see it) 64 expanded (disclosure triangle) 4096 locked object (lock button toggled) 8192 invisible object (visibility button toggled)
Use caution when manipulating attribute flags for attributes you did not create.
Select next or previous objects
-next [ select next object ] -previous [ select previous object ]
Set an attribute
Format: setAttr path value
-r [ use if path is root-relative] -i [ array index ]
Create a Step And Repeat object
-n [name] -o [object to step and repeat]
Undoes something
Format: undo
Moves objects up in the hierarchy
-n [object to unlink] -r [move objects back to "Objects" group: otherwise, they move up one level in the hierarchy]