Object Hierarchy | Related C++ Class: MappedItem







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.


IsClassOf operator IsEqualTo operator    


Application Categories ClipEffectItem Destination
FullName operator Help Name operator NestedObjects
Origin OriginPath Parent Source2
Type operator      


JScript Example

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

See Also