/* 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 .
*
*/
#ifndef QDENGINE_QDCORE_QD_ANIMATION_H
#define QDENGINE_QDCORE_QD_ANIMATION_H
#include "qdengine/parser/xml_fwd.h"
#include "qdengine/system/graphics/gr_screen_region.h"
#include "qdengine/system/graphics/gr_tile_animation.h"
#include "qdengine/qdcore/qd_resource.h"
#include "qdengine/qdcore/qd_animation_frame.h"
#include "qdengine/qdcore/qd_named_object.h"
namespace QDEngine {
class qdAnimationInfo;
const int QD_ANIMATION_FLAG_REFERENCE = 0x01;
const int QD_ANIMATION_FLAG_LOOP = 0x04;
const int QD_ANIMATION_FLAG_FLIP_HORIZONTAL = 0x08;
const int QD_ANIMATION_FLAG_FLIP_VERTICAL = 0x10;
const int QD_ANIMATION_FLAG_BLACK_FON = 0x20;
const int QD_ANIMATION_FLAG_SUPPRESS_ALPHA = 0x40;
const int QD_ANIMATION_FLAG_CROP = 0x80;
const int QD_ANIMATION_FLAG_COMPRESS = 0x100;
const int QD_ANIMATION_FLAG_TILE_COMPRESS = 0x200;
enum qdAnimationStatus {
QD_ANIMATION_STOPPED = 0,
QD_ANIMATION_PLAYING,
QD_ANIMATION_PAUSED,
QD_ANIMATION_END_PLAYING
};
//! Анимация.
class qdAnimation : public qdNamedObject, public qdResource {
public:
qdAnimation();
qdAnimation(const qdAnimation &anm);
~qdAnimation();
qdAnimation &operator = (const qdAnimation &anm);
int named_object_type() const {
return QD_NAMED_OBJECT_ANIMATION;
}
const qdAnimationFrame *get_cur_frame() const;
const qdAnimationFrame *get_cur_frame(float &scale) const;
qdAnimationFrame *get_cur_frame();
void set_cur_frame(int number);
int get_cur_frame_number() const;
qdAnimationFrame *get_frame(int number);
const qdAnimationFrame *get_scaled_frame(int number, int scale_index) const;
int num_frames() const {
return _num_frames;
}
float length() const {
return _length;
}
float cur_time() const {
return _cur_time;
}
void set_time(float tm) {
_cur_time = tm;
}
float cur_time_rel() const {
if (_length > 0.01f)
return _cur_time / _length;
return 0.0f;
}
void set_time_rel(float tm) {
if (tm < 0.0f) tm = 0.0f;
if (tm > 0.99f) tm = 0.99f;
_cur_time = _length * tm;
}
void advance_time(float tm);
void init_size();
int size_x() const {
return _sx;
}
int size_y() const {
return _sy;
}
int picture_size_x() const;
int picture_size_y() const;
bool is_playing() const {
return (_status == QD_ANIMATION_PLAYING ||
_status == QD_ANIMATION_END_PLAYING);
}
int status() const {
return _status;
}
bool is_finished() const {
return _is_finished;
}
bool need_stop() const {
return _status == QD_ANIMATION_END_PLAYING;
}
void start() {
_status = QD_ANIMATION_PLAYING;
_is_finished = false;
_cur_time = 0.0f;
}
void stop() {
_status = QD_ANIMATION_STOPPED;
_is_finished = true;
}
void pause() {
_status = QD_ANIMATION_PAUSED;
}
void resume() {
_status = QD_ANIMATION_PLAYING;
}
void quant(float dt);
void redraw(int x, int y, int z, int mode = 0) const;
void redraw(int x, int y, int z, float scale, int mode = 0) const;
void redraw_rot(int x, int y, int z, float angle, int mode = 0) const;
void redraw_rot(int x, int y, int z, float angle, const Vect2f &scale, int mode = 0) const;
void draw_mask(int x, int y, int z, uint32 mask_color, int mask_alpha, int mode = 0) const;
void draw_mask(int x, int y, int z, uint32 mask_color, int mask_alpha, float scale, int mode = 0) const;
void draw_mask_rot(int x, int y, int z, float angle, uint32 mask_color, int mask_alpha, int mode = 0) const;
void draw_mask_rot(int x, int y, int z, float angle, uint32 mask_color, int mask_alpha, const Vect2f &scale, int mode = 0) const;
void draw_contour(int x, int y, uint32 color) const;
void draw_contour(int x, int y, uint32 color, float scale) const;
bool hit(int x, int y) const;
bool hit(int x, int y, float scale) const;
bool add_frame(qdAnimationFrame *p, qdAnimationFrame *insert_pos = 0, bool insert_after = true);
bool remove_frame(int number);
bool remove_frame_range(int number0, int number1);
bool reverse_frame_range(int number0, int number1);
void load_script(const xml::tag *p);
bool save_script(Common::WriteStream &fh, int indent = 0) const;
const Common::Path qda_file() const {
return _qda_file;
}
void qda_set_file(const Common::Path &fname);
bool qda_load(const Common::Path &fname);
bool load_resources();
void free_resources();
bool scale(float coeff_x, float coeff_y);
bool crop();
bool undo_crop();
Vect2i remove_edges();
bool compress();
bool uncompress();
bool tileCompress(grTileCompressionMethod method = TILE_UNCOMPRESSED, int tolerance = 0);
qdAnimationFrameList &frames_list() {
return _frames;
};
void create_reference(qdAnimation *p, const qdAnimationInfo *inf = NULL) const;
bool is_reference(const qdAnimation *p) const {
if (p->check_flag(QD_ANIMATION_FLAG_REFERENCE) && p->_parent == this) return true;
return false;
}
void clear() {
stop();
_frames_ptr = &_frames;
_parent = NULL;
}
bool is_empty() const {
return (_frames_ptr->empty());
}
//! Возвращает область экрана, занимаемую анимацией.
/**
Координаты области - смещение от центра анимации.
В mode задаются повороты анимации по горизонтали и вертикали
(QD_ANIMATION_FLAG_FLIP_HORIZONTAL, QD_ANIMATION_FLAG_FLIP_VERTICAL)
*/
grScreenRegion screen_region(int mode = 0, float scale = 1.0f) const;
const qdAnimation *parent() const {
return _parent;
}
// qdResource
bool load_resource();
bool free_resource();
//! Устанавливает имя файла, в котором хранятся данные ресурса.
void set_resource_file(const Common::Path &file_name) {
qda_set_file(file_name);
}
//! Возвращает имя файла, в котором хранится анимация.
const Common::Path resource_file() const {
if (qda_file().empty()) {
if (!check_flag(QD_ANIMATION_FLAG_REFERENCE) && !_frames.empty()) {
if (_frames.front()->has_file())
return _frames.front()->file();
else
return NULL;
} else
return NULL;
} else
return qda_file();
}
#ifdef __QD_DEBUG_ENABLE__
uint32 resource_data_size() const;
#endif
//! Загрузка данных из сэйва.
bool load_data(Common::SeekableReadStream &fh, int save_version);
//! Запись данных в сэйв.
bool save_data(Common::WriteStream &fh) const;
bool add_scale(float value);
bool create_scaled_frames();
const Std::vector &scales() const {
if (check_flag(QD_ANIMATION_FLAG_REFERENCE) && _parent) return _parent->_scales;
else return _scales;
}
void clear_scales() {
_scales.clear();
}
const grTileAnimation *tileAnimation() const {
if (check_flag(QD_ANIMATION_FLAG_REFERENCE) && _parent)
return _parent->_tileAnimation;
else
return _tileAnimation;
}
static Common::String flag2str(int fl, bool truncate = false, bool icon = false);
static Common::String status2str(int fl, bool truncate = false);
private:
int _sx;
int _sy;
enum {
qda_version = 104
};
float _length;
float _cur_time;
float _playback_speed;
int _num_frames;
const qdAnimationFrameList *_frames_ptr;
qdAnimationFrameList _frames;
const qdAnimationFrameList *_scaled_frames_ptr;
qdAnimationFrameList _scaled_frames;
Std::vector _scales;
grTileAnimation *_tileAnimation;
int _status;
bool _is_finished;
Common::Path _qda_file;
const qdAnimation *_parent;
int get_scale_index(float &scale_value) const;
bool copy_frames(const qdAnimation &anm);
void clear_frames();
};
} // namespace QDEngine
#endif // QDENGINE_QDCORE_QD_ANIMATION_H