v4.0
character rigging
Creates a rigged three bone foot. The foot rig is created from a
collection of 6 or more guide objects (see the
GuideObjectCollection parameter below for guide
requirements).
The rig created by MakeFoot contains a foot control and roll
control. It can optionally create a distribution control, typically
used for the dog leg IK distribution. This IK distribution control
is created by default by MakeDogLeg.
Optionally a shadow rig can be attached to the foot. Shadow objects
are created for each chain element in the foot, and shadow bones
are pose-constrained to the acutal foot bones. Shadow rigs can be
used to plot animation off of a rig.
oFoot = MakeFoot( Model, Parent, [ShortPrefix], [FullPrefix], GuideObjectCollection, Sliders, [Extension], [ShadowType], [ShadowParent], [ThreeBoneToe] ); |
Returns a Foot JScript object.
| Parameter | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Model | String | The model that the foot will belong to. | ||||||||||||
| Parent | String | The parent of the foot controls | ||||||||||||
| ShortPrefix | String | The short name (typically "L" or "R") to be used in the new rig. If the prefix is not given a dialog box appears prompting for one. | ||||||||||||
| FullPrefix | String | The long name (typically "Left" or "Right") to be used in the new rig. If the prefix is not given a dialog box appears prompting for one. | ||||||||||||
| GuideObjectCollection | String | A list of at least 6 objects to search for when making the foot: Middle Pivot; Right Pivot; Left Pivot; and at least 3 objects running from the start of the foot to the end of the toe (this means the foot must be at least a two bone chain). Extra items are added onto the length of the foot. | ||||||||||||
| Sliders | String | A slider PPG for foot parameters. If none is supplied a slider page is created. | ||||||||||||
| Extension | Boolean | Whether or not an Extension object is made for controlling dog
leg IK distribution. If true ,an extension icon is created.
Default Value: False |
||||||||||||
| ShadowType | Integer | The type of shadow rig to attach to the foot. Shadow rigs can
be used to transfer or remap animation.
Default Value: 0
|
||||||||||||
| ShadowParent | String | Parent of the shadow rig hiearchy. If empty, no shadow rig is generated. | ||||||||||||
| ThreeBoneToe | Boolean | True to create three-bone toes.
Default Value: True |
/*
This script creates a three bone foot.
*/
var guidecoll = new ActiveXObject("XSI.Collection");
guidecoll.Add( GetPrim("Null", "Guide_MiddlePivot") );
guidecoll.Add( GetPrim("Null", "Guide_RightPivot") );
guidecoll.Add( GetPrim("Null", "Guide_LeftPivot") );
guidecoll.Add( GetPrim("Null", "Guide_Ankle") );
guidecoll.Add( GetPrim("Null", "Guide_Foot") );
guidecoll.Add( GetPrim("Null", "Guide_Toe") );
guidecoll.Add( GetPrim("Null", "Guide_Toe2") );
var lXfm = guidecoll(0).Kinematics.Global.Transform
var lNull = GetPrim("Null", "Feet");
/*
Left Leg
*/
//Pivots
lXfm.SetTranslationFromValues(2,0,-0.5);
guidecoll(0).Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(2.5,0,-0.5);
guidecoll(1).Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(1.5,0,-0.5);
guidecoll(2).Kinematics.Global.Transform = lXfm;
//Foot
lXfm.SetTranslationFromValues(2,4 ,0.25);
guidecoll(3).Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(2,1,2);
guidecoll(4).Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(2,0.25,5);
guidecoll(5).Kinematics.Global.Transform = lXfm;
lXfm.SetTranslationFromValues(2,0,8);
guidecoll(6).Kinematics.Global.Transform = lXfm;
var threeFoot = MakeFoot(lNull, GetPrim("Null", "ThreeBone"), "ABC", "ABCDE", guidecoll, null, null, null, null, true);
var twoFoot = MakeFoot(lNull, GetPrim("Null", "TwoBone"), "ABC", "ABCDE", guidecoll, null, null, null, null, false);
SelectObj("ThreeBone", "BRANCH", null);
Translate(null, -8.93099040438492, 0, 0, siRelative, siLocal, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 0, null);
DumpFoot(twoFoot);
DumpFoot(threeFoot);
function DumpFoot(inFoot)
{
logmessage ("------------------------");
logmessage ("Data in the returned foot [" + inFoot.Parent + "]:");
logmessage ("------------------------");
logmessage ("Root : " + inFoot.Root);
logmessage ("Parent : " + inFoot.Parent);
logmessage ("BaseGuide : " + inFoot.BaseGuide);
logmessage ("FootGuides : " + inFoot.FootGuides);
logmessage ("Foot : " + inFoot.Foot);
logmessage ("Roll : " + inFoot.Roll);
logmessage ("Hidden : " + inFoot.Hidden);
logmessage ("Envelope : " + inFoot.Envelope);
logmessage ("Shadows : " + inFoot.Shadows);
logmessage ("ShadowsEnds : " + inFoot.ShadowEnds);
logmessage ("Shadows : " + inFoot.Shadows);
}
//results from running this script:
//INFO : Data in the returned foot:
//INFO : ------------------------
//INFO : Root : ABCFootRoot
//INFO : Parent : Parent
//INFO : BaseGuide : ABCFootGuide4
//INFO : FootGuides : ABCFootGuide1,ABCFootGuide2,ABCFootGuide3,ABCFootGuide4
//INFO : Foot : ABCDEFoot
//INFO : Roll : ABCDERoll
//INFO : Hidden : ABCFootRoot,ABCFootEff,ABCFootBind1,ABCFootBind2,ABCFootBind3,ABCPivotBase,ABCPlacePivot,ABCPivotLeft,ABCPivotRight,ABCFootGuide1,ABCFootGuide2,ABCFootGuide3,ABCFootGuide4,ABCFootUpV1,ABCFootUpV2,ABCFootUpV3
//INFO : Envelope : ABCFootBone1,ABCFootBone2,ABCFootBone3
//INFO : ShadowsStart: undefined
//INFO : ShadowsEnds : undefined
//INFO : Shadows : undefined
|