0d25d8e7fc
* Add support for individual frame duration to `SpriteFrames`. * Various minor improvements.
261 lines
9.9 KiB
C++
261 lines
9.9 KiB
C++
/*************************************************************************/
|
|
/* sprite_frames.cpp */
|
|
/*************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/*************************************************************************/
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/*************************************************************************/
|
|
|
|
#include "sprite_frames.h"
|
|
|
|
#include "scene/scene_string_names.h"
|
|
|
|
void SpriteFrames::add_frame(const StringName &p_anim, const Ref<Texture2D> &p_texture, float p_duration, int p_at_pos) {
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
|
|
p_duration = MAX(0.0, p_duration);
|
|
|
|
Frame frame = { p_texture, p_duration };
|
|
|
|
if (p_at_pos >= 0 && p_at_pos < E->value.frames.size()) {
|
|
E->value.frames.insert(p_at_pos, frame);
|
|
} else {
|
|
E->value.frames.push_back(frame);
|
|
}
|
|
|
|
emit_changed();
|
|
}
|
|
|
|
void SpriteFrames::set_frame(const StringName &p_anim, int p_idx, const Ref<Texture2D> &p_texture, float p_duration) {
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
ERR_FAIL_COND(p_idx < 0);
|
|
if (p_idx >= E->value.frames.size()) {
|
|
return;
|
|
}
|
|
|
|
p_duration = MAX(0.0, p_duration);
|
|
|
|
Frame frame = { p_texture, p_duration };
|
|
|
|
E->value.frames.write[p_idx] = frame;
|
|
|
|
emit_changed();
|
|
}
|
|
|
|
int SpriteFrames::get_frame_count(const StringName &p_anim) const {
|
|
HashMap<StringName, Anim>::ConstIterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_V_MSG(!E, 0, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
|
|
return E->value.frames.size();
|
|
}
|
|
|
|
void SpriteFrames::remove_frame(const StringName &p_anim, int p_idx) {
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
|
|
E->value.frames.remove_at(p_idx);
|
|
|
|
emit_changed();
|
|
}
|
|
|
|
void SpriteFrames::clear(const StringName &p_anim) {
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
|
|
E->value.frames.clear();
|
|
|
|
emit_changed();
|
|
}
|
|
|
|
void SpriteFrames::clear_all() {
|
|
animations.clear();
|
|
add_animation("default");
|
|
}
|
|
|
|
void SpriteFrames::add_animation(const StringName &p_anim) {
|
|
ERR_FAIL_COND_MSG(animations.has(p_anim), "SpriteFrames already has animation '" + p_anim + "'.");
|
|
|
|
animations[p_anim] = Anim();
|
|
}
|
|
|
|
bool SpriteFrames::has_animation(const StringName &p_anim) const {
|
|
return animations.has(p_anim);
|
|
}
|
|
|
|
void SpriteFrames::remove_animation(const StringName &p_anim) {
|
|
animations.erase(p_anim);
|
|
}
|
|
|
|
void SpriteFrames::rename_animation(const StringName &p_prev, const StringName &p_next) {
|
|
ERR_FAIL_COND_MSG(!animations.has(p_prev), "SpriteFrames doesn't have animation '" + String(p_prev) + "'.");
|
|
ERR_FAIL_COND_MSG(animations.has(p_next), "Animation '" + String(p_next) + "' already exists.");
|
|
|
|
Anim anim = animations[p_prev];
|
|
animations.erase(p_prev);
|
|
animations[p_next] = anim;
|
|
}
|
|
|
|
void SpriteFrames::get_animation_list(List<StringName> *r_animations) const {
|
|
for (const KeyValue<StringName, Anim> &E : animations) {
|
|
r_animations->push_back(E.key);
|
|
}
|
|
}
|
|
|
|
Vector<String> SpriteFrames::get_animation_names() const {
|
|
Vector<String> names;
|
|
for (const KeyValue<StringName, Anim> &E : animations) {
|
|
names.push_back(E.key);
|
|
}
|
|
names.sort();
|
|
return names;
|
|
}
|
|
|
|
void SpriteFrames::set_animation_speed(const StringName &p_anim, double p_fps) {
|
|
ERR_FAIL_COND_MSG(p_fps < 0, "Animation speed cannot be negative (" + itos(p_fps) + ").");
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
E->value.speed = p_fps;
|
|
}
|
|
|
|
double SpriteFrames::get_animation_speed(const StringName &p_anim) const {
|
|
HashMap<StringName, Anim>::ConstIterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_V_MSG(!E, 0, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
return E->value.speed;
|
|
}
|
|
|
|
void SpriteFrames::set_animation_loop(const StringName &p_anim, bool p_loop) {
|
|
HashMap<StringName, Anim>::Iterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_MSG(!E, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
E->value.loop = p_loop;
|
|
}
|
|
|
|
bool SpriteFrames::get_animation_loop(const StringName &p_anim) const {
|
|
HashMap<StringName, Anim>::ConstIterator E = animations.find(p_anim);
|
|
ERR_FAIL_COND_V_MSG(!E, false, "Animation '" + String(p_anim) + "' doesn't exist.");
|
|
return E->value.loop;
|
|
}
|
|
|
|
Array SpriteFrames::_get_animations() const {
|
|
Array anims;
|
|
|
|
List<StringName> sorted_names;
|
|
get_animation_list(&sorted_names);
|
|
sorted_names.sort_custom<StringName::AlphCompare>();
|
|
|
|
for (const StringName &anim_name : sorted_names) {
|
|
const Anim &anim = animations[anim_name];
|
|
Dictionary d;
|
|
d["name"] = anim_name;
|
|
d["speed"] = anim.speed;
|
|
d["loop"] = anim.loop;
|
|
Array frames;
|
|
for (int i = 0; i < anim.frames.size(); i++) {
|
|
Dictionary f;
|
|
f["texture"] = anim.frames[i].texture;
|
|
f["duration"] = anim.frames[i].duration;
|
|
frames.push_back(f);
|
|
}
|
|
d["frames"] = frames;
|
|
anims.push_back(d);
|
|
}
|
|
|
|
return anims;
|
|
}
|
|
|
|
void SpriteFrames::_set_animations(const Array &p_animations) {
|
|
animations.clear();
|
|
for (int i = 0; i < p_animations.size(); i++) {
|
|
Dictionary d = p_animations[i];
|
|
|
|
ERR_CONTINUE(!d.has("name"));
|
|
ERR_CONTINUE(!d.has("speed"));
|
|
ERR_CONTINUE(!d.has("loop"));
|
|
ERR_CONTINUE(!d.has("frames"));
|
|
|
|
Anim anim;
|
|
anim.speed = d["speed"];
|
|
anim.loop = d["loop"];
|
|
Array frames = d["frames"];
|
|
for (int j = 0; j < frames.size(); j++) {
|
|
// For compatibility.
|
|
Ref<Resource> res = frames[j];
|
|
if (res.is_valid()) {
|
|
Frame frame = { res, 1.0 };
|
|
anim.frames.push_back(frame);
|
|
continue;
|
|
}
|
|
|
|
Dictionary f = frames[j];
|
|
|
|
ERR_CONTINUE(!f.has("texture"));
|
|
ERR_CONTINUE(!f.has("duration"));
|
|
|
|
Frame frame = { f["texture"], f["duration"] };
|
|
anim.frames.push_back(frame);
|
|
}
|
|
|
|
animations[d["name"]] = anim;
|
|
}
|
|
}
|
|
|
|
void SpriteFrames::_bind_methods() {
|
|
ClassDB::bind_method(D_METHOD("add_animation", "anim"), &SpriteFrames::add_animation);
|
|
ClassDB::bind_method(D_METHOD("has_animation", "anim"), &SpriteFrames::has_animation);
|
|
ClassDB::bind_method(D_METHOD("remove_animation", "anim"), &SpriteFrames::remove_animation);
|
|
ClassDB::bind_method(D_METHOD("rename_animation", "anim", "newname"), &SpriteFrames::rename_animation);
|
|
|
|
ClassDB::bind_method(D_METHOD("get_animation_names"), &SpriteFrames::get_animation_names);
|
|
|
|
ClassDB::bind_method(D_METHOD("set_animation_speed", "anim", "fps"), &SpriteFrames::set_animation_speed);
|
|
ClassDB::bind_method(D_METHOD("get_animation_speed", "anim"), &SpriteFrames::get_animation_speed);
|
|
|
|
ClassDB::bind_method(D_METHOD("set_animation_loop", "anim", "loop"), &SpriteFrames::set_animation_loop);
|
|
ClassDB::bind_method(D_METHOD("get_animation_loop", "anim"), &SpriteFrames::get_animation_loop);
|
|
|
|
ClassDB::bind_method(D_METHOD("add_frame", "anim", "texture", "duration", "at_position"), &SpriteFrames::add_frame, DEFVAL(1.0), DEFVAL(-1));
|
|
ClassDB::bind_method(D_METHOD("set_frame", "anim", "idx", "texture", "duration"), &SpriteFrames::set_frame, DEFVAL(1.0));
|
|
ClassDB::bind_method(D_METHOD("remove_frame", "anim", "idx"), &SpriteFrames::remove_frame);
|
|
|
|
ClassDB::bind_method(D_METHOD("get_frame_count", "anim"), &SpriteFrames::get_frame_count);
|
|
ClassDB::bind_method(D_METHOD("get_frame_texture", "anim", "idx"), &SpriteFrames::get_frame_texture);
|
|
ClassDB::bind_method(D_METHOD("get_frame_duration", "anim", "idx"), &SpriteFrames::get_frame_duration);
|
|
|
|
ClassDB::bind_method(D_METHOD("clear", "anim"), &SpriteFrames::clear);
|
|
ClassDB::bind_method(D_METHOD("clear_all"), &SpriteFrames::clear_all);
|
|
|
|
// `animations` property is for serialization.
|
|
|
|
ClassDB::bind_method(D_METHOD("_set_animations", "animations"), &SpriteFrames::_set_animations);
|
|
ClassDB::bind_method(D_METHOD("_get_animations"), &SpriteFrames::_get_animations);
|
|
|
|
ADD_PROPERTY(PropertyInfo(Variant::ARRAY, "animations", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL), "_set_animations", "_get_animations");
|
|
}
|
|
|
|
SpriteFrames::SpriteFrames() {
|
|
add_animation(SceneStringNames::get_singleton()->_default);
|
|
}
|