gf::Animation Class Reference

An animation. More...

#include <gf/Animation.h>

Public Member Functions
	Animation ()
	Default constructor. More...
void	addFrame (const Texture &texture, const RectF &bounds, Time duration)
	Add a frame to the animation. More...
void	addTileset (const Texture &texture, const Vector2f &frameSize, const Vector2i &layout, int nbFrames, Time duration)
	Add a entire tileset to the animation. More...
void	setLoop (bool enabled)
	Enable or disable the animation loop. More...
const Texture &	getCurrentTexture () const
	Get the current texture. More...
RectF	getCurrentBounds () const
	Get the current texture rectangle. More...
bool	update (Time time)
	Update the state of the animation. More...
void	reset ()
	Reset the animation. More...

Detailed Description

An animation.

An animation is a collection of frames that are displayed consecutively during a predefined amount of time.

To display an animation, you need a gf::AnimatedSprite.

See also

gf::AnimatedSprite

Constructor & Destructor Documentation

Animation()

gf::Animation::Animation

(

)

Default constructor.

Member Function Documentation

addFrame()

void gf::Animation::addFrame	(	const Texture &	texture,
		const RectF &	bounds,
		Time	duration
	)

Add a frame to the animation.

The frame of an animation is defined by the texture of the frame, the texture rectangle (in texture coordinates) and an amount of time.

Parameters

texture	The texture where the sprite is
bounds	The texture rectangle where the sprite is
duration	The amount of time to display the frame

addTileset()

void gf::Animation::addTileset	(	const Texture &	texture,
		const Vector2f &	frameSize,
		const Vector2i &	layout,
		int	nbFrames,
		Time	duration
	)

Add a entire tileset to the animation.

Take all frames of the entire tilset. Each frame is defined the texture rectangle (in texture coordinates) and an amount of time.

Parameters

texture	The texture where the sprite is
frameSize	The frame texture normalized size
layout	Layout of frames
nbFrames	Number of frames included in tileset
duration	The amount of time to display the frame

getCurrentBounds()

RectF gf::Animation::getCurrentBounds

(

)

const

Get the current texture rectangle.

Returns

The current texture rectangle

Exceptions

std::runtime_error

If the animation is empty

getCurrentTexture()

const Texture& gf::Animation::getCurrentTexture

(

)

const

Get the current texture.

Returns

The current texture

Exceptions

std::runtime_error

If the animation is empty

reset()

void gf::Animation::reset

(

)

Reset the animation.

setLoop()

void gf::Animation::setLoop

(

bool

enabled

)

Enable or disable the animation loop.

Parameters

enabled

True to enable the loop otherwise false

update()

bool gf::Animation::update

(

Time

time

)

Update the state of the animation.

Parameters

time	The time since the last update

Returns

True if the current frame has changed