Public Member Functions
ClipRelation Class Reference

Detailed Description

Clip relations are logical entities used to create a bi-directional constraint between two clips, the master and slave clip.

By default, a ClipRelation creates relationships between the start offset, clip in and clip out value of the TimeControl of the related clips. ClipRelations are bi-directional in the sense that, by modifying the value of one of the related parameter either on the master or slave clip it proportionally affects the value of the other clip.

For each individual relationship there's an activeness Parameter (StartActiveness, ClipInActiveness and ClipOutActiveness) and an offset. The offset represents the difference between the value of the Master clip parameter and the Slave clip parameter. Modifying the value of an offset results in changing the value of the slave clip relative to the master clip. It is possible to inverse the master and slave clip by using ClipRelation::SwapMasterAndSlaveClip.

You can create a ClipRelation using ClipContainer::AddRelation and access them using either Clip::GetRelations or ClipContainer::GetNestedRelations. In order to access the master and slave clip you can use ClipRelation::GetMasterClip or ClipRelation::GetSlaveClip.

See also:
Clip::GetRelations, ClipContainer::AddRelation, ClipContainer::GetNestedRelations
Since:
4.0
Example:
Demonstrates how to create a ClipRelation, how to access its offsets and how modifying one makes an impact on the TimeControl of the master and slave clip.
        using namespace XSI;
        Application app;
        Model root = app.GetActiveSceneRoot();

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

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

        CValueArray addClipArgs(6);
        addClipArgs[0] = root;
        addClipArgs[1] = mySource.GetFullName();
        addClipArgs[4] = 19l;
        addClipArgs[5] = L"MyClip";
        app.ExecuteCommand( L"AddClip", addClipArgs, outArg );

        Clip myClip(outArg);

        addClipArgs[4] = 47l;
        addClipArgs[5] = L"MyClip1";
        app.ExecuteCommand( L"AddClip", addClipArgs, outArg );

        Clip myClip1(outArg);

        Mixer myRootMixer = root.GetMixer();
        ClipRelation myClipRelation = myRootMixer.AddRelation(myClip, myClip1 , L"myRelation");

        app.LogMessage(L">>>Original ClipRelation information.");
        Print_ClipRelation_Info(myClipRelation);

        app.LogMessage(L">>>Modifying the startoffset value of the ClipRelation.");
        myClipRelation.PutParameterValue(L"StartOffset",
                    (double)myClipRelation.GetParameterValue(L"StartOffset") + 3);
        Print_ClipRelation_Info(myClipRelation);

        app.LogMessage(L">>>Modifying the start value of the TimeControl of the master clip.");
        TimeControl myMasterClipTC = myClipRelation.GetMasterClip().GetTimeControl();
        myMasterClipTC.PutParameterValue(L"StartOffset",
                        (double)myMasterClipTC.GetParameterValue(L"StartOffset") + 4);
        Print_ClipRelation_Info(myClipRelation);

        app.LogMessage(L">>>Swapping master and slave clip.");
        myClipRelation.SwapMasterAndSlaveClip();
        Print_ClipRelation_Info(myClipRelation);

        app.LogMessage(L">>>Modifying the startoffset value of the ClipRelation.");
        myClipRelation.PutParameterValue(L"StartOffset",
                        (double)myClipRelation.GetParameterValue(L"StartOffset") + 3);
        Print_ClipRelation_Info(myClipRelation);

        void Print_ClipRelation_Info( ClipRelation& in_rClipRelation )
        {
            Application app;
            app.LogMessage(L"The clip relation name is: " + in_rClipRelation.GetName() );

            //Printing the offset between the master and slave clips
            app.LogMessage( L"The start offset is: " +
                             in_rClipRelation.GetParameterValue(L"StartOffset").GetAsText() );

            app.LogMessage( L"The ClipIn offset is: " +
                            in_rClipRelation.GetParameterValue(L"ClipInOffset").GetAsText() );

            app.LogMessage( L"The ClipOut offset is: " +
                            in_rClipRelation.GetParameterValue(L"ClipOutOffset").GetAsText() );

            // Printing the value related to the master clip
            Clip masterClip = in_rClipRelation.GetMasterClip();
            app.LogMessage( L"The master clip name is: " + masterClip.GetName() );

            TimeControl masterTimeControl = masterClip.GetTimeControl();
            app.LogMessage( L"The master clip start value is: " +
                            masterTimeControl.GetParameterValue(L"StartOffset").GetAsText() );
            app.LogMessage( L"The master clip ClipIn value is: " +
                            masterTimeControl.GetParameterValue(L"ClipIn").GetAsText() );
            app.LogMessage( L"The master clip ClipOut value is: " +
                            masterTimeControl.GetParameterValue(L"ClipOut").GetAsText() );

            // Printing the value related to the slave clip
            Clip slaveClip = in_rClipRelation.GetSlaveClip();
            app.LogMessage( L"The slave clip name is: " + slaveClip.GetName() );

            TimeControl slaveTimeControl = slaveClip.GetTimeControl();
            app.LogMessage( L"The slave clip start value is: " +
                            slaveTimeControl.GetParameterValue(L"StartOffset").GetAsText());
            app.LogMessage( L"The slave clip ClipIn value is: " +
                            slaveTimeControl.GetParameterValue(L"ClipIn").GetAsText() );
            app.LogMessage( L"The slave clip ClipOut value is: " +
                            slaveTimeControl.GetParameterValue(L"ClipOut").GetAsText() );

        }

