#
# This example demonstrates how to create tracks and retrieve all tracks 
# recursively under the ClipContainer using ClipContainer.Tracks.
# 
# The following hierarchy will be created:
#
# Mixer
#       |
#   +-Track (an animation track)
#   |   |
#   |   +-CompoundClip
#   |          |
#   |          +-Track4 (an animation track)
#   |
#   +-Track1 (an animation track)
#   |
#   +-Track2 (a shape track)
#   |
#   +-Track3 (an audio track)
#
#
Application.NewScene( None, False )
oRoot = Application.ActiveSceneRoot
oCube = oRoot.AddGeometry("Cube", "MeshSurface")        
# Creating the first animation source
sParams = "cube.kine.local.posx,cube.kine.local.posy,cube.kine.local.posz"
oSource = Application.StoreAction(oRoot, sParams, 1, "StoredStaticPose", 1, 1, 5, 0, 0)
# Creating the first clip
oClip = Application.AddClip(oRoot, oSource)     
Application.LogMessage("First created clip " + oClip.FullName )
Application.LogMessage("First created Track " + oClip.Parent.FullName )
oCube.Parameters("posx").Value  =  3.0
# Creating the second animation source
oSource2 = Application.StoreAction(oRoot, sParams, 1, "StoredStaticPose", 1, 7, 9, 0, 0)
# Creating the second clip
oClip2 = Application.AddClip(oRoot, oSource2)   
Application.LogMessage("Second created Clip " + oClip2.FullName)
Application.LogMessage("Second created Track " + oClip2.Parent.FullName)
# Adding a shape track
oMixer = oRoot.Mixer
oShapeTrack = Application.AddTrack(oRoot, oMixer, 1)
Application.LogMessage("Third created Track " + oShapeTrack.FullName )
# Adding an audio track
oAudioTrack = Application.AddTrack(oRoot, oMixer, 2)            
Application.LogMessage("Fourth created Track " + oAudioTrack.FullName)
# Creating a compound clip from the clips created earlier
# This implicitly creates a track for the nested clip
myClips = [oClip, oClip2]
oCompound = Application.CreateCompound(oRoot, myClips)
def FindTracksRecursively(in_oClipContainer):
        "This method returns an XSICollection containing the tracks which are nested under a ClipContainer"
        oReturnValue = XSIFactory.CreateActiveXObject("XSI.Collection")
        # First lets get the tracks which are directly under the container.
        oTracks = in_oClipContainer.Tracks
        for i in range(oTracks.Count):
                oReturnValue.Add(oTracks(i))
                oClips = oTracks(i).Clips
                for j in range(oClips.Count):
                        if Application.ClassName(oClips(j)) == "CompoundClip" :
                                oTracks2 = oClips(j).Tracks
                                for k in range(oTracks2.Count):
                                        oReturnValue.Add(oTracks2(k))
        return oReturnValue
# Now retrieving all tracks recursively.
Application.LogMessage(FindTracksRecursively.__doc__)
oAllTracks = FindTracksRecursively(oRoot.Mixer)
Application.LogMessage("The resulting complete track list is the following: ")
for i in range(oAllTracks.Count):
        Application.LogMessage(oAllTracks(i).FullName)
# Output of the above script:
#INFO : First created clip Mixer.Mixer_Anim_Track.StoredStaticPose_Clip
#INFO : First created Track Mixer.Mixer_Anim_Track
#
#INFO : Second created Clip Mixer.Mixer_Anim_Track1.StoredStaticPose1_Clip
#INFO : Second created Track Mixer.Mixer_Anim_Track1
#
#INFO : Third created Track Mixer.Mixer_Shape_Track
#
#INFO : Fourth created Track Mixer.Mixer_Audio_Track
#
#INFO : This method returns an XSICollection containing the tracks which are nested under a ClipContainer
#INFO : The resulting complete track list is the following: 
#INFO : Mixer.Mixer_Anim_Track
#INFO : Mixer.Mixer_Anim_Track1
#INFO : Mixer.Mixer_Shape_Track
#INFO : Mixer.Mixer_Audio_Track