tiles_png_workspace.hpp

Go to the documentation of this file.

#pragma once
 
#include <map>
#include <optional>
#include <vector>
 
#include "porytiles/domain/models/canonical_pixel_tile.hpp"
#include "porytiles/domain/models/image.hpp"
#include "porytiles/domain/models/index_pixel.hpp"
#include "porytiles/domain/models/palette.hpp"
#include "porytiles/domain/models/pixel_tile.hpp"
#include "porytiles/domain/models/rgba32.hpp"
 
namespace porytiles {
 
enum class ExportFlipMode {
    canonical,
 
    original
};
 
enum class ExportTrimMode {
    include_trailing_transparent,
 
    trim_trailing_transparent
};
 
class TilesPngWorkspace {
  public:
    explicit TilesPngWorkspace(std::size_t capacity);
 
    explicit TilesPngWorkspace(const Image<IndexPixel> &img, std::size_t capacity);
 
    [[nodiscard]] static TilesPngWorkspace for_secondary(
        const Image<IndexPixel> &primary_tiles_png, std::size_t primary_tile_count, std::size_t total_capacity);
 
    [[nodiscard]] static TilesPngWorkspace
    for_standalone_secondary(std::size_t primary_tile_count, std::size_t total_capacity);
 
    [[nodiscard]] std::size_t insert_tile(const CanonicalPixelTile<IndexPixel> &tile);
 
    [[nodiscard]] std::optional<std::size_t> first_occurrence_of(const CanonicalPixelTile<IndexPixel> &tile) const;
 
    [[nodiscard]] std::optional<std::size_t> first_occurrence_of_by_color(
        const CanonicalPixelTile<IndexPixel> &tile, const Palette<Rgba32, pal::max_size> &palette) const;
 
    [[nodiscard]] CanonicalPixelTile<IndexPixel> tile_at(std::size_t index) const;
 
    [[nodiscard]] Image<IndexPixel> export_image(
        ExportFlipMode flip_mode = ExportFlipMode::canonical,
        ExportTrimMode trim_mode = ExportTrimMode::trim_trailing_transparent) const;
 
    [[nodiscard]] Image<IndexPixel> export_secondary_image(
        std::size_t primary_tile_count,
        ExportFlipMode flip_mode = ExportFlipMode::canonical,
        ExportTrimMode trim_mode = ExportTrimMode::trim_trailing_transparent) const;
 
    [[nodiscard]] bool at_capacity() const;
 
    void reserve_anim_slots(std::size_t anim_tile_count, std::size_t start_offset = 1);
 
    void place_anim_tile(std::size_t reserved_index, const CanonicalPixelTile<IndexPixel> &tile);
 
    [[nodiscard]] std::size_t anim_start_offset() const
    {
        return anim_start_offset_;
    }
 
    [[nodiscard]] std::size_t anim_end_offset() const
    {
        return anim_end_offset_;
    }
 
    [[nodiscard]] bool has_anim_slots() const
    {
        return anim_end_offset_ > anim_start_offset_;
    }
 
    [[nodiscard]] std::optional<std::size_t> find_contiguous_transparent_slots(std::size_t count) const;
 
    [[nodiscard]] std::optional<std::size_t> find_existing_contiguous_tiles_by_color(
        const std::vector<CanonicalPixelTile<IndexPixel>> &tiles,
        const std::vector<const Palette<Rgba32, pal::max_size> *> &palettes) const;
 
    void place_tiles_at(std::size_t start_index, const std::vector<CanonicalPixelTile<IndexPixel>> &tiles);
 
    [[nodiscard]] std::size_t capacity() const
    {
        return capacity_;
    }
 
  private:
    void advance_cursor_to_next_transparent();
 
    std::vector<CanonicalPixelTile<IndexPixel>> tiles_;
    std::map<PixelTile<IndexPixel>, std::vector<std::size_t>> canonical_forms_;
    std::size_t cursor_;
    std::size_t capacity_;
    std::size_t anim_start_offset_{1}; // First index in anim region (defaults to 1 for primary tilesets)
    std::size_t anim_end_offset_{1};   // First index after anim region (defaults to 1, i.e. no animations)
};
 
} // namespace porytiles