Open CASCADE Technology  7.1.0.beta
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes

AIS_Animation Class Reference

Class represents single animation. It is defined with: More...

#include <AIS_Animation.hxx>

Inheritance diagram for AIS_Animation:
Inheritance graph
[legend]

Public Member Functions

 AIS_Animation (const TCollection_AsciiString &theAnimationName)
 Creates empty animation. More...
 
virtual ~AIS_Animation ()
 Destruct object, clear arguments. More...
 
const TCollection_AsciiStringName () const
 Animation name. More...
 
Standard_Real StartPts () const
 
void SetStartPts (const Standard_Real thePtsStart)
 Sets time limits for animation in the animation timeline. More...
 
Standard_Real Duration () const
 
void UpdateTotalDuration ()
 Update total duration considering all animations on timeline. More...
 
Standard_Boolean HasOwnDuration () const
 Return true if duration is defined. More...
 
Standard_Real OwnDuration () const
 
void SetOwnDuration (const Standard_Real theDuration)
 Defines duration of the animation. More...
 
void Add (const Handle< AIS_Animation > &theAnimation)
 Add single animation to the timeline. More...
 
void Clear ()
 Clear animation timeline - remove all animations from it. More...
 
Handle< AIS_AnimationFind (const TCollection_AsciiString &theAnimationName) const
 Return the child animation with the given name. More...
 
Standard_Boolean Remove (const Handle< AIS_Animation > &theAnimation)
 Remove the child animation. More...
 
Standard_Boolean Replace (const Handle< AIS_Animation > &theAnimationOld, const Handle< AIS_Animation > &theAnimationNew)
 Replace the child animation. More...
 
void CopyFrom (const Handle< AIS_Animation > &theOther)
 Clears own children and then copy child animations from another object. Copy also Start Time and Duration values. More...
 
const NCollection_Sequence< Handle< AIS_Animation > > & Children () const
 Return sequence of child animations. More...
 
virtual void StartTimer (const Standard_Real theStartPts, const Standard_Real thePlaySpeed, const Standard_Boolean theToUpdate, const Standard_Boolean theToStopTimer=Standard_False)
 Start animation with internally defined timer instance. Calls ::Start() internally. More...
 
virtual Standard_Real UpdateTimer ()
 Update single frame of animation, update timer state. More...
 
Standard_Real ElapsedTime () const
 Return elapsed time. More...
 
virtual void Start (const Standard_Boolean theToUpdate)
 Start animation. This method changes status of the animation to Started. This status defines whether animation is to be performed in the timeline or not. More...
 
virtual void Pause ()
 Pause the process timeline. More...
 
virtual void Stop ()
 Stop animation. This method changed status of the animation to Stopped. This status shows that animation will not be performed in the timeline or it is finished. More...
 
bool IsStopped ()
 Check if animation is to be performed in the animation timeline. More...
 
virtual Standard_Boolean Update (const Standard_Real thePts)
 Update single frame of animation, update timer state. More...
 
- Public Member Functions inherited from Standard_Transient
 Standard_Transient ()
 Empty constructor. More...
 
 Standard_Transient (const Standard_Transient &)
 Copy constructor – does nothing. More...
 
Standard_Transientoperator= (const Standard_Transient &)
 Assignment operator, needed to avoid copying reference counter. More...
 
virtual ~Standard_Transient ()
 Destructor must be virtual. More...
 
virtual void Delete () const
 Memory deallocator for transient classes. More...
 
virtual const opencascade::handle< Standard_Type > & DynamicType () const
 Returns a type descriptor about this object. More...
 
Standard_Boolean IsInstance (const opencascade::handle< Standard_Type > &theType) const
 Returns a true value if this is an instance of Type. More...
 
Standard_Boolean IsInstance (const Standard_CString theTypeName) const
 Returns a true value if this is an instance of TypeName. More...
 
Standard_Boolean IsKind (const opencascade::handle< Standard_Type > &theType) const
 Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_Boolean IsKind (const Standard_CString theTypeName) const
 Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_TransientThis () const
 Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...
 
Standard_Integer GetRefCount () const
 Get the reference counter of this object. More...
 
void IncrementRefCounter () const
 Increments the reference counter of this object. More...
 
Standard_Integer DecrementRefCounter () const
 Decrements the reference counter of this object; returns the decremented value. More...
 

Protected Types

enum  AnimationState { AnimationState_Started, AnimationState_Stopped, AnimationState_Paused }
 Defines animation state. More...
 

Protected Member Functions

virtual void updateWithChildren (const AIS_AnimationProgress &thePosition)
 Process one step of the animation according to the input time progress, including all children. Calls also ::update() to update own animation. More...
 
virtual void update (const AIS_AnimationProgress &theProgress)
 Update the own animation to specified position - should be overridden by sub-class. More...
 

Protected Attributes

Handle< AIS_AnimationTimermyTimer
 
TCollection_AsciiString myName
 animation name More...
 
NCollection_Sequence< Handle< AIS_Animation > > myAnimations
 sequence of child animations More...
 
AnimationState myState
 animation state - started, stopped of paused More...
 
Standard_Real myPtsStart
 time of start in the timeline More...
 
Standard_Real myOwnDuration
 duration of animation excluding children More...
 
Standard_Real myChildrenDuration
 duration of animation including children More...
 

Additional Inherited Members

- Public Types inherited from Standard_Transient
typedef void base_type
 Returns a type descriptor about this object. More...
 
