Working with Return Values

Each command returns JScript objects representing the components of the rig, which you can use in any other language Softimage supports (Python, Perl, VBScript, VB and C++). You can use these return objects for a variety of purposes--to hide objects, add them to an envelope group, etc.

Example: Working with MakeTorso

If you look at the return of the MakeTorso command, it returns a Torso object that contains 16 data members, including the hip control icon object called Torso.Hip.

If you called the following in your script:

var myTorso = makeTorso( arguments );

You could find the hip by calling:

Application.LogMessage( myTorso.Hip );

Alternatively, you could find the hip's parent by calling

Application.LogMessage( myTorso.Hip.Parent );

MakeTorso also returns the spine's vertebrae. The number of vertebra is variable, but you can still get a particular one. For example, to get vertebra 4 off the spine, call:

var Vertebra4 = Torso.Spine.Vertebra(4);

Or to get vertebra 4 on a dog leg Biped:

var Vertebra4 = Biped.Torso.Spine.Vetebra(4);

Entire characters (and conceivably even crowds) follow the same object return structure. Return objects are documented for each command in Commands and Scripting Reference. The CDK Object Reference outlines the character rig components that are built by each of the commands.