108 lines
3.6 KiB
C++
108 lines
3.6 KiB
C++
#pragma once
|
||
|
||
#include <easy2d/scene/node.h>
|
||
#include <easy2d/animation/animation_clip.h>
|
||
#include <easy2d/animation/animation_controller.h>
|
||
#include <easy2d/animation/animation_cache.h>
|
||
#include <easy2d/animation/frame_renderer.h>
|
||
#include <easy2d/animation/animation_event.h>
|
||
#include <vector>
|
||
|
||
namespace easy2d {
|
||
|
||
// ============================================================================
|
||
// AnimationNode - 动画节点（继承 Node）
|
||
// 使用 FrameRenderer 单渲染器策略，不依赖 Sprite 基类
|
||
// 适用于需要独立渲染控制的动画（如特效、复合动画图层）
|
||
// ============================================================================
|
||
class AnimationNode : public Node {
|
||
public:
|
||
AnimationNode();
|
||
~AnimationNode() override = default;
|
||
|
||
// ------ 静态工厂（Cocos 风格）------
|
||
static Ptr<AnimationNode> create();
|
||
static Ptr<AnimationNode> create(Ptr<AnimationClip> clip);
|
||
static Ptr<AnimationNode> create(const std::string& aniFilePath);
|
||
|
||
// ------ 动画数据 ------
|
||
void setClip(Ptr<AnimationClip> clip);
|
||
Ptr<AnimationClip> getClip() const;
|
||
bool loadFromFile(const std::string& aniFilePath);
|
||
|
||
// ------ 播放控制 ------
|
||
void play();
|
||
void pause();
|
||
void resume();
|
||
void stop();
|
||
void reset();
|
||
|
||
bool isPlaying() const;
|
||
bool isPaused() const;
|
||
bool isStopped() const;
|
||
|
||
void setPlaybackSpeed(float speed);
|
||
float getPlaybackSpeed() const;
|
||
void setLooping(bool loop);
|
||
bool isLooping() const;
|
||
|
||
// ------ 帧控制 ------
|
||
void setFrameIndex(size_t index);
|
||
size_t getCurrentFrameIndex() const;
|
||
size_t getTotalFrames() const;
|
||
|
||
// ------ 事件回调 ------
|
||
void setKeyframeCallback(KeyframeHitCallback callback);
|
||
void setCompletionCallback(AnimationCompleteCallback callback);
|
||
void setFrameChangeCallback(AnimationController::FrameChangeCallback callback);
|
||
void addEventListener(AnimationEventCallback callback);
|
||
|
||
// ------ 视觉属性 ------
|
||
void setTintColor(const Color& color);
|
||
Color getTintColor() const { return tintColor_; }
|
||
void setFlipX(bool flip) { flipX_ = flip; }
|
||
void setFlipY(bool flip) { flipY_ = flip; }
|
||
bool isFlipX() const { return flipX_; }
|
||
bool isFlipY() const { return flipY_; }
|
||
|
||
// ------ 自动播放 ------
|
||
void setAutoPlay(bool autoPlay) { autoPlay_ = autoPlay; }
|
||
bool isAutoPlay() const { return autoPlay_; }
|
||
|
||
// ------ 碰撞盒访问 ------
|
||
const std::vector<std::array<int32_t, 6>>& getCurrentDamageBoxes() const;
|
||
const std::vector<std::array<int32_t, 6>>& getCurrentAttackBoxes() const;
|
||
|
||
// ------ 查询 ------
|
||
Size getMaxFrameSize() const;
|
||
Rect getBoundingBox() const override;
|
||
|
||
// ------ 直接访问 ------
|
||
AnimationController& getController() { return controller_; }
|
||
const AnimationController& getController() const { return controller_; }
|
||
FrameRenderer& getFrameRenderer() { return frameRenderer_; }
|
||
const FrameRenderer& getFrameRenderer() const { return frameRenderer_; }
|
||
|
||
protected:
|
||
void onUpdate(float dt) override;
|
||
void onDraw(RenderBackend& renderer) override;
|
||
void onEnter() override;
|
||
void onExit() override;
|
||
|
||
private:
|
||
AnimationController controller_;
|
||
FrameRenderer frameRenderer_;
|
||
Color tintColor_ = Colors::White;
|
||
bool flipX_ = false;
|
||
bool flipY_ = false;
|
||
bool autoPlay_ = false;
|
||
std::vector<AnimationEventCallback> eventListeners_;
|
||
|
||
static const std::vector<std::array<int32_t, 6>> emptyBoxes_;
|
||
|
||
void setupControllerCallbacks();
|
||
void dispatchEvent(const AnimationEvent& event);
|
||
};
|
||
|
||
} // namespace easy2d
|