addAttrFlags

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.

appendAttr

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.

attrExists

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

constraints_addLimits

Add a Limits Constraint to an object

Format: constraints_addLimits objectPath

constraints_addLookAt

Add a Look At Constraint to an object

Format: constraints_addLookAt interestPath objectPath

constraints_addObjectSnap

Add an Object Snap Constraint to an object

Format: constraints_addLookAt targetObject objectPath

constraints_addOrbit

Add an Orbit Constraint to an object

Format: constraints_addOrbit objectPath

constraints_addOrbit

Add an Orbit Constraint to an object

Format: constraints_addOrbit objectPath

constraints_addPath

Add a Path Constraint to an object

Format: constraints_addLookAt pathObject objectPath

dupeAttr

Duplicate an attribute

-n [name (path)] -r [use if path is root-relative]

freeAttr

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.

getAttr

Get an attribute

Format: getAttr path

-r [use if path is root-relative]

getAttrID

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.

getDependencies

Returns a list of dependant scene IDs for an object

format: set myList [getDependencies -n objectPath]

hide

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 ]

insertAttr

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

Instance an object

-n [name (path) of the object]

lattice_add

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.

lattice_addModifier

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.

metaball_newMeta

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

modifier_option

Check to see if the option key is being held down

no flags

returns 0 or 1

moveAttr

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

newButtonAttr

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
Format:

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

nrb_autocenter

Auto-Center Tool

-n [name (path) of the object]

nrb_bicubicCone

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]

nrb_bicubicCylinder

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]

nrb_bicubicSphere

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]

nrb_bicubicTorus

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]

nrb_buildMesh

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

nrb_buildSpline

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..)

nrb_closeEnds

Close the V Ends of an editable NURBS Surface

-n [name] -r [rounding factor (0.0 to 1.0)]

nrb_convertToPoly

Convert a NURBS surface to a Polygonal Object

-n [ name (path) of the object ] -m [ conversion mode ( 0 normal: 1 replace original)

nrb_copyshape

Replicate the shape of another NURBS object

-n [object to copy to] -c [object to copy from]

nrb_curve_arc

Create a parametric arc primitive

-n [ name ] -r [ radius ] -ssw [start sweep angle] -esw [end sweep angle ]

nrb_curve_circle

Create a parametric circle primitive

-n [name] -r [radius]

nrb_curve_gear

Create a parametric gear primitive

-n [name] -nt [number of teeth] -ir [inner radius]

-mr [middle radius] -or [outer radius] -bev [bevel percentage]

nrb_curve_helix

Create a parametric helix primitive

-n [name] -br [base radius] -tr [top radius] -h [height] -rv [revolutions] -pts [number of points]

nrb_curve_ngon

Create a parametric ngon primitive

-n [name] -r [radius] -s [sides]

nrb_curve_square

Create a parametric square primitive

-n [name] -w [width] -h [height]

nrb_curve_star

Create a parametric star primitive

-n [name] -ir [inner radius] -or [outer radius] -pts [number of points]

nrb_dupSurfCurves

Make every uv span of a surface into an editable NURBS spline

-n [name of object to extract curves]

nrb_evalDerivative

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

nrb_evalSpline

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

nrb_evalSurface

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

nrb_exportTagMap

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)]

nrb_extract

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.

nrb_extrude_nurb

Create an extrusion object, and assign it to a curve

-n [name of the extrusion] -c [path to the curve to extrude]

nrb_ipStitch

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

nrb_insert

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

nrb_invert

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.

nrb_lathe_nurb

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]

nrb_loft_nurb

Create a loft object, and enter loft selection mode

-n [name of loft]

nrb_makeEditable

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]

nrb_nurbscube

Create a Null with 6 NURBS Meshes linked to it

-n [name] -us [u steps] -vs [v steps] -w [width] -l [length] -h [height]

nrb_origin

Shift the NURBS origin by n steps in a direction

Format: nrb_origin -n objectPath uDelta vDelta

nrb_remove

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

nrb_reorder

Change the number of steps, while preserving the shape of an editable NURBS object

-n [name] -us [desired u steps] -vs [desired v steps]

nrb_selectNextPoint

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

nrb_setDegree

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]

nrb_simplify

Simplify an Editable NURBS Surface

-n [object to simplify] -u [simplify u direction] -u [simplify v direction]

nrb_solidcapsule

Create a parametric solid capsule primitive

-n [name] -r [radius] -l [length] -ussw [start sweep angle] -uesw [end sweep angle]

nrb_solidcone

Create a parametric solid cone primitive

-n [name] -sr [start radius] -er [end radius] -ssw [ start sweep angle ] -esw [ end sweep angle ]

nrb_solidcube

Create a parametric solid cube primitive

-n [name] -us [u steps] -vs [v steps] -w [width] -h [height] -l [length]

nrb_solidcylinder

Create a parametric solid cylinder primitive

-n [name] -r [ radius] -l [length] -ssw [ start sweep angle ] -esw [ end sweep angle ]

nrb_solidsphere

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 ]

nrb_solidtorus

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 ]

nrb_solidtube

Create a parametric solid tube primitive

-n [name] -l [length] -ir [inner radius] -or [outer radius] -ussw [start sweep angle] -uesw [end sweep angle]

nrb_subdivide

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]

nrb_transpose

Swap an editable NURBS object s u and v directions

-n [name]

nrb_wrap

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.

objectList

Returns a list of valid scene IDs for the objects in the scene

format: set myList [objectList]

opus_uberNull

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 ]

particles_addForce

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.

particles_newEmitter

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.

prompt_newprompt

Generate a prompt message

Format: prompt_newprompt message

Message is limited to 1024 characters. newlines are not allowed.

prompt_useralert

Generate an alert dialog

Format: prompt_useralert message

Message is limited to 1024 characters.

redo

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

Select next or previous objects

-next [ select next object ] -previous [ select previous object ]

setAttr

Set an attribute

Format: setAttr path value

-r [ use if path is root-relative] -i [ array index ]

stepAndRepeat

Create a Step And Repeat object

-n [name] -o [object to step and repeat]

undo

Undoes something

Format: undo

unlink

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]

Digital One Color San Diego