Gamedev Framework (gf)
0.6.0
A C++11 framework for 2D games
include
gf
Animation.h
1
/*
2
* Gamedev Framework (gf)
3
* Copyright (C) 2016-2017 Julien Bernard
4
*
5
* This software is provided 'as-is', without any express or implied
6
* warranty. In no event will the authors be held liable for any damages
7
* arising from the use of this software.
8
*
9
* Permission is granted to anyone to use this software for any purpose,
10
* including commercial applications, and to alter it and redistribute it
11
* freely, subject to the following restrictions:
12
*
13
* 1. The origin of this software must not be misrepresented; you must not
14
* claim that you wrote the original software. If you use this software
15
* in a product, an acknowledgment in the product documentation would be
16
* appreciated but is not required.
17
* 2. Altered source versions must be plainly marked as such, and must not be
18
* misrepresented as being the original software.
19
* 3. This notice may not be removed or altered from any source distribution.
20
*/
21
#
ifndef
GF_ANIMATION_H
22
#
define
GF_ANIMATION_H
23
24
#
include
<
cstddef
>
25
#
include
<
vector
>
26
27
#
include
"Portability.h"
28
#
include
"Rect.h"
29
#
include
"Time.h"
30
31
namespace
gf
{
32
#
ifndef
DOXYGEN_SHOULD_SKIP_THIS
33
inline
namespace
v1 {
34
#
endif
35
36
class
Texture
;
37
38
/**
39
* @ingroup graphics
40
* @brief An animation
41
*
42
* An animation is a collection of frames that are displayed
43
* consecutively during a predefined amount of time.
44
*
45
* To display an animation, you need a gf::AnimatedSprite.
46
*
47
* @sa gf::AnimatedSprite
48
*/
49
class
GF_API
Animation
{
50
public
:
51
/**
52
* @brief Default constructor
53
*/
54
Animation
();
55
56
/**
57
* @brief Add a frame to the animation
58
*
59
* The frame of an animation is defined by the texture of the frame, the
60
* texture rectangle (in texture coordinates) and an amount of time.
61
*
62
* @param texture The texture where the sprite is
63
* @param bounds The texture rectangle where the sprite is
64
* @param duration The amount of time to display the frame
65
*/
66
void
addFrame
(
const
Texture
& texture,
const
RectF& bounds,
Time
duration);
67
68
/**
69
* @brief Get the current texture
70
*
71
* @return The current texture
72
* @throw std::runtime_error If the animation is empty
73
*/
74
const
Texture
&
getCurrentTexture
()
const
;
75
76
/**
77
* @brief Get the current texture rectangle
78
*
79
* @return The current texture rectangle
80
* @throw std::runtime_error If the animation is empty
81
*/
82
RectF
getCurrentBounds
()
const
;
83
84
/**
85
* @brief Update the state of the animation
86
*
87
* @param time The time since the last update
88
* @return True if the current frame has changed
89
*/
90
bool
update
(
Time
time);
91
92
private
:
93
struct
Frame {
94
const
Texture
*texture;
95
RectF bounds;
96
Time
duration;
97
};
98
99
std::size_t m_currentFrame;
100
Time
m_currentDurationInFrame;
101
std::vector<Frame> m_frames;
102
};
103
104
#
ifndef
DOXYGEN_SHOULD_SKIP_THIS
105
}
106
#
endif
107
}
108
109
#
endif
// GF_ANIMATION_H
gf::Animation::update
bool update(Time time)
Update the state of the animation.
gf::Time
Represents a time value.
Definition:
Time.h:73
gf::Texture
A texture for colored images.
Definition:
Texture.h:339
gf::Animation::Animation
Animation()
Default constructor.
gf
The namespace for gf classes.
Definition:
Action.h:34
gf::Animation::getCurrentTexture
const Texture & getCurrentTexture() const
Get the current texture.
GF_API
#define GF_API
Definition:
Portability.h:35
gf::Animation
An animation.
Definition:
Animation.h:49
gf::Animation::addFrame
void addFrame(const Texture &texture, const RectF &bounds, Time duration)
Add a frame to the animation.
gf::Animation::getCurrentBounds
RectF getCurrentBounds() const
Get the current texture rectangle.
Generated by
1.8.13