v4.0
Traces a shadow hierarchy (a chain or null hierarchy) on top of an existing spine. Shadow objects are created and pose-constrained for each vertebra in the spine.
oShadow = MakeShadowSpine( Spline, Base, Vertebra, TopVertebra, ShadowParent, [ChestTop], [IconScale], [ShadowType], [ShadowCharacterSetName] ); |
Returns a Shadow JScript object.
| Parameter | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Spline | String | The Spline object of the spine to be traced. | ||||||||||
| Base | String | The base object (hip) of the spine to be traced. | ||||||||||
| Vertebra | String | A collection of the vertebrae on the spine to be traced. | ||||||||||
| TopVertebra | String | The top vertebra object (chest) on the spine to be traced. | ||||||||||
| ShadowParent | String | The parent of the new Shadow hierarchy. | ||||||||||
| ChestTop | String | (optional) The chest top object of the spine to be traced. If empty it is assumed the spine was generated without this option. | ||||||||||
| IconScale | Double |
The scale value of the spine. Used to control the icon scale of the shadow skeleton. Default Value: 1.0 |
||||||||||
| ShadowType | Integer |
The type of Shadow tracing to be drawn. For convenience the numbers align with the UI options
for the Shadow type on the default rig generators. Box Shadows are not traced here, but are
done as components because they need to make assumptions about the volume of each component.
Default Value: 1
|
||||||||||
| ShadowCharacterSetName | String |
The name of the character set that should be used for this chain. Default Value: "" |
/*
Make a spine with 3 vertebrae, then attach
a skeleton shadow to it
*/
var Base = GetPrim("Null", "Base");
var Top = GetPrim("Null", "Top");
var Depth = GetPrim("Null", "Depth");
var TopDepth= GetPrim("Null", "TopDepth");
/*
Make Spine
*/
var lXfm = XSIMath.CreateTransform();
lXfm.SetTranslationFromValues(0,0,0);
Base.Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(0,8,0);
Top.Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(0,2,0);
Depth.Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(0,6,0);
TopDepth.Kinematics.Global.Transform = lXfm;
var Spine = MakeSpine( ActiveSceneRoot, //model
ActiveSceneRoot, //parent
3, //number of vertebrae
0, //quat spine with polygon vertebrae
false, //non-stretchy
Base, Top,
Depth,TopDepth);
/*
Make Shadow
*/
var ShadowSpine = MakeShadowSpine(Spine.Curve, Spine.base, Spine.Vertebra, Spine.TopVertebra, ActiveSceneRoot,Spine.chestTop);
DumpShadowSpine(ShadowSpine);
function DumpShadowSpine(inShadowSpine)
{
logmessage ("Data in the returned spine object:");
logmessage ("---------------------------------");
logmessage ("Spline : " + inShadowSpine.Spline);
logmessage ("TopVertebra : " + inShadowSpine.TopVertebra );
logmessage ("Scale : " + inShadowSpine.Scale);
logmessage ("Parent : " + inShadowSpine.Parent);
logmessage ("#ShadowObj : " + inShadowSpine.Shadows.count);
for(var b=0;b<inShadowSpine.Shadows.count;b++)
{logmessage (" Shadow" + b + ": " + inShadowSpine.Shadows(b));}
logmessage ("#EnvelopeObj: " + inShadowSpine. Envelope.count);
for(var b=0;b<inShadowSpine.Envelope.count;b++)
{logmessage (" EnvelopeObj" + b + ": " + inShadowSpine.Envelope(b));}
logmessage ("#Vertebrae : " + inShadowSpine.Vertebra.count);
for(var b=0;b<inShadowSpine.Vertebra.count;b++)
{logmessage (" Vertebra" + b + ": " + inShadowSpine.Vertebra(b));}
logmessage ("#UpVectors : " + inShadowSpine.UpVectors.count);
for(var b=0;b<inShadowSpine.UpVectors.count;b++)
{logmessage (" UpVector" + b + ": " + inShadowSpine.UpVectors(b));}
}
//results from running this script:
//INFO : "Data in the returned spine object:"
//INFO : "---------------------------------"
//INFO : "Spline : crvlist"
//INFO : "TopVertebra : TopVertebra"
//INFO : "Scale : 1"
//INFO : "Parent : Scene_Root"
//INFO : "#ShadowObj : 6"
//INFO : " Shadow0: SpineRoot"
//INFO : " Shadow1: Spine1"
//INFO : " Shadow2: Spine2"
//INFO : " Shadow3: Spine3"
//INFO : " Shadow4: Chest"
//INFO : " Shadow5: ChestEffector"
//INFO : "#EnvelopeObj: 0"
//INFO : "#Vertebrae : 3"
//INFO : " Vertebra0: Vertebra"
//INFO : " Vertebra1: Vertebra1"
//INFO : " Vertebra2: Vertebra2"
//INFO : "#UpVectors : 4"
//INFO : " UpVector0: Shadow_upVa"
//INFO : " UpVector1: Shadow_upVa1"
//INFO : " UpVector2: Shadow_upVa2"
//INFO : " UpVector3: Shadow_upVa3" |