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