- Static Public Member Functions inherited from Standard_Transient
static const char * get_type_name ()
 Returns a type descriptor about this object. More...
 
static const opencascade::handle< Standard_Type > & get_type_descriptor ()
 Returns type descriptor of Standard_Transient class. More...
 

Detailed Description

Class represents single animation. It is defined with:

Member Enumeration Documentation

Defines animation state.

Enumerator
AnimationState_Started 

animation is in progress

AnimationState_Stopped 

animation is finished, force stopped or not started

AnimationState_Paused 

animation is paused and can be started from the pause moment

Constructor & Destructor Documentation

AIS_Animation::AIS_Animation ( const TCollection_AsciiString theAnimationName)

Creates empty animation.

virtual AIS_Animation::~AIS_Animation ( )
virtual

Destruct object, clear arguments.

Member Function Documentation

void AIS_Animation::Add ( const Handle< AIS_Animation > &  theAnimation)

Add single animation to the timeline.

Parameters
theAnimationinput animation
const NCollection_Sequence<Handle< AIS_Animation > >& AIS_Animation::Children ( ) const
inline

Return sequence of child animations.

void AIS_Animation::Clear ( )

Clear animation timeline - remove all animations from it.

void AIS_Animation::CopyFrom ( const Handle< AIS_Animation > &  theOther)

Clears own children and then copy child animations from another object. Copy also Start Time and Duration values.

Standard_Real AIS_Animation::Duration ( ) const
inline
Returns
duration of the animation in the timeline
Standard_Real AIS_Animation::ElapsedTime ( ) const
inline

Return elapsed time.

Handle< AIS_Animation > AIS_Animation::Find ( const TCollection_AsciiString theAnimationName) const

Return the child animation with the given name.

Standard_Boolean AIS_Animation::HasOwnDuration ( ) const
inline

Return true if duration is defined.

bool AIS_Animation::IsStopped ( )
inline

Check if animation is to be performed in the animation timeline.

Returns
True if it is stopped of finished.
const TCollection_AsciiString& AIS_Animation::Name ( ) const
inline

Animation name.

Standard_Real AIS_Animation::OwnDuration ( ) const
inline
Returns
own duration of the animation in the timeline
virtual void AIS_Animation::Pause ( )
virtual

Pause the process timeline.

Standard_Boolean AIS_Animation::Remove ( const Handle< AIS_Animation > &  theAnimation)

Remove the child animation.

Standard_Boolean AIS_Animation::Replace ( const Handle< AIS_Animation > &  theAnimationOld,
const Handle< AIS_Animation > &  theAnimationNew 
)

Replace the child animation.

void AIS_Animation::SetOwnDuration ( const Standard_Real  theDuration)
inline

Defines duration of the animation.

void AIS_Animation::SetStartPts ( const Standard_Real  thePtsStart)
inline

Sets time limits for animation in the animation timeline.

virtual void AIS_Animation::Start ( const Standard_Boolean  theToUpdate)
virtual

Start animation. This method changes status of the animation to Started. This status defines whether animation is to be performed in the timeline or not.

Parameters
theToUpdatecall Update() method
Standard_Real AIS_Animation::StartPts ( ) const
inline
Returns
start time of the animation in the timeline
virtual void AIS_Animation::StartTimer ( const Standard_Real  theStartPts,
const Standard_Real  thePlaySpeed,
const Standard_Boolean  theToUpdate,
const Standard_Boolean  theToStopTimer = Standard_False 
)
virtual

Start animation with internally defined timer instance. Calls ::Start() internally.

Parameters
theStartPtsstarting timer position (presentation timestamp)
thePlaySpeedplayback speed (1.0 means normal speed)
theToUpdateflag to update defined animations to specified start position
theToStopTimerflag to pause timer at the starting position
virtual void AIS_Animation::Stop ( )
virtual

Stop animation. This method changed status of the animation to Stopped. This status shows that animation will not be performed in the timeline or it is finished.

virtual Standard_Boolean AIS_Animation::Update ( const Standard_Real  thePts)
virtual

Update single frame of animation, update timer state.

Parameters
thePts[in] the time moment within [0; Duration()]
Returns
True if timeline is in progress
virtual void AIS_Animation::update ( const AIS_AnimationProgress theProgress)
inlineprotectedvirtual

Update the own animation to specified position - should be overridden by sub-class.

Reimplemented in AIS_AnimationCamera, and AIS_AnimationObject.

virtual Standard_Real AIS_Animation::UpdateTimer ( )
virtual

Update single frame of animation, update timer state.

Returns
current time of timeline progress.
void AIS_Animation::UpdateTotalDuration ( )

Update total duration considering all animations on timeline.

virtual void AIS_Animation::updateWithChildren ( const AIS_AnimationProgress thePosition)
protectedvirtual

Process one step of the animation according to the input time progress, including all children. Calls also ::update() to update own animation.

Field Documentation

NCollection_Sequence<Handle< AIS_Animation > > AIS_Animation::myAnimations
protected

sequence of child animations

Standard_Real AIS_Animation::myChildrenDuration
protected

duration of animation including children

TCollection_AsciiString AIS_Animation::myName
protected

animation name

Standard_Real AIS_Animation::myOwnDuration
protected

duration of animation excluding children

Standard_Real AIS_Animation::myPtsStart
protected

time of start in the timeline

AnimationState AIS_Animation::myState
protected

animation state - started, stopped of paused

Handle< AIS_AnimationTimer > AIS_Animation::myTimer
protected

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