128 lines
4.5 KiB
C
128 lines
4.5 KiB
C
|
#pragma once
|
|||
|
|
|
|||
|
|
#include <easy2d/scene/sprite.h>
|
|||
|
|
#include <easy2d/animation/animation_controller.h>
|
|||
|
|
#include <easy2d/animation/animation_cache.h>
|
|||
|
|
#include <string>
|
|||
|
|
#include <array>
|
|||
|
|
#include <vector>
|
|||
|
|
#include <unordered_map>
|
|||
|
|
#include <cstdint>
|
|||
|
|
|
|||
|
|
namespace easy2d {
|
|||
|
|
|
|||
|
|
// ============================================================================
|
|||
|
|
// AnimatedSprite - 动画精灵节点
|
|||
|
|
// 将 AnimationController 与 Sprite 渲染桥接，接入场景图
|
|||
|
|
// ============================================================================
|
|||
|
|
class AnimatedSprite : public Sprite {
|
|||
|
|
public:
|
|||
|
|
AnimatedSprite();
|
|||
|
|
~AnimatedSprite() override = default;
|
|||
|
|
|
|||
|
|
// ------ 静态工厂 ------
|
|||
|
|
static Ptr<AnimatedSprite> create();
|
|||
|
|
static Ptr<AnimatedSprite> create(Ptr<AnimationClip> clip);
|
|||
|
|
static Ptr<AnimatedSprite> create(const std::string& aniFilePath);
|
|||
|
|
|
|||
|
|
// ------ 动画绑定 ------
|
|||
|
|
void setAnimationClip(Ptr<AnimationClip> clip);
|
|||
|
|
void loadAnimation(const std::string& aniFilePath);
|
|||
|
|
Ptr<AnimationClip> getAnimationClip() const;
|
|||
|
|
|
|||
|
|
// ------ 动画字典 ------
|
|||
|
|
void addAnimation(const std::string& name, Ptr<AnimationClip> clip);
|
|||
|
|
void play(const std::string& name, bool loop = true);
|
|||
|
|
bool hasAnimation(const std::string& name) const;
|
|||
|
|
Ptr<AnimationClip> getAnimation(const std::string& name) const;
|
|||
|
|
const std::string& getCurrentAnimationName() const;
|
|||
|
|
|
|||
|
|
// ------ 播放控制（委托 controller_）------
|
|||
|
|
void play();
|
|||
|
|
void pause();
|
|||
|
|
void resume();
|
|||
|
|
void stop();
|
|||
|
|
void reset();
|
|||
|
|
bool isPlaying() const;
|
|||
|
|
bool isPaused() const;
|
|||
|
|
bool isStopped() const;
|
|||
|
|
|
|||
|
|
// ------ 属性控制 ------
|
|||
|
|
void setLooping(bool loop);
|
|||
|
|
bool isLooping() const;
|
|||
|
|
void setPlaybackSpeed(float speed);
|
|||
|
|
float getPlaybackSpeed() const;
|
|||
|
|
|
|||
|
|
// ------ 帧控制 ------
|
|||
|
|
void setFrameIndex(size_t index);
|
|||
|
|
size_t getCurrentFrameIndex() const;
|
|||
|
|
size_t getTotalFrames() const;
|
|||
|
|
void nextFrame();
|
|||
|
|
void prevFrame();
|
|||
|
|
|
|||
|
|
// ------ 帧范围限制 ------
|
|||
|
|
/// 设置帧播放范围（用于精灵图动画，限制在指定范围内循环）
|
|||
|
|
/// @param start 起始帧索引（包含）
|
|||
|
|
/// @param end 结束帧索引（包含），-1表示不限制
|
|||
|
|
void setFrameRange(int start, int end = -1);
|
|||
|
|
|
|||
|
|
/// 获取当前帧范围
|
|||
|
|
/// @return pair<起始帧, 结束帧>，结束帧为-1表示不限制
|
|||
|
|
std::pair<int, int> getFrameRange() const;
|
|||
|
|
|
|||
|
|
/// 清除帧范围限制（恢复播放所有帧）
|
|||
|
|
void clearFrameRange();
|
|||
|
|
|
|||
|
|
/// 检查是否设置了帧范围限制
|
|||
|
|
bool hasFrameRange() const;
|
|||
|
|
|
|||
|
|
// ------ 回调 ------
|
|||
|
|
void setCompletionCallback(AnimationController::CompletionCallback cb);
|
|||
|
|
void setKeyframeCallback(AnimationController::KeyframeCallback cb);
|
|||
|
|
void setSoundTriggerCallback(AnimationController::SoundTriggerCallback cb);
|
|||
|
|
|
|||
|
|
// ------ 碰撞盒访问（当前帧）------
|
|||
|
|
const std::vector<std::array<int32_t, 6>>& getCurrentDamageBoxes() const;
|
|||
|
|
const std::vector<std::array<int32_t, 6>>& getCurrentAttackBoxes() const;
|
|||
|
|
|
|||
|
|
// ------ 帧变换控制 ------
|
|||
|
|
/// 设置是否由动画帧数据覆盖节点的 position/scale/rotation
|
|||
|
|
/// ANI 动画需要开启（默认），精灵图动画应关闭
|
|||
|
|
void setApplyFrameTransform(bool apply) { applyFrameTransform_ = apply; }
|
|||
|
|
bool isApplyFrameTransform() const { return applyFrameTransform_; }
|
|||
|
|
|
|||
|
|
// ------ 自动播放 ------
|
|||
|
|
void setAutoPlay(bool autoPlay) { autoPlay_ = autoPlay; }
|
|||
|
|
bool isAutoPlay() const { return autoPlay_; }
|
|||
|
|
|
|||
|
|
// ------ 直接控制器访问 ------
|
|||
|
|
AnimationController& getController() { return controller_; }
|
|||
|
|
const AnimationController& getController() const { return controller_; }
|
|||
|
|
|
|||
|
|
protected:
|
|||
|
|
void onUpdate(float dt) override;
|
|||
|
|
void onEnter() override;
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
AnimationController controller_;
|
|||
|
|
bool autoPlay_ = false;
|
|||
|
|
bool applyFrameTransform_ = true;
|
|||
|
|
|
|||
|
|
// 动画字典
|
|||
|
|
std::unordered_map<std::string, Ptr<AnimationClip>> animations_;
|
|||
|
|
std::string currentAnimationName_;
|
|||
|
|
static const std::string emptyString_;
|
|||
|
|
|
|||
|
|
// 帧范围限制（用于精灵图动画）
|
|||
|
|
int frameRangeStart_ = 0; // 起始帧索引
|
|||
|
|
int frameRangeEnd_ = -1; // 结束帧索引，-1表示不限制
|
|||
|
|
|
|||
|
|
// 空碰撞盒列表（用于无帧时返回引用）
|
|||
|
|
static const std::vector<std::array<int32_t, 6>> emptyBoxes_;
|
|||
|
|
|
|||
|
|
void applyFrame(const AnimationFrame& frame);
|
|||
|
|
void onFrameChanged(size_t oldIdx, size_t newIdx, const AnimationFrame& frame);
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
} // namespace easy2d
|