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

#include <AIS_Animation.hxx>

Inheritance diagram for AIS_Animation:

Public Member Functions
	AIS_Animation (const TCollection_AsciiString &theAnimationName)
	Creates empty animation. More...

virtual	~AIS_Animation ()
	Destruct object, clear arguments. More...

const TCollection_AsciiString &	Name () 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_Animation >	Find (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_Transient &	operator= (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_Transient *	This () 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_AnimationTimer >	myTimer

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:

Start time on the timeline started from 0, in seconds
Duration, in seconds
virtual method Update() for handling an update

Member Enumeration Documentation

enum AIS_Animation::AnimationState

protected

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

theAnimation input 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

theToUpdate call 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

theStartPts	starting timer position (presentation timestamp)
thePlaySpeed	playback speed (1.0 means normal speed)
theToUpdate	flag to update defined animations to specified start position
theToStopTimer	flag 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:

AIS_Animation.hxx

AIS_Animation Class Reference

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation