Object Model: ClipContainer.NestedRelations

ClipContainer.NestedRelations

Introduced

v4.0

Description

Returns a ClipRelationCollection containing each ClipRelation object nested under the ClipContainer object. For now only the Mixer object can nest clip relations.

Note: To get the collection of ClipRelation objects that affect a particular clip use Clip.Relations instead.

C# Syntax

// get accessor
ClipRelationCollection rtn = ClipContainer.NestedRelations;

Examples

JScript Example

/*
        This example shows how to create a ClipRelation.
*/
NewScene(null, false);
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);
sParams = "cone.kine.local.sclx,cone.kine.local.scly,cone.kine.local.sclz"
        + ",cone.kine.local.rotx,cone.kine.local.roty,cone.kine.local.rotz"
        + ",cone.kine.local.posx,cone.kine.local.posy,cone.kine.local.posz";
StoreAction(null, sParams, 1, "StoredStaticPose", true, 1, 5, false, false);
SelectObj("cone", null, true);
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;
var myClipRelation = oRootMixer.AddRelation(myClip, myClip1 , "myRelation");
var myNestedRelations = oRootMixer.NestedRelations;
var myRelations = oRootMixer.Relations;
LogMessage( "The number of clip relation(s) nested under the mixer is: " 
        + myNestedRelations.count );
LogMessage( "The number of clip relation(s) affecting the mixer is: " 
        + myRelations.count );