## MappedItem

Object Hierarchy | Related C++ Class: MappedItem

### Inheritance

###

SIObject

MappedItem

### Introduced

v1.5

### Description

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.

### Methods

IsClassOf | IsEqualTo |  |

### Properties

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

### Examples

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

Clip.MappedItems