refactor(core/rendering): injectar font i paleta als overlays (COUP-04) + tancament auditoria

Notifier::init i RenderInfo::init cridaven Resource::Cache::get() i
construïen cadascun la seua pròpia instància de Text a partir de
"8bithud.gif" + "data/font/8bithud.fnt" (strings hardcoded). Notifier
també llegia la paleta "ui" a cada render().

Ara:
- Director construeix una sola std::shared_ptr<Text> compartida.
- RenderInfo::init(Frame, shared_ptr<Text>) i Notifier::init
  (shared_ptr<Text>, const Palette&) reben els recursos injectats.
- Notifier desa la Palette una volta i la consulta localment a
  render(), sense tocar el cache global.

Resultat: els overlays perden la dependència dels noms dels assets
i del cache; el cicle de vida queda controlat pel Director. El camp
intern text_ passa a shared_ptr<Text>.

El document d'auditoria es tanca:
- PATCH-02, COUP-05 → DEFERRED (feature beyond cleanup scope).
- INC-04 → WONTFIX (coexistència justificada de writeDX/write*).
- Estat global: neteja completada.

Build + smoke 5s xvfb OK (exit 124).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
JailDesignerandClaude Opus 4.7 committed 2026-04-20 10:05:58 +02:00
1 parent f692739fed
commit 32d6067752
6 files changed
+39 -27

No files matched your search

+8 -11
View File
@@ -1,9 +1,9 @@
#include "core/rendering/notifier.hpp"
#include <utility>
#include "core/rendering/screen.hpp"
#include "core/rendering/surface.hpp"
#include "core/rendering/text.hpp"
#include "core/resources/resource_cache.hpp"
#include "utils/defines.hpp"
auto Notifier::get() -> Notifier& {
@@ -13,11 +13,9 @@ auto Notifier::get() -> Notifier& {
Notifier::~Notifier() = default;
void Notifier::init() {
// El Director preloade la paleta "ui" i la surface "8bithud.gif" abans
// de cridar aquest init(); ací només cal construir el Text.
auto font_surface = Resource::Cache::get().getSurface("8bithud.gif");
text_ = std::make_unique<Text>(font_surface, "data/font/8bithud.fnt");
void Notifier::init(std::shared_ptr<Text> text, const Palette& ui_palette) {
text_ = std::move(text);
ui_palette_ = ui_palette;
}
void Notifier::update(int delta_ms) {
@@ -54,10 +52,9 @@ void Notifier::render() {
const int BOX_X = (GameCanvas::WIDTH - BOX_W) / 2;
const int BOX_Y = static_cast<int>(y_);
// Fons sòlid a través de la paleta "ui" (ARGB directe al canvas, sense
// tocar cap surface paletada).
const auto& ui_palette = Resource::Cache::get().getPalette("ui");
Screen::get().fillRect(BOX_X, BOX_Y, BOX_W, HEIGHT, ui_palette[current_bg_color_]);
// Fons sòlid amb la paleta UI que ens ha injectat el caller a init()
// (ARGB directe al canvas, sense tocar cap surface paletada).
Screen::get().fillRect(BOX_X, BOX_Y, BOX_W, HEIGHT, ui_palette_[current_bg_color_]);
text_->writeDX(Text::CENTER_FLAG | Text::COLOR_FLAG,
GameCanvas::CENTER_X,
+6 -2
View File
@@ -7,6 +7,7 @@
#include <string>
#include "core/rendering/hud_constants.hpp"
#include "core/rendering/surface.hpp"
class Text;
@@ -27,7 +28,9 @@ class Notifier {
auto operator=(const Notifier&) -> Notifier& = delete;
auto operator=(Notifier&&) -> Notifier& = delete;
void init();
// Injecta la font compartida i la paleta UI que usa la caixa de fons.
// Així Notifier no depèn de cap string de recurs ni del cache global.
void init(std::shared_ptr<Text> text, const Palette& ui_palette);
void update(int delta_ms);
void render();
@@ -49,7 +52,8 @@ class Notifier {
Notifier() = default;
~Notifier();
std::unique_ptr<Text> text_;
std::shared_ptr<Text> text_;
Palette ui_palette_{};
Status status_{Status::HIDDEN};
float y_{static_cast<float>(-HEIGHT - MARGIN_TOP)};
std::string current_text_;
+3 -4
View File
@@ -5,11 +5,11 @@
#include <cctype>
#include <cstdio>
#include <string>
#include <utility>
#include "core/rendering/hud_constants.hpp"
#include "core/rendering/screen.hpp"
#include "core/rendering/text.hpp"
#include "core/resources/resource_cache.hpp"
#include "utils/defines.hpp"
#include "utils/easing.hpp"
@@ -57,9 +57,8 @@ auto RenderInfo::get() -> RenderInfo& {
RenderInfo::~RenderInfo() = default;
void RenderInfo::init(const Frame& initial) {
auto font_surface = Resource::Cache::get().getSurface("8bithud.gif");
text_ = std::make_unique<Text>(font_surface, "data/font/8bithud.fnt");
void RenderInfo::init(const Frame& initial, std::shared_ptr<Text> text) {
text_ = std::move(text);
current_ = initial;
+5 -2
View File
@@ -38,7 +38,10 @@ class RenderInfo {
Uint8 shadow_color{0};
};
void init(const Frame& initial);
// Injecta la font compartida a init(). La resta de l'estat visual ve
// pel Frame a cada frame, així que RenderInfo no depèn de cap recurs
// global.
void init(const Frame& initial, std::shared_ptr<Text> text);
void update(int delta_ms, const Frame& frame);
void render();
@@ -62,7 +65,7 @@ class RenderInfo {
void refreshSegments();
[[nodiscard]] auto segmentWidth(const Segment& seg, int digit_cell_w) const -> int;
std::unique_ptr<Text> text_;
std::shared_ptr<Text> text_;
Defaults::RenderInfoPosition visible_pos_{Defaults::RenderInfoPosition::OFF};
float info_anim_{0.0F}; // 0..1, suavitzat amb outQuad al render
std::array<Segment, SEGMENT_COUNT> segments_{};