/* --------------------------------------------------------------------------------------------------
        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( " ");
}