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 C# and Scripting Reference. The CDK Object Reference outlines the character rig components that are built by each of the commands.



Autodesk Softimage v7.5