/* ScummVM - Graphic Adventure Engine
*
* ScummVM is the legal property of its developers, whose names
* are too numerous to list here. Please refer to the COPYRIGHT
* file distributed with this source distribution.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*
*/
#include "draci/draci.h"
#include "draci/animation.h"
#include "draci/barchive.h"
#include "draci/game.h"
#include "draci/screen.h"
#include "draci/sound.h"
#include "draci/surface.h"
#include "common/memstream.h"
#include "common/system.h"
namespace Draci {
Animation::Animation(DraciEngine *vm, int id, uint z, bool playing) : _vm(vm) {
_id = id;
_index = kIgnoreIndex;
_z = z;
clearShift();
_displacement = kNoDisplacement;
_playing = playing;
_looping = false;
_paused = false;
_canBeQuick = false;
_tick = _vm->_system->getMillis();
_currentFrame = 0;
_hasChangedFrame = true;
_callback = &Animation::doNothing;
_isRelative = false;
}
Animation::~Animation() {
deleteFrames();
}
void Animation::setRelative(int relx, int rely) {
// Delete the previous frame if there is one
if (_frames.size() > 0)
markDirtyRect(_vm->_screen->getSurface());
_displacement.relX = relx;
_displacement.relY = rely;
}
Displacement Animation::getCurrentFrameDisplacement() const {
Displacement dis = _displacement;
dis.relX += lround(dis.extraScaleX * _shift.x);
dis.relY += lround(dis.extraScaleY * _shift.y);
return dis;
}
Common::Point Animation::getCurrentFramePosition() const {
Displacement dis = getCurrentFrameDisplacement();
return Common::Point(dis.relX, dis.relY);
}
void Animation::setLooping(bool looping) {
_looping = looping;
debugC(7, kDraciAnimationDebugLevel, "Setting looping to %d on animation %d",
looping, _id);
}
void Animation::markDirtyRect(Surface *surface) const {
if (getFrameCount() == 0)
return;
// Fetch the current frame's rectangle
const Drawable *frame = getConstCurrentFrame();
Common::Rect frameRect = frame->getRect(getCurrentFrameDisplacement());
// Mark the rectangle dirty on the surface
surface->markDirtyRect(frameRect);
}
void Animation::nextFrame(bool force) {
// If there are no frames or if the animation is not playing, return
if (getFrameCount() == 0 || !_playing)
return;
const Drawable *frame = getConstCurrentFrame();
Surface *surface = _vm->_screen->getSurface();
if (force || (_tick + frame->getDelay() <= _vm->_system->getMillis()) ||
(_canBeQuick && _vm->_game->getEnableQuickHero() && _vm->_game->getWantQuickHero())) {
// If we are at the last frame and not looping, stop the animation
// The animation is also restarted to frame zero
if ((_currentFrame == getFrameCount() - 1) && !_looping) {
// When the animation reaches its end, call the preset callback
(this->*_callback)();
} else {
// Mark old frame dirty so it gets deleted
markDirtyRect(surface);
_shift.x += _relativeShifts[_currentFrame].x;
_shift.y += _relativeShifts[_currentFrame].y;
_currentFrame = nextFrameNum();
_tick = _vm->_system->getMillis();
// Fetch new frame and mark it dirty
markDirtyRect(surface);
// If the animation is paused, then nextFrameNum()
// returns the same frame number even though the time
// has elapsed to switch to another frame. We must not
// flip _hasChangedFrame to true, otherwise the sample
// assigned to this frame will be re-started over and
// over until all sound handles are exhausted (happens,
// e.g., when switching to the inventory which pauses
// all animations).
_hasChangedFrame = !_paused;
}
}
debugC(6, kDraciAnimationDebugLevel,
"anim=%d tick=%d delay=%d tick+delay=%d currenttime=%d frame=%d framenum=%d x=%d y=%d z=%d",
_id, _tick, frame->getDelay(), _tick + frame->getDelay(), _vm->_system->getMillis(),
_currentFrame, _frames.size(), frame->getX() + getRelativeX(), frame->getY() + getRelativeY(), _z);
}
uint Animation::nextFrameNum() const {
if (_paused)
return _currentFrame;
if ((_currentFrame == getFrameCount() - 1) && _looping)
return 0;
else
return _currentFrame + 1;
}
void Animation::drawFrame(Surface *surface) {
// If there are no frames or the animation is not playing, return
if (_frames.size() == 0 || !_playing)
return;
const Drawable *frame = getConstCurrentFrame();
if (_id == kOverlayImage) {
// No displacement or relative animations is supported.
frame->draw(surface, false, 0, 0);
} else {
// Draw frame: first shifted by the relative shift and then
// scaled/shifted by the given displacement.
frame->drawReScaled(surface, false, getCurrentFrameDisplacement());
}
const SoundSample *sample = _samples[_currentFrame];
if (_hasChangedFrame && sample) {
uint duration = _vm->_sound->playSound(sample, Audio::Mixer::kMaxChannelVolume, false);
debugC(3, kDraciSoundDebugLevel,
"Playing sample on animation %d, frame %d: %d+%d at %dHz: %dms",
_id, _currentFrame, sample->_offset, sample->_length, sample->_frequency, duration);
}
_hasChangedFrame = false;
}
void Animation::setPlaying(bool playing) {
_tick = _vm->_system->getMillis();
_playing = playing;
// When restarting an animation, allow playing sounds.
_hasChangedFrame |= playing;
}
void Animation::setScaleFactors(double scaleX, double scaleY) {
debugC(5, kDraciAnimationDebugLevel,
"Setting scaling factors on anim %d (scaleX: %.3f scaleY: %.3f)",
_id, scaleX, scaleY);
markDirtyRect(_vm->_screen->getSurface());
_displacement.extraScaleX = scaleX;
_displacement.extraScaleY = scaleY;
}
void Animation::addFrame(Drawable *frame, const SoundSample *sample) {
_frames.push_back(frame);
_samples.push_back(sample);
_relativeShifts.push_back(Common::Point(0, 0));
}
void Animation::makeLastFrameRelative(int x, int y) {
_relativeShifts.back() = Common::Point(x, y);
}
void Animation::clearShift() {
_shift = Common::Point(0, 0);
}
void Animation::replaceFrame(int i, Drawable *frame, const SoundSample *sample) {
_frames[i] = frame;
_samples[i] = sample;
}
const Drawable *Animation::getConstCurrentFrame() const {
// If there are no frames stored, return NULL
return _frames.size() > 0 ? _frames[_currentFrame] : NULL;
}
Drawable *Animation::getCurrentFrame() {
// If there are no frames stored, return NULL
return _frames.size() > 0 ? _frames[_currentFrame] : NULL;
}
Drawable *Animation::getFrame(int frameNum) {
// If there are no frames stored, return NULL
return _frames.size() > 0 ? _frames[frameNum] : NULL;
}
void Animation::setCurrentFrame(uint frame) {
// Check whether the value is sane
if (frame >= _frames.size()) {
return;
}
_currentFrame = frame;
}
void Animation::deleteFrames() {
// If there are no frames to delete, return
if (_frames.size() == 0) {
return;
}
markDirtyRect(_vm->_screen->getSurface());
for (int i = getFrameCount() - 1; i >= 0; --i) {
delete _frames[i];
_frames.pop_back();
}
_relativeShifts.clear();
_samples.clear();
}
void Animation::exitGameLoop() {
_vm->_game->setExitLoop(true);
}
void Animation::tellWalkingState() {
_vm->_game->heroAnimationFinished();
}
void Animation::play() {
if (isPlaying()) {
return;
}
// Mark the first frame dirty so it gets displayed
markDirtyRect(_vm->_screen->getSurface());
setPlaying(true);
debugC(3, kDraciAnimationDebugLevel, "Playing animation %d...", getID());
}
void Animation::stop() {
if (!isPlaying()) {
return;
}
// Clean up the last frame that was drawn before stopping
markDirtyRect(_vm->_screen->getSurface());
setPlaying(false);
// Reset the animation to the beginning
setCurrentFrame(0);
clearShift();
debugC(3, kDraciAnimationDebugLevel, "Stopping animation %d...", getID());
}
void Animation::del() {
_vm->_anims->deleteAnimation(this);
}
void AnimationManager::pauseAnimations() {
if (_animationPauseCounter++) {
// Already paused
return;
}
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->getID() > 0 || (*it)->getID() == kTitleText) {
// Clean up the last frame that was drawn before stopping
(*it)->markDirtyRect(_vm->_screen->getSurface());
(*it)->setPaused(true);
}
}
}
void AnimationManager::unpauseAnimations() {
if (--_animationPauseCounter) {
// Still paused
return;
}
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->isPaused()) {
// Clean up the last frame that was drawn before stopping
(*it)->markDirtyRect(_vm->_screen->getSurface());
(*it)->setPaused(false);
}
}
}
Animation *AnimationManager::getAnimation(int id) {
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->getID() == id) {
return *it;
}
}
return nullptr;
}
void AnimationManager::insert(Animation *anim, bool allocateIndex) {
if (allocateIndex)
anim->setIndex(++_lastIndex);
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if (anim->getZ() < (*it)->getZ())
break;
}
_animations.insert(it, anim);
}
void AnimationManager::drawScene(Surface *surf) {
// Fill the screen with color zero since some rooms may rely on the screen being black
_vm->_screen->getSurface()->fill(0);
sortAnimations();
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if (! ((*it)->isPlaying()) ) {
continue;
}
(*it)->nextFrame(false);
(*it)->drawFrame(surf);
}
}
void AnimationManager::sortAnimations() {
Common::List::iterator cur;
Common::List::iterator next;
cur = _animations.begin();
// If the list is empty, we're done
if (cur == _animations.end())
return;
bool hasChanged;
do {
hasChanged = false;
cur = _animations.begin();
next = cur;
while (true) {
next++;
// If we are at the last element, we're done
if (next == _animations.end())
break;
// If we find an animation out of order, reinsert it
if ((*next)->getZ() < (*cur)->getZ()) {
Animation *anim = *next;
next = _animations.reverse_erase(next);
insert(anim, false);
hasChanged = true;
}
// Advance to next animation
cur = next;
}
} while (hasChanged);
}
void AnimationManager::deleteAnimation(Animation *anim) {
if (!anim) {
return;
}
Common::List::iterator it;
int index = -1;
// Iterate for the first time to delete the animation
for (it = _animations.begin(); it != _animations.end(); ++it) {
if (*it == anim) {
// Remember index of the deleted animation
index = (*it)->getIndex();
debugC(3, kDraciAnimationDebugLevel, "Deleting animation %d...", anim->getID());
delete *it;
_animations.erase(it);
break;
}
}
// Iterate the second time to decrease indexes greater than the deleted animation index
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->getIndex() > index && (*it)->getIndex() != kIgnoreIndex) {
(*it)->setIndex((*it)->getIndex() - 1);
}
}
// Decrement index of last animation
_lastIndex -= 1;
}
void AnimationManager::deleteOverlays() {
debugC(3, kDraciAnimationDebugLevel, "Deleting overlays...");
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->getID() == kOverlayImage) {
delete *it;
it = _animations.reverse_erase(it);
}
}
}
void AnimationManager::deleteAll() {
debugC(3, kDraciAnimationDebugLevel, "Deleting all animations...");
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
delete *it;
}
_animations.clear();
_lastIndex = -1;
}
void AnimationManager::deleteAfterIndex(int index) {
Common::List::iterator it;
for (it = _animations.begin(); it != _animations.end(); ++it) {
if ((*it)->getIndex() > index) {
debugC(3, kDraciAnimationDebugLevel, "Deleting animation %d...", (*it)->getID());
delete *it;
it = _animations.reverse_erase(it);
}
}
_lastIndex = index;
}
const Animation *AnimationManager::getTopAnimation(int x, int y) const {
Common::List::const_iterator it;
Animation *retval = nullptr;
// Get transparent color for the current screen
const int transparent = _vm->_screen->getSurface()->getTransparentColor();
for (it = _animations.reverse_begin(); it != _animations.end(); --it) {
Animation *anim = *it;
// If the animation is not playing, ignore it
if (!anim->isPlaying() || anim->isPaused()) {
continue;
}
const Drawable *frame = anim->getConstCurrentFrame();
if (frame == nullptr) {
continue;
}
bool matches = false;
if (frame->getRect(anim->getCurrentFrameDisplacement()).contains(x, y)) {
if (frame->getType() == kDrawableText) {
matches = true;
} else if (frame->getType() == kDrawableSprite &&
reinterpret_cast(frame)->getPixel(x, y, anim->getCurrentFrameDisplacement()) != transparent) {
matches = true;
}
}
// Return the top-most animation object, unless it is a
// non-clickable sprite (overlay, debugging sprites for
// walking, or title/speech text) and there is an actual object
// underneath it.
if (matches) {
if (anim->getID() > kOverlayImage || anim->getID() < kSpeechText) {
return anim;
} else if (retval == nullptr) {
retval = anim;
}
}
}
// The default return value if no animations were found on these coordinates (not even overlays)
return retval;
}
Animation *AnimationManager::load(uint animNum) {
// Make double-sure that an animation isn't loaded more than twice,
// otherwise horrible things happen in the AnimationManager, because
// they use a simple link-list without duplicate checking. This should
// never happen unless there is a bug in the game, because all GPL2
// commands are guarded.
assert(!getAnimation(animNum));
const BAFile *animFile = _vm->_animationsArchive->getFile(animNum);
Common::MemoryReadStream animationReader(animFile->_data, animFile->_length);
uint numFrames = animationReader.readByte();
// The following two flags are ignored by the played. Memory logic was
// a hint to the old player whether it should cache the sprites or load
// them on demand. We have 1 memory manager and ignore these hints.
animationReader.readByte();
// The disable erasing field is just a (poor) optimization flag that
// turns of drawing the background underneath the sprite. By reading
// the source code of the old player, I'm not sure if that would ever
// have worked. There are only 6 animations in the game with this flag
// true. All of them have just 1 animation phase and they are used to
// patch a part of the original background by a new sprite. This
// should work with the default logic as well---just play this
// animation on top of the background. Since the only meaning of the
// flag was optimization, ignoring should be OK even without dipping
// into details.
animationReader.readByte();
const bool cyclic = animationReader.readByte();
const bool relative = animationReader.readByte();
Animation *anim = new Animation(_vm, animNum, 0, false);
insert(anim, true);
anim->setLooping(cyclic);
anim->setIsRelative(relative);
for (uint i = 0; i < numFrames; ++i) {
uint spriteNum = animationReader.readUint16LE() - 1;
int x = animationReader.readSint16LE();
int y = animationReader.readSint16LE();
uint scaledWidth = animationReader.readUint16LE();
uint scaledHeight = animationReader.readUint16LE();
byte mirror = animationReader.readByte();
int sample = animationReader.readUint16LE() - 1;
uint freq = animationReader.readUint16LE();
uint delay = animationReader.readUint16LE();
// _spritesArchive is flushed when entering a room. All
// scripts in a room are responsible for loading their animations.
const BAFile *spriteFile = _vm->_spritesArchive->getFile(spriteNum);
Sprite *sp = new Sprite(spriteFile->_data, spriteFile->_length,
relative ? 0 : x, relative ? 0 : y, true);
// Some frames set the scaled dimensions to 0 even though other frames
// from the same animations have them set to normal values
// We work around this by assuming it means no scaling is necessary
if (scaledWidth == 0) {
scaledWidth = sp->getWidth();
}
if (scaledHeight == 0) {
scaledHeight = sp->getHeight();
}
sp->setScaled(scaledWidth, scaledHeight);
if (mirror)
sp->setMirrorOn();
sp->setDelay(delay * 10);
anim->addFrame(sp, _vm->_soundsArchive->getSample(sample, freq));
if (relative) {
anim->makeLastFrameRelative(x, y);
}
}
return anim;
}
} // End of namespace Draci