JailDesigner
4da05b3d76
- Nou format de pack AE26 v1 (XOR + djb2), eina `pack_resources`, regeneració automàtica de `build/resources.pack` a cada build. - `Resource::Helper` amb init/shutdown, fallback a disc només en Debug (apunta al source tree); Release exigeix pack present. - Callers de YAML migrats a `loadFile`+deserialize des de buffer. - Arrel neta: el pack viu a `build/`, eliminat `sync_data`. - Placeholder font -> `ari-w9500-condensed-display`; esborrades variants bold/condensed no usades a `data/fonts/`.
64 lines
2.3 KiB
C++
64 lines
2.3 KiB
C++
#pragma once
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <unordered_map>
|
|
#include <vector>
|
|
|
|
namespace Resource {
|
|
|
|
// Entrada d'un recurs dins el pack.
|
|
struct PackEntry {
|
|
std::string filename;
|
|
std::uint64_t offset{0};
|
|
std::uint64_t size{0};
|
|
std::uint32_t checksum{0};
|
|
};
|
|
|
|
// Pack binari de recursos carregat a memòria. Format:
|
|
// Header: "AE26" (4 bytes) + version uint32 + resource_count uint32
|
|
// Index: per cada recurs -> filename_len uint32 + filename
|
|
// + offset uint64 + size uint64 + checksum uint32
|
|
// Payload: data_size uint64 + bytes xifrats amb XOR (DEFAULT_ENCRYPT_KEY)
|
|
// La classe té dos rols: (a) loader en temps d'execució — carregar un
|
|
// .pack del disc i obtindre els bytes d'un recurs per nom; (b) builder
|
|
// usat per l'eina `pack_resources` per a empaquetar `data/`.
|
|
class Pack {
|
|
public:
|
|
Pack() = default;
|
|
~Pack() = default;
|
|
|
|
Pack(const Pack&) = delete;
|
|
auto operator=(const Pack&) -> Pack& = delete;
|
|
Pack(Pack&&) = default;
|
|
auto operator=(Pack&&) -> Pack& = default;
|
|
|
|
// I/O del fitxer. `loadPack` retorna false silenciosament si el
|
|
// fitxer no existeix (el caller decideix si cal fallback).
|
|
auto loadPack(const std::string& pack_file) -> bool;
|
|
auto savePack(const std::string& pack_file) const -> bool;
|
|
|
|
// Builders usats per l'eina `pack_resources`.
|
|
auto addFile(const std::string& filename, const std::string& filepath) -> bool;
|
|
auto addDirectory(const std::string& directory) -> bool;
|
|
|
|
[[nodiscard]] auto getResource(const std::string& filename) const -> std::vector<std::uint8_t>;
|
|
[[nodiscard]] auto hasResource(const std::string& filename) const -> bool;
|
|
|
|
void clear();
|
|
[[nodiscard]] auto getResourceCount() const -> std::size_t;
|
|
[[nodiscard]] auto getResourceList() const -> std::vector<std::string>;
|
|
|
|
static const std::string DEFAULT_ENCRYPT_KEY;
|
|
|
|
private:
|
|
std::unordered_map<std::string, PackEntry> resources_;
|
|
std::vector<std::uint8_t> data_;
|
|
|
|
static auto calculateChecksum(const std::vector<std::uint8_t>& data) -> std::uint32_t;
|
|
static void xorInPlace(std::vector<std::uint8_t>& data, const std::string& key);
|
|
};
|
|
|
|
} // namespace Resource
|