22#ifndef HOLLYWOOD_MONSTERS_SCENES_ANIMATION_PLAYER_H
23#define HOLLYWOOD_MONSTERS_SCENES_ANIMATION_PLAYER_H
25#include "common/array.h"
26#include "common/types.h"
28#include "hollywood/monsters/scenes/animation_events.h"
36 firstFrame(newFirstFrame),
37 lastFrame(newLastFrame),
38 frameMillis(newFrameMillis),
40 waitAfterFinalFrame(
true),
43 repeatFirstFrame(
false),
44 heldFirstPlaybackFrame(0),
45 appendFirstFrame(
false),
46 appendedPlaybackFrame(0),
47 appendedTargetFrame(0) {
58 frameOrder = newFrameOrder;
67 waitAfterFinalFrame =
false;
73 repeatedFrame = frame;
78 if (!repeatFirstFrame) {
79 heldFirstPlaybackFrame = firstFrame;
81 repeatFirstFrame =
true;
87 firstFrame = newFirstFrame;
88 lastFrame = newLastFrame;
93 if (!appendFirstFrame && firstFrame <= lastFrame && lastFrame < 0xff) {
94 appendedTargetFrame = (byte)firstFrame;
95 appendedPlaybackFrame = ++lastFrame;
96 appendFirstFrame =
true;
101 byte targetFrame(uint playbackFrame)
const {
102 if (appendFirstFrame && playbackFrame == appendedPlaybackFrame)
103 return appendedTargetFrame;
104 if (frameOrder !=
nullptr)
105 return frameOrder[playbackFrame];
106 if (repeatedFrame >= 0)
107 return (
byte)repeatedFrame;
108 if (!repeatFirstFrame || playbackFrame <= heldFirstPlaybackFrame)
109 return (
byte)playbackFrame;
110 return (
byte)(playbackFrame - 1);
117 bool waitAfterFinalFrame;
118 const byte *frameOrder;
120 bool repeatFirstFrame;
121 uint heldFirstPlaybackFrame;
122 bool appendFirstFrame;
123 uint appendedPlaybackFrame;
124 byte appendedTargetFrame;
136 uint32 newFrameMillis) :
137 firstFrame(newFirstFrame),
138 lastFrame(newLastFrame),
139 finalFrame(newFinalFrame),
140 frameMillis(newFrameMillis),
170 virtual bool animationPlaybackShouldStop()
const = 0;
171 virtual void presentAnimationFrame() = 0;
172 virtual bool waitForAnimationFrame(uint32 millis,
bool allowSkip) = 0;
173 virtual bool consumeAnimationFastForwardRequest() {
return false; }
175 if (event.type == AnimationFrameEvent::kCustomHook)
176 handleAnimationFrameHook(event.hookId, frame);
178 virtual void handleAnimationFrameHook(
byte hookId, uint frame) {
186 class FrameValueTarget {
188 explicit FrameValueTarget(
byte &frame) : _frame(frame) {}
189 void setFrame(
byte frame) { _frame = frame; }
197 _delegate(delegate) {
201 FrameValueTarget target(targetFrame);
202 return playInternal(target, range,
true);
206 FrameValueTarget target(targetFrame);
207 return transitionInternal(target, transitionSpec,
true);
210 template<
class FrameTarget>
212 return playInternal(target, range,
false);
215 template<
class FrameTarget>
217 return playInternal(target, range,
true);
220 template<
class FrameTarget>
222 return transitionInternal(target, transitionSpec,
false);
225 template<
class FrameTarget>
226 bool transitionAndPresent(FrameTarget &target,
const AnimationTransition &transitionSpec) {
227 return transitionInternal(target, transitionSpec,
true);
231 template<
class FrameTarget>
233 bool presentBeforeWait) {
234 if (range.firstFrame > 0xff || range.lastFrame > 0xff)
237 const int step = range.firstFrame <= range.lastFrame ? 1 : -1;
238 for (
int frame = range.firstFrame;; frame += step) {
239 if (_delegate.animationPlaybackShouldStop())
242 target.setFrame(range.targetFrame(frame));
244 for (uint eventIndex = 0; eventIndex < events.
size(); ++eventIndex) {
245 if (events[eventIndex].matches(frame))
246 _delegate.handleAnimationFrameEvent(events[eventIndex], frame);
248 if (presentBeforeWait) {
249 _delegate.presentAnimationFrame();
250 if (_delegate.animationPlaybackShouldStop())
253 if (frame == (
int)range.lastFrame && !range.waitAfterFinalFrame)
255 if (_delegate.waitForAnimationFrame(range.frameMillis, range.allowSkip)) {
256 if (!_delegate.consumeAnimationFastForwardRequest())
259 for (
int remainingFrame = frame + step;
260 step > 0 ? remainingFrame <= (int)range.lastFrame :
261 remainingFrame >= (
int)range.lastFrame;
262 remainingFrame += step) {
263 target.setFrame(range.targetFrame(remainingFrame));
264 for (uint eventIndex = 0; eventIndex < events.
size(); ++eventIndex) {
265 if (events[eventIndex].matches(remainingFrame))
266 _delegate.handleAnimationFrameEvent(events[eventIndex], remainingFrame);
269 if (frame != (
int)range.lastFrame && presentBeforeWait)
270 _delegate.presentAnimationFrame();
271 return !_delegate.animationPlaybackShouldStop();
273 if (frame == (
int)range.lastFrame)
278 template<
class FrameTarget>
280 bool presentBoundaryFrames) {
281 if (transitionSpec.firstFrame > 0xff || transitionSpec.lastFrame > 0xff ||
282 _delegate.animationPlaybackShouldStop())
285 const int step = transitionSpec.firstFrame <= transitionSpec.lastFrame ? 1 : -1;
286 int frame = transitionSpec.firstFrame;
287 target.setFrame((
byte)frame);
288 if (presentBoundaryFrames) {
289 _delegate.presentAnimationFrame();
290 if (_delegate.animationPlaybackShouldStop())
294 while (frame != (
int)transitionSpec.lastFrame) {
295 if (_delegate.waitForAnimationFrame(transitionSpec.frameMillis, transitionSpec.allowSkip)) {
296 if (!_delegate.consumeAnimationFastForwardRequest())
301 target.setFrame((
byte)frame);
304 target.setFrame(transitionSpec.finalFrame);
305 if (presentBoundaryFrames) {
306 _delegate.presentAnimationFrame();
307 if (_delegate.animationPlaybackShouldStop())
size_type size() const
Definition: array.h:316
Definition: animation_events.h:140
Definition: animation_player.h:166
Definition: animation_player.h:184
Definition: animation_events.h:36
Definition: animation_player.h:34
Definition: animation_player.h:134