MergeClips

Introduced

v2.0

Description

Create a new source that contains a copy of the keys of each fcurve in the selected clips. This is similar to a plot, except that the data is not generated with a key at every frame.

Note: Clips should not overlap, or be weighted against other clips, or have timewarps. Only works with FCurve and static value items.

Scripting Syntax

oReturn = MergeClips( InputObjs );

Return Value

Returns the new ActionSource created.

Parameters

Parameter Type Description
InputObjs String List of clips to merge.

Default Value: Current selection

Examples

VBScript Example

' This example creates three clips on a track.  Then
' it merges the data (static values and fcurve keys)
' from those three sources into a new source Action.
' Finally it instantiates this merged Action onto the
' mixer.
option explicit
dim oSph, strParams, oTrack(1), oAct(2), oClip(2), oMerged
' Create an object for us to play with.
strParams = "/kine.local.posx,kine.local.posy,kine.local.posz"
NewScene , False
set oSph = CreatePrim( "Sphere", "MeshSurface" )
' Create an Action containing fcurve sources.
Translate oSph, -6, 4, 0, siAbsolute, siParent, siObj, siXYZ
SaveKey oSph & strParams, 1
Translate oSph, -8, -6, 0, siAbsolute, siParent, siObj, siXYZ
SaveKey oSph & strParams, 10
Translate oSph, 6, -4, 0, siAbsolute, siParent, siObj, siXYZ
SaveKey oSph & strParams, 20
set oAct(0) = StoreAction( , oSph & strParams, 2, "StoredFcvPose", True, 1, 20, False, False )
' Create a couple of Actions with static (snapshot) sources.
Translate oSph, 8, 6, 0, siAbsolute, siParent, siObj, siXYZ
set oAct(1) = StoreAction( , oSph & strParams, 1, "StoredStaticAction", True, 1, 1, False, False )
Translate oSph, 0, 0, -10, siAbsolute, siParent, siObj, siZ
set oAct(2) = StoreAction( , oSph & strParams, 1, "StoredStaticAction", True, 1, 1, False, False )
' Instantiate these three Actions on the mixer.
set oTrack(0) = AddTrack( "Scene_Root", "Scene_Root", 0 )
set oClip(0) = AddClip( "Scene_Root", oAct(1), , oTrack(0), 5, , , , False )
set oClip(1) = AddClip( "Scene_Root", oAct(0), , oTrack(0), 15, , , , False )
set oClip(2) = AddClip( "Scene_Root", oAct(2), , oTrack(0), 45, , , , False )
' Merge together the three clips into a new Action.
set oMerged = MergeClips( oClip(0) & "," & oClip(1) & "," & oClip(2) )
' Finally, add this as a new clip, muting the first track.
SetValue oTrack(0) & ".mute", True
set oTrack(1) = AddTrack( "Scene_Root", "Scene_Root", 0 )
AddClip "Scene_Root", oMerged, , oTrack(1), 5, , , , False