<     > 

M

MappedItem

Object Hierarchy | Related C++ Class: MappedItem

Inheritance

SIObject
   MappedItem

Introduced

1.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

Properties

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

Autodesk Softimage v7.5     <     >