#include <xsi_cliprelation.h>

Inheritance diagram for ClipRelation:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 ClipRelation ()
 ~ClipRelation ()
 ClipRelation (const CRef &in_ref)
 ClipRelation (const ClipRelation &in_obj)
bool IsA (siClassID in_ClassID) const
siClassID GetClassID () const
ClipRelationoperator= (const ClipRelation &in_obj)
ClipRelationoperator= (const CRef &in_ref)
Clip GetMasterClip () const
Clip GetSlaveClip () const
CStatus SwapMasterAndSlaveClip ()

Constructor & Destructor Documentation

Default constructor.

Default destructor.

ClipRelation ( const CRef in_ref)

Constructor.

Parameters:
in_refconstant reference object.
ClipRelation ( const ClipRelation in_obj)

Copy constructor.

Parameters:
in_objconstant class object.

Member Function Documentation

bool IsA ( siClassID  in_ClassID) const [virtual]

Returns true if a given class type is compatible with this API class.

Parameters:
in_ClassIDclass type.
Returns:
bool true if the class is compatible, false otherwise.

Reimplemented from ProjectItem.

siClassID GetClassID ( ) const [virtual]

Returns the type of the API class.

Returns:
siClassID the class type.

Reimplemented from ProjectItem.

ClipRelation& operator= ( const ClipRelation in_obj)

Creates an object from another object. The newly created object is set to empty if the input object is not compatible.

Parameters:
in_objconstant class object.
Returns:
ClipRelation& New ClipRelation object.
ClipRelation& operator= ( const CRef in_ref)

Creates an object from a reference object. The newly created object is set to empty if the input reference object is not compatible.

Parameters:
in_refconstant class object.
Returns:
ClipRelation& New ClipRelation object.

Reimplemented from ProjectItem.

Clip GetMasterClip ( ) const
Clip GetSlaveClip ( ) const
CStatus SwapMasterAndSlaveClip ( )

Exchanges the master and slave clip of the ClipRelation and recomputes the offsets. When updating an offset this always affects the slave clip. Therefore this function is useful if, for example, you would like to modify the start offset of the Master clip relative to the Slave clip.

Returns:
CStatus::OK success
CStatus::Fail failure
See also:
ClipRelation::GetSlaveClip, ClipRelation::GetMasterClip, ClipContainer::GetNestedRelations, ClipContainer::AddRelation
Since:
4.0

The documentation for this class was generated from the following file: