CSLTimeControl Class Reference

This class represents an XSI_TimeControl template. More...

#include <TimeControl.h>

Inheritance diagram for CSLTimeControl:

CSLTemplate CSIBCNode List of all members.

Public Types
enum   EExtrapolationPos {
  SI_BEFORE,
  SI_AFTER
}
  Specifies where extrapolation occures while processing an CSLActionClip. More...

Public Member Functions
  CSLTimeControl (CSLScene *in_pScene, CSLModel *in_pModel, CdotXSITemplate *in_pTemplate)
CSLTemplate::ETemplateType  Type ()
SI_Error  Synchronize ()
SI_Float  GetIn ()
SI_Void  SetIn (SI_Float in_fNew)
SI_Float  GetOut ()
SI_Void  SetOut (SI_Float in_fNew)
SI_Float  GetScale ()
SI_Void  SetScale (SI_Float in_fNew)
SI_Float  GetStartOffset ()
SI_Void  SetStartOffset (SI_Float in_fNew)
CSLExtrapolation *  CreateExtrapolation (EExtrapolationPos in_Pos, CSLExtrapolation::EExtrapolationType in_Type=CSLExtrapolation::SI_NO_CONTRIBUTION)
CSLExtrapolation *  GetExtrapolation (EExtrapolationPos in_Pos)
SI_Void  SetExtrapolation (EExtrapolationPos in_Pos, CSLExtrapolation *in_pExtrapolation)
CSLExtrapolation *  ConnectExtrapolation (EExtrapolationPos in_Pos, CSLExtrapolation *in_pExtrapolation)
CSLXSIClipToParent *  CreateClipToParent ()
CSLXSIClipToParent *  GetClipToParent ()
SI_Void  SetClipToParent (CSLXSIClipToParent *in_pXSIClipToParent)
CSLXSIClipToParent *  ConnectClipToParent (CSLXSIClipToParent *in_pClipToParent)

Detailed Description

This class represents an XSI_TimeControl template.

Stores the clipping and offset parameters of an action clip (CSLActionClip--see the XSI_TimeControl template reference). You can add a CSLTimeControl with the CSLActionClip::AddTimeControl method.

Note:
CSLTimeControl is not supported by SI3D.
See also:
CSLActionClip

CSLExtrapolation

Member Enumeration Documentation

enum EExtrapolationPos

Specifies where extrapolation occures while processing an CSLActionClip.

Enumerator:
SI_BEFORE  Extrapolation performed before the CSLActionClip.
SI_AFTER  Extrapolation performed after the CSLActionClip.

Constructor & Destructor Documentation

CSLTimeControl ( CSLScene *  in_pScene,
CSLModel *  in_pModel,
CdotXSITemplate *  in_pTemplate  
)

Constructor

Parameters:
[in]  in_pScene  Pointer to the scene containing the CSLTimeControl
[in]  in_pModel  Pointer to the model containing the CSLTimeControl
[in]  in_pTemplate  Pointer to the CdotXSITemplate containing the CSLTimeControl data

Member Function Documentation

CSLTemplate::ETemplateType Type (  )  [inline, virtual]

Returns the type of this template

Return values:
CSLTemplate::XSI_TIMECONTROL  Template type

Implements CSLTemplate.

SI_Error Synchronize (  )  [virtual]

Synchronizes to ensure that the animated parameter is up to date.

Returns:
Error code

Reimplemented from CSLTemplate.

SI_Float GetIn (  ) 

Returns the first frame of the source that is used by the clip.

Returns:
Frame number

SI_Void SetIn ( SI_Float  in_fNew  ) 

Sets the first frame of the source that is used by the clip.

Parameters:
[in]  in_fNew  Frame number

SI_Float GetOut (  ) 

Returns the last frame of the source that is used by the clip.

Returns:
Frame number

SI_Void SetOut ( SI_Float  in_fNew  ) 

Sets the last frame of the source that is used by the clip.

Parameters:
[in]  in_fNew  Frame number

SI_Float GetScale (  ) 

Returns the scaling of the clip in time.

Returns:
The scale value

SI_Void SetScale ( SI_Float  in_fNew  ) 

Sets The scaling of the clip in time.

Parameters:
[in]  in_fNew  Scale factor
Note:
Increasing this value speeds up the relative time of the clip, decreasing the duration.

SI_Float GetStartOffset (  ) 

Returns the frame where the clip starts in the local time of the CSLActionClip.

Returns:
The start offset

SI_Void SetStartOffset ( SI_Float  in_fNew  ) 

Sets he frame where the clip starts in the local time of the CSLActionClip.

Parameters:
[in]  in_fNew  The new start offset value

CSLExtrapolation* CreateExtrapolation ( EExtrapolationPos  in_Pos,
CSLExtrapolation::EExtrapolationType  in_Type = CSLExtrapolation::SI_NO_CONTRIBUTION  
)

Creates a new extrapolation and connect it

Parameters:
[in]  in_Pos  Specifies where the extrapolation must be performed
[in]  in_Type  Type of extrapolation to create
Returns:
Pointer to the newly created extrapolation or NULL if an extrapolation at in_Pos already exists.

CSLExtrapolation* GetExtrapolation ( EExtrapolationPos  in_Pos  ) 

Returns one of the extrapolation

Parameters:
[in]  in_Pos  Specifies the extrapolation position to get
Returns:
Pointer to the requested extrapolation or NULL if there is no extrapolation at the requested position

SI_Void SetExtrapolation ( EExtrapolationPos  in_Pos,
CSLExtrapolation *  in_pExtrapolation  
)

Sets one of the extrapolation position

Parameters:
[in]  in_Pos  The extrapolation position to set.
[in]  in_pExtrapolation  The extrapolation to put at the requested position
Warning:
This method overwrites any existing extrapolation and might cause leaks. You either have to free previously allocated extrapolation or use the non-destructive CSLTimeControl::ConnectExtrapolation method instead.
See also:
CSLTimeControl::ConnectExtrapolation

CSLExtrapolation* ConnectExtrapolation ( EExtrapolationPos  in_Pos,
CSLExtrapolation *  in_pExtrapolation  
)

Sets one of the extrapolation values if not already set

Parameters:
[in]  in_Pos  Specifies the extrapolation position to set
[in]  in_pExtrapolation  Extrapolation to connect
See also:
CSLTimeControl::SetExtrapolation

CSLXSIClipToParent* CreateClipToParent (  ) 

Creates a new ClipToParent and connect it

Returns:
Pointer to the newly created ClipToParent or NULL if a ClipToParent already exists.

CSLXSIClipToParent* GetClipToParent (  ) 

Returns the ClipToParent

Returns:
Pointer to the ClipToParent or NULL if is none

SI_Void SetClipToParent ( CSLXSIClipToParent *  in_pXSIClipToParent  ) 

Sets one of the extrapolation position

Parameters:
[in]  in_pXSIClipToParent  The ClipToParent to set
Warning:
This method overwrites existing ClipToParent and might cause leaks. You either have to free the previously allocated ClipToParent or use the non-destructive CSLTimeControl::ConnectExtrapolation method instead.
See also:
CSLTimeControl::ConnectClipToParent

CSLXSIClipToParent* ConnectClipToParent ( CSLXSIClipToParent *  in_pClipToParent  ) 

Sets the ClipToParent values if not already set

Parameters:
[in]  in_pClipToParent  ClipToParent to connect
See also:
CSLTimeControl::SetClipToParent

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