AddLayerClip

Introduced

v6.0

Description

Creates a Layer Clip and adds it to the Mixer of the specified Model. An empty source is added for the new layer clip.

Scripting Syntax

oReturn = AddLayerClip( Model, [Track], [Name] );

Return Value

Returns a layer Clip object.

Parameters

Parameter Type Description
Model String Model to add the clip to.
Track String Track to add this clip to. Must be a layer track.
Name String Name for the new clip.

Examples

VBScript Example

'

' This example creates a simple Action and instantiates it

' on two different objects using a connection mapping template.

' It shows very basic mixer scripting -- creating Actions, tracks

' and clips, as well as a simple mapping template.

'

' Create objects for our example.

set oSphere = CreatePrim( "Sphere", "MeshSurface" )

posParams = "/kine.local.posx,kine.local.posy,kine.local.posz"

' Make an Action with it moving diagonally over 20 frames.

SetPositionKey oSphere, 1, -5, -5, 0

SetPositionKey oSphere, 20, 5, 5, 0

' Create a layer track and instantiate the Action onto it

set oTrack = AddTrack( "Scene_Root", , 5 )

set oClip = AddLayerClip( "Scene_Root", oTrack )

'==================================================

' Helper method to key an object somewhere at a given frame.

'==================================================

sub SetPositionKey( in_oObj, in_frame, in_posX, in_posY, in_posZ )

	Translate in_oObj, in_posX, in_posY, in_posZ, siAbsolute, siParent, siObj, siXYZ

	SaveKey in_oObj & posParams, in_frame

end sub

See Also

AddTrack Clip