Object Hierarchy | Related C++ Class: ClipRelation
ClipRelation
v4.0
The ClipRelation object represents a relationship between two
Clip objects in the animation mixer. Clip
relations are particularly useful for maintaining a relationship
between clips of different types, such as an animation clip and an
audio clip. The ClipRelation object provides methods for
establishing these links and getting and setting their properties
without using the mixer.
By default a clip relation creates relationships among the start
offset, clip in and clip out values of the linked clips's TimeControl. Clip relations are
bi-directional in the sense that, by modifying the value of one of
the related parameters (either on the master or slave clip) it
proportionally affects the value of the other clip.
For each individual relationship there's an active state Parameter (StartActiveness, ClipInActiveness
and ClipOutActiveness) and an offset. The offset represents the
difference between the value of the master clip parameter and the
slave clip parameter. Modifying the value of an offset results in
changing the value of the slave clip relative to the master clip.
You can inverse the master and slave clip by using ClipRelation.SwapMasterAndSlaveClip.
You can create a ClipRelation using ClipContainer.AddRelation and
you can access a ClipRelation using either Clip.Relations or ClipContainer.NestedRelations.
In order to access the master or slave clip you can use ClipRelation.MasterClip or
ClipRelation.SlaveClip.
/* --------------------------------------------------------------------------------------------------
This example shows how to create a ClipRelation, how to access its offsets and how modifying
one makes an impact on the TimeControl of the master and slave clip.
*/
NewScene(null, false);
// Set up scene with a cone and add some animation
CreatePrim("Cone", "MeshSurface", null, null);
Translate(null, 5.57429595406375, 0.195303936039821, -1.95303936039821E-02,
siRelative, siView, siObj, siXYZ, null, null, siXYZ, null, null, null, null, null, null, 0);
var myTforms = "cone.kine.local.sclx,cone.kine.local.scly,cone.kine.local.sclz,";
myTforms += "cone.kine.local.rotx,cone.kine.local.roty,cone.kine.local.rotz";
myTforms += "cone.kine.local.posx,cone.kine.local.posy,cone.kine.local.posz";
StoreAction(null, myTforms, 1, "StoredStaticPose", true, 1, 5, false, false);
SelectObj("cone", null, true);
// Add 2 tracks to the mixer and create 2 separate clips for the stored animation
AddTrack("Scene_Root", "Scene_Root", 0, null, null);
AddTrack("Scene_Root", "Scene_Root", 0, null, null);
var myClip = AddClip("Scene_Root", "Sources.Scene_Root.StoredStaticPose", null,
"Mixer.Mixer_Anim_Track", 19, null, null, null, null);
var myClip1 = AddClip("Scene_Root", "Sources.Scene_Root.StoredStaticPose", null,
"Mixer.Mixer_Anim_Track1", 47, null, null, null, null);
var oRootMixer = ActiveSceneRoot.Mixer;
// Set up a clip relation between the two clips
var myClipRelation = oRootMixer.AddRelation(myClip, myClip1, "myRelation");
LogMessage(">>>Original ClipRelation information.");
Print_ClipRelation_Info(myClipRelation);
LogMessage(">>>Modifying the startoffset value of the ClipRelation.");
myClipRelation.Parameters("StartOffset").value = myClipRelation.Parameters("StartOffset").Value + 3;
Print_ClipRelation_Info(myClipRelation);
LogMessage(">>>Modifying the start value of the TimeControl of the master clip.");
var myMasterClipTC = myClipRelation.MasterClip.TimeControl;
myMasterClipTC.Parameters("StartOffset").Value = myMasterClipTC.Parameters("StartOffset").Value + 4;
Print_ClipRelation_Info(myClipRelation);
LogMessage(">>>Swapping master and slave clip.");
myClipRelation.SwapMasterAndSlaveClip();
Print_ClipRelation_Info(myClipRelation);
LogMessage(">>>Modifying the startoffset value of the ClipRelation.");
myClipRelation.Parameters("StartOffset").Value = myClipRelation.Parameters("StartOffset").Value + 3;
Print_ClipRelation_Info(myClipRelation);
/* --------------------------------------------------------------------------------------------------
Utility function to print relation information, including its name and offset values.
*/
function Print_ClipRelation_Info( in_ClipRelation )
{
LogMessage( "The clip relation name is: " + in_ClipRelation.Name );
// Printing the offset between the master and slave clips
LogMessage( "The start offset is: " + in_ClipRelation.Parameters("StartOffset").Value );
LogMessage( "The ClipIn offset is: " + in_ClipRelation.Parameters("ClipInOffset").Value );
LogMessage( "The ClipOut offset is: " + in_ClipRelation.Parameters("ClipOutOffset").Value );
// Printing the master clip values
var masterClip = in_ClipRelation.MasterClip;
LogMessage( "The master clip name is: " + masterClip.Name );
var masterTimeControl = masterClip.TimeControl;
LogMessage( "The master clip start value is: " + masterTimeControl.StartOffset);
LogMessage( "The master clip ClipIn value is: " + masterTimeControl.ClipIn);
LogMessage( "The master clip ClipOut value is: " + masterTimeControl.ClipOut );
// Printing the slave clip values
var slaveClip = in_ClipRelation.SlaveClip;
LogMessage( "The slave clip name is: " + slaveClip.Name );
var slaveTimeControl = slaveClip.TimeControl;
LogMessage( "The slave clip start value is: " + slaveTimeControl.StartOffset );
LogMessage( "The slave clip ClipIn value is: " + slaveTimeControl.ClipIn );
LogMessage( "The slave clip ClipOut value is: " + slaveTimeControl.ClipOut );
LogMessage( " ");
}
|
