anim_frame_loader.hpp

Go to the documentation of this file.

#pragma once
 
#include <filesystem>
#include <string>
 
#include "porytiles/domain/algorithms/tile_extractors.hpp"
#include "porytiles/domain/models/anim_frame.hpp"
#include "porytiles/domain/models/image.hpp"
#include "porytiles/domain/models/palette.hpp"
#include "porytiles/domain/models/pixel_tile.hpp"
#include "porytiles/domain/models/supports_transparency.hpp"
#include "porytiles/utilities/result/chainable_result.hpp"
 
namespace porytiles {
 
template <SupportsTransparency PixelType>
struct FrameLoadResult {
    AnimFrame<PixelType> frame;
    std::size_t width_tiles;
    std::size_t height_tiles;
};
 
template <SupportsTransparency PixelType, typename LoaderType>
[[nodiscard]] ChainableResult<FrameLoadResult<PixelType>> load_animation_frame_from_png(
    const std::filesystem::path &png_path, const std::string &frame_name, const LoaderType &loader)
{
    // Step 1: Load the PNG file
    auto image_result = loader.load_from_file(png_path);
    if (!image_result.has_value()) {
        return ChainableResult<FrameLoadResult<PixelType>>{
            FormattableError{"'{}': Failed to load animation frame PNG.", FormatParam{png_path.string(), Style::bold}},
            image_result};
    }
 
    const Image<PixelType> &img = *image_result.value();
 
    // Step 2: Calculate dimensions in tiles
    const std::size_t width_tiles = img.width() / tile::side_length_pix;
    const std::size_t height_tiles = img.height() / tile::side_length_pix;
 
    // Step 3: Extract tiles from the image
    std::vector<PixelTile<PixelType>> tiles = extract_tiles_from_image(img);
 
    // Step 4: Create the AnimFrame
    AnimFrame<PixelType> frame{frame_name, std::move(tiles)};
 
    // Step 5: Set palette if the image has one
    if (img.palette().has_value()) {
        frame.palette(Palette<Rgba32>{img.palette().value()});
    }
 
    return FrameLoadResult<PixelType>{std::move(frame), width_tiles, height_tiles};
}
 
} // namespace porytiles