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