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 ); } |