Named property class. More...

#include <ilviews/util/animator.h>

Inheritance diagram for IlvAnimator:

Public Types
enum	IlvAnimationMode { IlvAnimationNone, IlvAnimationForward, IlvAnimationBackward, IlvAnimationForwardOnce, IlvAnimationBackwardOnce }
	This enumeration defines the possible values for the animation mode of an `IlvAnimator` object. More...

Public Member Functions
	IlvAnimator (IlSymbol *name, IlvAnimationMode mode=IlvAnimationForward, IlUInt period=100)
	Constructor. More...

virtual void	animate ()
	Called to animate the animator. More...

void	changeState (IlUInt state, IlBoolean redraw=IlTrue)
	Changes the animator state. More...

IlvAnimationMode	getAnimationMode () const
	Returns the animation mode of the animator. More...

IlUInt	getPeriod () const
	Returns the animation period of the animator. More...

IlUInt	getState () const
	Returns the animator state. More...

virtual IlUInt	getStatesCount () const =0
	Returns the number of states of the animator. More...

virtual void	initReDraws () const =0
	Called to begin a redraw session. More...

virtual void	invalidateRegion () const =0
	Called to invalidate the area affected by the animator. More...

virtual IlBoolean	isLastState (IlUInt state) const
	Returns a Boolean value indicating whether the specified state is the last one. More...

virtual IlUInt	nextState (IlUInt state) const
	Returns the animator state that must be set after a given state. More...

virtual void	reDraw () const
	Called to redraw the animator. More...

virtual void	reDrawViews () const =0
	Called to finish a redraw session. More...

void	setAnimationMode (IlvAnimationMode mode)
	Sets the animation mode of the animator. More...

void	setAnimationMode (IlvAnimationMode mode, IlUInt period)
	Sets the animation mode and the period of the animator. More...

void	setState (IlUInt state)
	Sets the animator state. More...

virtual void	stateChanged (IlUInt newState, IlUInt oldState)
	Called by `IlvAnimator::changeState` each time the animator state changes. More...

Public Member Functions inherited from IlvNamedProperty
	IlvNamedProperty (IlSymbol *)
	Constructor. More...

	IlvNamedProperty (const IlvNamedProperty &source)
	Constructor. More...

IlvNamedProperty *	copy () const =0
	Copies the property. More...

const char *	getName () const
	Gets the name of the property. More...

IlSymbol *	getSymbol () const
	Gets the name of the property. More...

virtual IlBoolean	isPersistent () const
	Specifies whether the property must save itself. More...

void	write (IlvOutputFile &stream) const =0
	Saves the description of the property. More...

Public Member Functions inherited from IlvValueInterface
virtual IlBoolean	applyValue (const IlvValue &value)
	Apply an accessor. More...

virtual IlBoolean	changeValue (const IlvValue &val)
	Changes the value of an accessor. More...

virtual IlBoolean	changeValues (const IlvValue *values, IlUShort count=0)
	Changes several accessor values simultaneously. More...

virtual void	getAccessors (const IlSymbol const names, const IlvValueTypeClass const **types, IlUInt &count) const
	Retrieves the list of available accessors of an object. More...

virtual IlvValue &	queryValue (IlvValue &val) const
	Retrieves an accessor value. More...

virtual void	queryValues (IlvValue *values, IlUShort count) const
	Retrieves multiple accessor values simultaneously. More...

Additional Inherited Members
Public Attributes inherited from IlvNamedProperty
IlvNamedProperty *IlvInputFile &	stream
	Reads an instance of the property class. More...

Detailed Description

Named property class.

Library: views

IlvAnimator is a subclass of IlvNamedProperty that deals with animation. You can use it to animate any object that can be connected to a named property (IlvGraphic, IlvGadgetItem, IlvPane, IlvNotebookPage). Once started the animator calls the virtual method IlvAnimator::animate to animate the object.

See also: IlvBitmapAnimator, IlvGraphicAnimator

Member Enumeration Documentation

§ IlvAnimationMode

enum IlvAnimator::IlvAnimationMode

This enumeration defines the possible values for the animation mode of an IlvAnimator object.

See also: IlvAnimator::setAnimationMode()

Enumerator
IlvAnimationNone	The animator is stopped
IlvAnimationForward	The animator is running forward, and loops once it has reached the last state of the animator
IlvAnimationBackward	The animator is running backward, and loops once it has reached the first state of the animator
IlvAnimationForwardOnce	The animator is running forward, and stops once it has reached the last state of the animator.
IlvAnimationBackwardOnce	The animator is running backward, and stops once it has reached the first state of the animator

Constructor & Destructor Documentation

§ IlvAnimator()

IlvAnimator::IlvAnimator	(	IlSymbol *	name,
		IlvAnimationMode	mode = `IlvAnimationForward`,
		IlUInt	period = `100`
	)

Constructor.

Initializes a new instance of the IlvAnimator class. The animator will start when it is connected to any object.

Parameters

name	The animator name.
mode	The animation mode.
period	The animator period.

Member Function Documentation

§ animate()

virtual void IlvAnimator::animate ( )

virtual

Called to animate the animator.

The default implementation calls IlvAnimator::changeState with the result of IlvAnimator::nextState as new state, and with redraw set to IlTrue.

See also: getState(), nextState(), setState(), changeState()

Reimplemented in IlvGraphicAnimator.

