SpriteSheet.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::graphics {
class Quad;
class Texture;
}
 
namespace eve::animation {
 
class EVENGINE_API_WORLD SpriteSheet {
public:
    SpriteSheet() = default;
    ~SpriteSheet() = default;
 
    SpriteSheet(const SpriteSheet &)            = delete;
    SpriteSheet &operator=(const SpriteSheet &) = delete;
 
    int addFrame(const std::string &name, int x, int y, int w, int h);
    int addFrameTrimmed(const std::string &name, int x, int y, int w, int h,
                        int sourceW, int sourceH, int offsetX, int offsetY);
 
    int setGrid(int columns, int rows, int frameW, int frameH, int margin = 0, int spacing = 0,
                int originX = 0, int originY = 0);
 
    void clear();
 
    void setTexture(graphics::Texture *texture) { texture_ = texture; }
    graphics::Texture *getTexture() const { return texture_; }
 
    int         getFrameCount() const { return static_cast<int>(frames_.size()); }
    int         findFrame(const std::string &name) const;
    std::string getFrameName(int index) const;
    int         getFrameX(int index) const;
    int         getFrameY(int index) const;
    int         getFrameWidth(int index) const;
    int         getFrameHeight(int index) const;
    int getFrameSourceWidth(int index) const;
    int getFrameSourceHeight(int index) const;
    int getFrameOffsetX(int index) const;
    int getFrameOffsetY(int index) const;
 
    void applyToQuad(graphics::Quad *quad, int frameIndex) const;
    SpriteSheet *clone() const;
 
private:
    struct Frame {
        std::string name;
        int         x = 0, y = 0, w = 0, h = 0;
        int sourceW = 0, sourceH = 0, offsetX = 0, offsetY = 0;
    };
 
    void        checkIndex(int index) const;
    std::vector<Frame>                     frames_;
    std::unordered_map<std::string, int>   byName_;
    graphics::Texture                    *texture_ = nullptr;
};
 
}  // namespace eve::animation