## 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