§ changeState()

void IlvAnimator::changeState	(	IlUInt	state,
		IlBoolean	redraw = `IlTrue`
	)

Changes the animator state.

This method calls IlvAnimator::setState to change the state, and then calls IlvAnimator::stateChanged.

Parameters

state	The new animator state.
redraw	A Boolean specifying whether the animator should be redrawn.

See also: getState(), nextState(), setState(), reDrawViews()

§ getAnimationMode()

IlvAnimationMode IlvAnimator::getAnimationMode ( ) const

Returns the animation mode of the animator.

Returns: The animation mode.

See also: setAnimationMode(IlvAnimationMode), setAnimationMode(IlvAnimationMode, IlUInt)

§ getPeriod()

IlUInt IlvAnimator::getPeriod ( ) const

Returns the animation period of the animator.

The animation period is the period between two calls TO the IlvAnimator::animate method.

Returns: The animation period.

See also: IlvAnimator::setAnimationMode(IlvAnimationMode, IlUInt)

§ getState()

IlUInt IlvAnimator::getState ( ) const

Returns the animator state.

The animator state is a value that represents the state of the animator. The default value is 0.

Returns: The animator state.

See also: setState(), nextState(), changeState()

§ getStatesCount()

virtual IlUInt IlvAnimator::getStatesCount ( ) const

pure virtual

Returns the number of states of the animator.

You must redefine this method in a subclass.

Returns: The number of states of the animator.

See also: nextState(), changeState()

Implemented in IlvBitmapAnimator.

§ initReDraws()

virtual void IlvAnimator::initReDraws ( ) const

pure virtual

Called to begin a redraw session.

You must redefine this method in a subclass.

See also: reDraw(), invalidateRegion(), reDrawViews()

Implemented in IlvGraphicAnimator.

§ invalidateRegion()

virtual void IlvAnimator::invalidateRegion ( ) const

pure virtual

Called to invalidate the area affected by the animator.

You must redefine this method in a subclass.

See also: reDraw(), initReDraws(), reDrawViews()

Implemented in IlvGraphicAnimator.

§ isLastState()

virtual IlBoolean IlvAnimator::isLastState ( IlUInt state ) const

virtual

Returns a Boolean value indicating whether the specified state is the last one.

The default implementation compares state to the result of IlvAnimator::getStatesCount(). You can override this function in your own subclass if you do not know the total number of states that the animator has.

Parameters

state The state.

Returns: A Boolean value indicating whether the state is the last state.

See also: getStatesCount(), nextState(), changeState()

Reimplemented in IlvBitmapAnimator.

§ nextState()

virtual IlUInt IlvAnimator::nextState ( IlUInt state ) const

virtual

Returns the animator state that must be set after a given state.

The default implementation uses the animation mode to increment (IlvAnimationForward) or decrement (IlvAnimationBackward) the state. You may override this method to implement your own state automate.

Parameters

state The animator state.

Returns: The animator state that must be set after state. If IlvBadIndex is returned, the animator stops.

See also: animate(), changeState()

§ reDraw()

virtual void IlvAnimator::reDraw ( ) const

virtual

Called to redraw the animator.

The default implementation calls IlvAnimator::initReDraws(), then IlvAnimator::invalidateRegion(), and finally reDrawViews().

See also: initReDraws(), invalidateRegion(), reDrawViews()

§ reDrawViews()

virtual void IlvAnimator::reDrawViews ( ) const

pure virtual

Called to finish a redraw session.

You must redefine this method in a subclass.

See also: reDraw(), initReDraws(), invalidateRegion()

Implemented in IlvGraphicAnimator.

§ setAnimationMode() [1/2]

void IlvAnimator::setAnimationMode ( IlvAnimationMode mode )

Sets the animation mode of the animator.

This method does not change the animation period.

Parameters

mode	The new animation mode.

See also: getAnimationMode() setAnimationMode(IlvAnimationMode, IlUInt)

§ setAnimationMode() [2/2]

void IlvAnimator::setAnimationMode	(	IlvAnimationMode	mode,
		IlUInt	period
	)

Sets the animation mode and the period of the animator.

Parameters

mode	The new animation mode.
period	The new animation period.

See also: getAnimationMode(), setAnimationMode(IlvAnimationMode)

§ setState()

void IlvAnimator::setState ( IlUInt state )

Sets the animator state.

This method does not call any other method.

Parameters

state The new animator state.

See also: getState(), nextState(), changeState()

§ stateChanged()

virtual void IlvAnimator::stateChanged	(	IlUInt	newState,
		IlUInt	oldState
	)

virtual

Called by IlvAnimator::changeState each time the animator state changes.

The default implementation does nothing.

Parameters

newState	The new animator state.
oldState	The previous animator state.

See also: getState(), nextState(), changeState()

Reimplemented in IlvGraphicAnimator, and IlvBitmapAnimator.

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

§ IlvAnimationMode

Constructor & Destructor Documentation

§ IlvAnimator()

Member Function Documentation

§ animate()

§ changeState()

§ getAnimationMode()

§ getPeriod()

§ getState()

§ getStatesCount()

§ initReDraws()

§ invalidateRegion()

§ isLastState()

§ nextState()

§ reDraw()

§ reDrawViews()

§ setAnimationMode() [1/2]

§ setAnimationMode() [2/2]

§ setState()

§ stateChanged()