MakeTorso

Introduced

v4.0

Description

Creates a torso rig consisting of a spine, left and right shoulders, and a hip. The torso is rigged with controls for the chest, hip and upper body.

A collection of 10 or 11 guide objects defines the torso. The first four guide objects determine the shape of the spine. The next six define the left side of the torso (left leg base, left shouder base, left shoulder tip, right leg base, right shouder base, right shoulder tip). An 11th guide object can be added to create a chest bone. A hip icon is created with hip sockets positioned at the leg bases, and the top of the hip is positioned at the base of the spine. One bone shoulder is created using the shoulder base and tip guide objects.

A tail can be generated using MakeTorso by duplicating the spine base control object, the first object in the guide object collection. A minimum of 3 spine base duplicates are needed to generate a tail (see example).

Scripting Syntax

oTorso = MakeTorso( Parent, [NbDivisions], [StretchType], GuideObjectCollection, [ControlType], [SpineType], Sliders, [ShadowType], [ShadowParent], [NegativeScale] );

Return Value

Returns a Torso JScript object.

Parameters

Parameter Type Description
Parent String The object to which the torso will be parented. This is usually the global SRT.
NbDivisions Integer The number of spine divisions. The number of vertebra will be NbDivisions+1 .

Default Value: 2

StretchType Integer Whether the spine should stretch to follow the chest controller, or maintain a constant length.

Default Value: 0

Possible Values:

Description:

