CopyClipToTrack
 
 
 

CopyClipToTrack

Introduced

v1.5

Description

Copies a Clip within one Track, or to another track of the same type within a Model.

Scripting Syntax

oReturn = CopyClipToTrack( Model, Clip, [Compound], Track, [Time] );

Return Value

Returns a Clip object).

Parameters

Parameter Type Description
Model String The model owning the clip. Note: The parameter is ignored for the shot clip type.
Clip String Source clip to copy.
Compound String The compound container (track owner) to copy the clip to. Note: The parameter is ignored for the shot clip type.
Track String The track to copy the clip to.
Time Double Frame to copy the clip to.

Default Value: Current frame.

Examples

VBScript Example

'
' This example makes a couple of shape keys and instantiates them on the mixer,
' transitioning between them.  Then it copies one of the clips into a compound
' clip container.
'
' Create the object for our example.
set oSphere = CreatePrim( "Sphere", "MeshSurface" )
' Store a couple of shape keys (we use the temporarily-applied bulge
' just to have an interesting shape for the second key.
set oSourceShape1 = StoreShapeKey( oSphere, , siShapeLocalReferenceMode )
set oBulge = ApplyOp( "Bulge", oSphere, 3, siPersistentOperation, , 1 )
set oSourceShape2 = StoreShapeKey( oSphere, , siShapeLocalReferenceMode )
DeleteObj oBulge
' Create a temporary track to put the clips onto.
set oTrackTemp = AddTrack( oSphere, , 1 )
' Instantiate the shape sources onto the track.
set oClipShape1 = AddClip( "Scene_Root", oSourceShape1, , oTrackTemp, 1 )
set oClipShape2 = AddClip( "Scene_Root", oSourceShape2, , oTrackTemp, 90 )
' Put a transition between the two clips.
AddTransition oClipShape1, oClipShape2, 0
' Create a track for a shape compound, then copy one of the clips into it.
set oTrackCpd = AddTrack( "Scene_Root", , 1, "ForCompound" )
CopyClipToTrack "Scene_Root", oClipShape2, , oTrackCpd 
' Delete the temporary track
DeleteObj oTrackTemp

See Also

MoveClipToTrack AddClip AddTrack