anim_tile_matcher.hpp

Go to the documentation of this file.

#pragma once
 
#include <map>
#include <optional>
#include <string>
#include <vector>
 
#include "porytiles/domain/models/animation.hpp"
#include "porytiles/domain/models/canonical_pixel_tile.hpp"
#include "porytiles/domain/models/rgba32.hpp"
 
namespace porytiles {
 
struct AnimTileMatch {
    std::string anim_name;         
    std::size_t tile_index;        
    std::size_t keyframe_tile_idx; 
    bool h_flip;                   
    bool v_flip;                   
    bool is_cross_tileset{false};  
};
 
class AnimTileMatcher {
  public:
    void register_animation(
        const std::string &anim_name,
        const Animation<Rgba32> &animation,
        std::size_t tile_offset,
        const Rgba32 &extrinsic_transparency,
        bool is_cross_tileset = false);
 
    [[nodiscard]] std::optional<AnimTileMatch>
    find_match(const CanonicalPixelTile<Rgba32> &tile, const Rgba32 &extrinsic_transparency) const;
 
    [[nodiscard]] std::size_t total_keyframe_tiles() const
    {
        return total_tiles_;
    }
 
    [[nodiscard]] std::optional<std::size_t> tile_offset_for(const std::string &anim_name) const;
 
    [[nodiscard]] std::optional<std::size_t> tile_count_for(const std::string &anim_name) const;
 
    [[nodiscard]] bool is_in_animation_range(std::size_t tile_index) const;
 
    void clear();
 
  private:
    struct KeyframeTileInfo {
        std::string anim_name;
        std::size_t tile_index;        // Absolute index in tiles.png
        std::size_t keyframe_tile_idx; // Index within keyframe
        bool h_flip;                   // Flip applied to reach canonical form
        bool v_flip;
        bool is_cross_tileset;
    };
 
    struct AnimRegistration {
        std::size_t tile_offset;
        std::size_t tile_count;
    };
 
    struct KeyframeKey {
        PixelTile<Rgba32> tile;
        Rgba32 extrinsic_transparency;
    };
 
    struct KeyframeKeyCompare {
        using is_transparent = void;
 
        bool operator()(const KeyframeKey &a, const KeyframeKey &b) const
        {
            return PixelTile<Rgba32>::cross_et_compare(
                       a.tile, a.extrinsic_transparency, b.tile, b.extrinsic_transparency) < 0;
        }
    };
 
    // Map from canonical tile form (with its source ET) to keyframe info
    std::map<KeyframeKey, KeyframeTileInfo, KeyframeKeyCompare> lookup_map_;
    std::size_t total_tiles_{0};
    std::map<std::string, AnimRegistration> animation_registrations_;
};
 
} // namespace porytiles