0 Stretches by spine scale slider.
1 Stretches to meet the chest controller.
GuideObjectCollection String A collection of 10 or 11 guide objects (an 11th guide object can be used as the target for a chest bone). The first four bones describe the spine path: 1) spine base, 2) spine base depth, 3) spine end depth, 4) spine end; the next three define the left side appendages of the torso: 5) left leg start, 6) left shoulder start, 7) left shoulder end; the next three define the right side appendages: 8) right leg start, 9) right shoulder start, 10) right shoulder end. The 11th object is optional and describes the chest bone position. If included, MakeTorso draws a spine to the end of this position and makes a chest bone between the position and the spine end (item #4).
ControlType Integer Type of icon to use for chest, hip, and upper body controls.

Default Value: 0

Possible Values:

Description:

0 Use square controllers.
1 Use cube controllers.
SpineType Integer The style of head assembly to be used.

Default Value: 0

Possible Values:

Description:

0 make quaternion spine with polygon divisions.
1 make quaternion spine with implicit divisions.
2 make skeleton spine.
Sliders String A slider PPG to put the spine parameters on. If none is supplied a slider page is added on the spine Curve.
ShadowType Integer The type of shadow rig to attach. Shadow rigs can be used to transfer or remap animation.

Default Value: 0

Possible Values:

Description:

0 No shadow
1 SI|3D Skeleton shadow rig
2 XSI Skeleton shadow rig
3 Null shadow rig
4 Box shadow rig
ShadowParent String Parent of the shadow rig hiearchy. If empty, no shadow rig is generated.
NegativeScale Integer Negative scaling on the shoulders. Negative scaling is useful for manipulating the left and right shoulders symmetrically.

Default Value: 0

Possible Values:

Description:

0 No negative Scaling
1 Negative scaling on the Right Shoulder
2 Negative Scaling on the Left Shoulder

Examples

JScript Example

/*

	This script builds a collection of torso guide objects

	places them and constructs a torso using the makeTorso

	command.

*/

var guidecoll = new ActiveXObject("XSI.Collection");

guidecoll.Add( GetPrim("Null", "Guide_SpineBase") ); 

guidecoll.Add( GetPrim("Null", "Guide_SpineDepth") ); 

guidecoll.Add( GetPrim("Null", "Guide_SpineEndDepth") ); 

guidecoll.Add( GetPrim("Null", "Guide_SpineEnd") ); 

guidecoll.Add( GetPrim("Null", "Guide_LLegStart") ); 

guidecoll.Add( GetPrim("Null", "Guide_LShoulderStart") ); 

guidecoll.Add( GetPrim("Null", "Guide_LShoulderEnd") ); 

guidecoll.Add( GetPrim("Null", "Guide_RLegStart") ); 

guidecoll.Add( GetPrim("Null", "Guide_RShoulderStart") ); 

guidecoll.Add( GetPrim("Null", "Guide_RShoulderEnd") ); 

var lXfm = guidecoll(0).Kinematics.Global.Transform;

lXfm.SetTranslationFromValues(0,0,0);

guidecoll(0).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(0,2,0);

guidecoll(1).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(0,4,0);

guidecoll(2).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(0,6,0);

guidecoll(3).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(2,0,0);

guidecoll(4).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(2,6,0);

guidecoll(5).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(4,6,0);

guidecoll(6).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(-2,0,0);

guidecoll(7).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(-2,6,0);

guidecoll(8).Kinematics.Global.Transform = lXfm;

lXfm.SetTranslationFromValues(-4,6,0);

guidecoll(9).Kinematics.Global.Transform = lXfm;

//

// Duplicate the spine base guide to generate a tail.

// At least 3 duplicates are required.

//

var tail0 = GetPrim("Null", "Guide_SpineBase1");  

var tail1 = GetPrim("Null", "Guide_SpineBase2");  

var tail2 = GetPrim("Null", "Guide_SpineBase3");  

lXfm.SetTranslationFromValues(0,0,-2); 

tail0.Kinematics.Global.Transform = lXfm; 

lXfm.SetTranslationFromValues(0,0,-4); 

tail1.Kinematics.Global.Transform = lXfm; 

lXfm.SetTranslationFromValues(0,0,-6); 

tail2.Kinematics.Global.Transform = lXfm; 

//

// Make the torso

// 

var Torso= MakeTorso( ActiveSceneRoot,	//parent

			 3,			//# vertebrae

			 0,			//stretch using spine scale

			 guidecoll,		//guide objects

			 1,			//cube controls

			 0);			//quat spine with polygon divs

DumpTorso(Torso);

function DumpTorso(inTorso)

{

	logmessage("Data in the returned torso object:");

	logmessage("Parent         : "+ inTorso.Parent);

	logmessage("Spine Curve    : "+ inTorso.Spine.Curve);

	logmessage("Hip Bone       : "+ inTorso.HipBone);

	logmessage("Right Effector : "+ inTorso.REff);

	logmessage("Left Effector  : "+ inTorso.LEff);

	logmessage("Right Skeleton : "+ inTorso.RSkel);

	logmessage("Left Skeleton  : "+ inTorso.LSkel);

	logmessage("Spine Vertebrae: "+ inTorso.Spine.Vertebra);

	logmessage("Upper Body     : "+ inTorso.UpperBody);

	logmessage("Hip            : "+ inTorso.Hip);

	logmessage("Chest          : "+ inTorso.Chest);

	logmessage("Hidden         : "+ inTorso.Hidden);

	logmessage("Envelope       : "+ inTorso.Envelope);

	logmessage("Shadows        : "+ inTorso.Shadows);

}

//results from running this script:

//INFO : "Data in the returned torso object:"

//INFO : "Parent         : undefined"

//INFO : "Spine Curve    : crvlist"

//INFO : "Hip Bone       : Hip"

//INFO : "Right Effector : RShoulderRoot"

//INFO : "Left Effector  : LShoulderRoot"

//INFO : "Right Skeleton : RShoulder,RShoulderEff,RShoulderRoot"

//INFO : "Left Skeleton  : LShoulder,LShoulderEff,LShoulderRoot"

//INFO : "Spine Vertebrae: Vertebra,Vertebra1,Vertebra2"

//INFO : "Upper Body     : UpperBody"

//INFO : "Hip            : Hip1"

//INFO : "Chest          : Chest"

//INFO : "Hidden         : SpineStart,SpineEnd,RShoulderRoot,LShoulderRoot"

//INFO : "Envelope       : Hip,RShoulderEff,LShoulderEff"

//INFO : "Shadows        : undefined"

See Also

MakeSpine MakeArm MakeLeg MakeDogLeg MakeHead