Object Hierarchy | Related C++ Class: MappedItem
MappedItem
v1.5
The MappedItem object holds the DataSource of a Clip
object. It provides access to the related source (MappedItem.Source2), the
parameter which is driven by the related source (MappedItem.Destination), and
any ClipEffectItems applied to the clip (MappedItem.ClipEffectItem).
Note: This object is available from the Clip.MappedItems property (which
returns a MappedItemCollection). The MappedItem object is only available for clips
instantiated from ActionSources (either action animation or shape animation). You
can test this by calling the base property SIObject.Type on the Clip object which
returns one of the values for the siClipType constant.
Application | Categories | ClipEffectItem | Destination |
FullName | Help | Name | NestedObjects |
Origin | OriginPath | Parent | Source2 |
Type | |||
/* This example demonstrates how to use MappedItems by creating some sources and clips and then finding the mapped items on the clips in the mixer. */ NewScene( null, false ); // Set up some sources and clips in the scene (see end of example for details) CreateShapeAction( ActiveSceneRoot ); // Get all the clips in the mixer and then the sources var clips = ActiveSceneRoot.Mixer.Clips; for ( var i=0; i<clips.Count; i++ ) { // Look at their mapped items, but avoid the audio clips if ( clips(i).Type != siClipAudioType && clips(i).MappedItems ) { var clp = clips(i); LogMessage( "Found " + clp.MappedItems.Count + " mapped items(s)" ); for ( var j=0; j<clp.MappedItems.Count; j++ ) { var mapping = clp.MappedItems(j); LogMessage( "\t...does it have a clip effect item associated? " + (mapping.ClipEffectItem.Expression != "") ); LogMessage( "\t...destination parameter: " + mapping.Destination ); } } } // Expected results: //INFO : Found 1 mapped items(s) //INFO : ...does it have a clip effect item associated? false //INFO : ...destination parameter: cone.polymsh.cls.Shape // Convenience function function CreateShapeAction( in_model ) { var obj = in_model.AddGeometry( "Cone", "MeshSurface" ); var target = obj + ".pnt[0,2,5,8,11,14,17,20,23]" SetSelFilter( "Vertex" ); SelectGeometryComponents( target ); Translate( null, 0, -2, 0, siAbsolute, siPivot, siObj, siY, null, null, null, null, null, null, null, null, null, 1 ); SaveShapeKey( target, null, null, 1, null, null, null, null, siShapeObjectReferenceMode ); } |