ClipEffect Class Reference

 (cid * 10) + this 

        using namespace XSI;
        Application app;
        Model root = app.GetActiveSceneRoot();

        X3DObject myCube;
        root.AddGeometry( L"Cube", L"MeshSurface", L"", myCube );

        //Creating the first animation source
        CValueArray args(9);
        CValue      outArg;
        args[0] = root;
        args[1] = L"cube.kine.local.posx,cube.kine.local.posy,cube.kine.local.posz";
        args[2] = 1l;
        args[3] = L"StoredStaticPose";
        args[4] = true;
        args[5] = 1l;
        args[6] = 5l;
        args[7] = false;
        args[8] = false;
        app.ExecuteCommand( L"StoreAction", args, outArg );

        Source mySource(outArg);

        //Creating the first clip
        CValueArray addClipArgs(6);
        addClipArgs[0] = root;
        addClipArgs[1] = mySource.GetFullName();
        addClipArgs[5] = L"MyClip1";
        app.ExecuteCommand( L"AddClip", addClipArgs, outArg );

        Clip myClip(outArg);
        CRefArray mappedItems = myClip.GetMappedItems();
        // Find the mapped item on which we wan't to add an effect.
        // We are looking for the local.posy parameter
        LONG i;
        MappedItem currItem;
        for(i = 0; i < mappedItems.GetCount(); ++i)
        {
            currItem = mappedItems[i];
            Parameter param = currItem.GetDestination();
            if(param.GetFullName().IsEqualNoCase(L"cube.kine.local.posy"))
            {
                CValueArray mappingRuleArgs(4);
                mappingRuleArgs[0] = myClip.GetFullName() + L".ActionClip";
                mappingRuleArgs[1] = param;
                mappingRuleArgs[2] = L"frame";
                mappingRuleArgs[3] = (LONG)(i + 1);

                app.ExecuteCommand(L"SetMappingRule", mappingRuleArgs, outArg);
                break;
            }
        }

        ClipEffectItem effectItem(currItem.GetClipEffectItem());
        app.LogMessage(L"The expression associated with the posy item is >> " +
                        effectItem.GetExpression());

        using namespace XSI;

        // Forward declarations
        CString GetRelativeNameForTarget( Parameter& in_param );
        void CreateStaticSource();


        Application app;

        // NewScene command
        CValueArray cargs; CValue oarg;
        cargs.Add( L"" ); cargs.Add( false );
        app.ExecuteCommand( L"NewScene", cargs, oarg );
        cargs.Clear(); oarg.Clear();

        // Set up the scene
        Model root = app.GetActiveSceneRoot();
        CreateStaticSource();

        // Get all the clips in the mixer and then the sources
        Mixer mix = root.GetMixer();
        CRefArray cliplist = mix.GetClips();
        for ( LONG i=0; i<cliplist.GetCount(); ++i ) {
            Clip clp( cliplist[i] );

            // Look at their mapped items, but avoid the audio clips
            if ( clp.GetType() != siClipAudioType ) {
                CRefArray mappings = clp.GetMappedItems();
                if ( mappings.IsValid() ) {
                    app.LogMessage( L"Found " + CString(mappings.GetCount()) + L" mapped items(s)" );
                    for ( LONG j=0; j<mappings.GetCount(); j++ ) {
                        MappedItem mapitem( mappings[j] );

                        // Each item on the clip effect may have an expression that controls
                        // its behavior independently of the original source
                        ClipEffectItem clpfxitem = mapitem.GetClipEffectItem();
                        if ( clpfxitem.GetExpression() != L"" ) {
                            app.LogMessage( L"...this clip has a clip effect item matching this expression:" );
                            app.LogMessage( L"   " + clpfxitem.GetExpression() );
                        }

                        // The mapped item also provides access to the driven parameter
                        Parameter dest( mapitem.GetDestination() );
                        app.LogMessage( L"...destination parameter: " + dest.GetFullName() );
                    }
                }

            }
        }


        // Expected Results:
        //INFO : Found 3 mapped items(s)
        //INFO : ...destination parameter: MyNull.kine.local.posx
        //INFO : ...destination parameter: MyNull.kine.local.posy
        //INFO : ...destination parameter: MyNull.kine.local.posy


        // This is a handy function to have around if you're going to create an action
        // source or clip on a parameter that is in a nested model (ie., not directly
        // under the Scene_Root) because AddClip will force a mapping template if your
        // parameter is not relative.
        CString GetRelativeNameForTarget( Parameter& in_param )
        {
            Model mdl = in_param.GetModel();
            CString mdlname = mdl.GetFullName();
            if ( mdlname.IsEqualNoCase(L"Scene_Root") ) {
                return in_param.GetFullName();
            } else {
                CString tmp = in_param.GetFullName();
                CString lookfor = mdlname + L".";
                CString foundsofar = L"";
                CString relpath = L"";
                for ( ULONG i=0; i<tmp.Length(); ++i ) {
                    if ( foundsofar.IsEqualNoCase(lookfor) ) {
                        relpath += tmp[i];
                    } else {
                        foundsofar += tmp[i];
                    }
                }
                return relpath;
            }
        }

        // Convenience function
        void CreateStaticSource()
        {
            Application app;

            // Get the SceneRoot and create a cone in it
            Model root = app.GetActiveSceneRoot();
            Null n; root.AddNull( L"MyNull", n );

            // Get the parameters to use as targets
            Parameter posx = n.GetParameter( L"posx" ); CString rposx = GetRelativeNameForTarget( posx );
            Parameter posy = n.GetParameter( L"posy" ); CString rposy = GetRelativeNameForTarget( posy );
            Parameter posz = n.GetParameter( L"posz" ); CString rposz = GetRelativeNameForTarget( posz );

            // Create a stored static pose
            ActionSource src = root.AddActionSource( L"StoredStaticPose" );
            src.AddSourceItem( rposx, 5.5743, true );
            src.AddSourceItem( rposy, 0.1953, true );
            src.AddSourceItem( rposy, -0.0195, true );

            // Instantiate it in the mixer
            CValueArray clpArgs(9); CValue clpOut;
            clpArgs[0] = root.GetFullName();
            clpArgs[1] = src.GetFullName();
            clpArgs[4] = CValue(4.0);                          // starts at frame 4
            app.ExecuteCommand( L"AddClip", clpArgs, clpOut );
        }