JailDesigner
7ee359b910
Sweep final del naming a CamelCase/camelBack/lower_case:
Fitxers renombrats:
- effects/gestor_puntuacio_flotant.{hpp,cpp} -> floating_score_manager.{hpp,cpp}
- effects/puntuacio_flotant.hpp -> floating_score.hpp
Tipus (CamelCase):
- GestorPuntuacioFlotant -> FloatingScoreManager
- PuntuacioFlotant -> FloatingScore
- ConfigStage -> StageConfig
- ConfigSistemaStages -> StageSystemConfig
- NauTitol -> TitleShip
- EstatNau -> ShipState
Metodes publics (camelBack):
- obte_renderer -> getRenderer
- get_num_actius -> getActiveCount
- calcular_direccio_explosio -> computeExplosionDirection
- trobar_slot_lliure -> findFreeSlot
- explotar -> explode
- reiniciar -> reset
- es_valida -> isValid
- parsejar_fitxer -> parseFile
- carregar -> load
- crear_explosio -> createExplosion
- registrar_puntuacio -> registerScore
- construir_marcador -> buildScoreboard
- render_centered -> renderCentered
Camps struct publics (snake_case):
- actiu/actius -> active
- rotacio -> rotation, rotacio_visual -> visual_rotation
- acceleracio -> acceleration
- velocitat -> velocity
- escala/escala_inicial/objectiu/actual -> scale/initial_scale/...
- posicio/posicio_inicial/objectiu/actual -> position/initial_position/...
- fase_oscilacio -> oscillation_phase
- temps_estat -> state_time
- jugador_id -> player_id
- estat -> state
- brillantor -> brightness
- tipus -> type
Camps privats (sufix _):
- naus_ -> ships_, orni_ -> enemies_, bales_ -> bullets_
- gestor_puntuacio_ -> floating_score_manager_
- punt_mort_ -> death_position_, punt_spawn_ -> spawn_position_
- itocado_per_jugador_ -> hit_timer_per_player_
- vides_per_jugador_ -> lives_per_player_
- puntuacio_per_jugador_ -> score_per_player_
- estat_game_over_ -> game_over_state_
- continues_usados_ -> continues_used_
Constants:
- MARGE_ESQ/DRET/DALT/BAIX -> MARGIN_LEFT/RIGHT/TOP/BOTTOM
Variables locals i parametres comuns (snake_case):
- nau -> ship, enemic -> enemy, bala -> bullet
- forma -> shape, punt(s) -> point(s)
- jugador -> player, partida -> match
- temps -> time, missatge -> message
Diff: 59 fitxers, +1000/-1000 (simetric). Compila i enllaça.
Pendents per a futures fases (no bloquejants):
- Comentaris de capçalera en catala -> castella
- Variables locals/parametres minoritaris en catala
- Include guards (queden alguns #ifndef en lloc de #pragma once)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
68 lines
2.2 KiB
C++
68 lines
2.2 KiB
C++
// resource_pack.hpp - Sistema d'empaquetament de recursos
|
|
// © 2025 Port a C++20 amb SDL3
|
|
// Basat en el sistema de "pollo" amb adaptacions per Orni Attack
|
|
|
|
#pragma once
|
|
|
|
#include <cstdint>
|
|
#include <string>
|
|
#include <unordered_map>
|
|
#include <vector>
|
|
|
|
namespace Resource {
|
|
|
|
// Capçalera del fitxer de paquet
|
|
struct PackHeader {
|
|
char magic[4]; // "ORNI"
|
|
uint32_t version; // Versió del format (1)
|
|
};
|
|
|
|
// Entrada de recurs dins el paquet
|
|
struct ResourceEntry {
|
|
std::string filename; // Nom del recurs (amb barres normals)
|
|
uint64_t offset; // Posició dins el bloc de dades
|
|
uint64_t size; // Mida en bytes
|
|
uint32_t checksum; // Checksum CRC32 per verificació
|
|
};
|
|
|
|
// Classe principal per gestionar paquets de recursos
|
|
class Pack {
|
|
public:
|
|
Pack() = default;
|
|
~Pack() = default;
|
|
|
|
// Afegir fitxers al paquet
|
|
bool addFile(const std::string& filepath, const std::string& pack_name);
|
|
bool addDirectory(const std::string& dir_path, const std::string& base_path = "");
|
|
|
|
// Guardar i load paquets
|
|
bool savePack(const std::string& pack_file);
|
|
bool loadPack(const std::string& pack_file);
|
|
|
|
// Accés a recursos
|
|
std::vector<uint8_t> getResource(const std::string& filename);
|
|
[[nodiscard]] bool hasResource(const std::string& filename) const;
|
|
[[nodiscard]] std::vector<std::string> getResourceList() const;
|
|
|
|
// Validació
|
|
[[nodiscard]] bool validatePack() const;
|
|
|
|
private:
|
|
// Constants
|
|
static constexpr const char* MAGIC_HEADER = "ORNI";
|
|
static constexpr uint32_t VERSION = 1;
|
|
static constexpr const char* DEFAULT_ENCRYPT_KEY = "ORNI_RESOURCES_2025";
|
|
|
|
// Dades del paquet
|
|
std::unordered_map<std::string, ResourceEntry> resources_;
|
|
std::vector<uint8_t> data_;
|
|
|
|
// Funcions auxiliars
|
|
std::vector<uint8_t> readFile(const std::string& filepath);
|
|
[[nodiscard]] uint32_t calculateChecksum(const std::vector<uint8_t>& data) const;
|
|
void encryptData(std::vector<uint8_t>& data, const std::string& key);
|
|
void decryptData(std::vector<uint8_t>& data, const std::string& key);
|
|
};
|
|
|
|
} // namespace Resource
|