SpriteClip.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::animation {
 
class SpriteSheet;
 
class EVENGINE_API_WORLD SpriteClip {
public:
    explicit SpriteClip(const std::string &name = "");
    ~SpriteClip() = default;
 
    SpriteClip(const SpriteClip &)            = delete;
    SpriteClip &operator=(const SpriteClip &) = delete;
 
    void        setName(const std::string &name);
    std::string getName() const { return name_; }
 
    void setLoop(bool loop) { loop_ = loop; }
    bool getLoop() const { return loop_; }
 
    void addFrame(int sheetFrameIndex, float duration = 0.1f);
 
    void addFrameByName(SpriteSheet *sheet, const std::string &frameName, float duration = 0.1f);
 
    void addRange(int firstSheetFrame, int lastSheetFrame, float fps);
    void setFPS(float fps);
    float getFPS() const;
    void addEvent(int clipFrame, const std::string &name);
    std::string getEvent(int clipFrame) const;
 
    void clear();
 
    int   getFrameCount() const { return static_cast<int>(frames_.size()); }
    int   getSheetFrame(int index) const;
    float getFrameDuration(int index) const;
    float getDuration() const;
 
    int frameAtTime(float timeSeconds) const;
 
    float wrapTime(float timeSeconds) const;
 
private:
    struct Entry {
        int   sheetFrame = 0;
        float duration   = 0.1f;
    };
 
    void checkIndex(int index) const;
 
    std::string        name_;
    bool               loop_ = true;
    std::vector<Entry> frames_;
    std::unordered_map<int, std::string> events_;
};
 
}  // namespace eve::animation