Files
Card-Collection-Manager-3-s…/core/include/ccm/services/ImageService.hpp
T
Sebastian Dine 55ace147bc major: initial release
* initial development

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* pipeline

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* ci/cd

* pokemon

* pokemon

* pokemon

* pokemon

* pokemon

* pokemon

* improvements

* improvements

* ci/cd

* ci/cd

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

* improvements

---------

Co-authored-by: sdine <sdine@sdine.com>
2026-05-09 11:05:47 +02:00

71 lines
2.7 KiB
C++

#pragma once
// ImageService: applies the established image filename rules and delegates the actual
// disk operations to an IImageStore.
//
// Filename rule (mirrors Rust `magic/card_services.rs` and
// `pokemon/card_services.rs`):
// - new entry -> "{set}+{name}+{idx}.{ext}"
// - existing -> "{id}+{set}+{name}+{idx}.{ext}"
//
// The "+name+set+name+" convention is preserved byte-for-byte so legacy
// collections continue to display correctly when imported.
#include "ccm/domain/Enums.hpp"
#include "ccm/ports/IImageStore.hpp"
#include "ccm/util/Result.hpp"
#include <cstdint>
#include <filesystem>
#include <string>
#include <vector>
namespace ccm {
class ImageService {
public:
explicit ImageService(IImageStore& store);
// Compute the next image index from the previously stored image filenames
// for a card. Implements the same logic as the Rust card_services modules.
static std::uint8_t nextImageIndex(const std::vector<std::string>& existingImages);
// Build the target filename (without extension) for a new image attached
// to a card. Pass the card's existing id (0 if not yet stored) and a
// `newEntry` flag matching the established semantic.
static std::string buildTargetName(bool newEntry,
std::uint32_t cardId,
const std::string& setName,
const std::string& cardName,
std::uint8_t index);
// Convenience: build target name + delegate copy to the IImageStore.
Result<std::string> addImage(Game game,
const std::filesystem::path& srcPath,
bool newEntry,
std::uint32_t cardId,
const std::string& setName,
const std::string& cardName,
const std::vector<std::string>& existingImages);
Result<void> removeImage(Game game, const std::string& imageName);
// Ensure image filenames for a persisted card include the card id prefix.
// This upgrades "create-mode" names (`set+name+idx.ext`) to
// `id+set+name+idx.ext` to match the ccm2-compatible naming scheme.
Result<std::vector<std::string>> normalizeNamesForPersistedCard(
Game game,
std::uint32_t cardId,
const std::string& setName,
const std::string& cardName,
const std::vector<std::string>& imageNames);
[[nodiscard]] std::filesystem::path resolveImagePath(Game game,
const std::string& imageName) const;
private:
IImageStore& store_;
};
} // namespace ccm