Files
aee-arcade/source/core/rendering/notifier.hpp
T

76 lines
2.6 KiB
C++

#pragma once
#include <SDL3/SDL.h>
#include <cstdint>
#include <memory>
#include <string>
#include <vector>
#include "core/rendering/hud_constants.hpp"
#include "core/rendering/surface.hpp"
#include "utils/defines.hpp"
class Text;
// Popup transitori a dalt i centrat. Entra lliscant des de dalt, es queda
// visible el temps configurat i surt lliscant cap amunt. Comparteix la font
// 8bithud i la paleta "ui" amb la resta d'overlays (carregades per RenderInfo
// a l'arrencada; si Notifier::init() es crida primer, les carrega ell).
//
// API crua: Notifier::get().notify(text, text_color, bg_color, time_ms).
// Per a treballar amb presets pre-definits, vegeu Notification::notify() a
// core/rendering/notification_presets.hpp.
//
// Multilinia: si el text passa de l'amplada màxima (`MAX_TEXT_WIDTH`), es
// parteix per espais i la caixa creix en alçada automàticament. Els textos
// curts (cas habitual) ocupen una sola línia i no canvien d'aspecte.
class Notifier {
public:
static auto get() -> Notifier&;
Notifier(const Notifier&) = delete;
Notifier(Notifier&&) = delete;
auto operator=(const Notifier&) -> Notifier& = delete;
auto operator=(Notifier&&) -> Notifier& = delete;
// 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();
void notify(const std::string& text, Uint8 text_color, Uint8 bg_color, int time_ms);
static constexpr int PADDING_H = 6;
static constexpr int PADDING_V = 3;
static constexpr int LINE_GAP = 1; // Separació vertical entre línies multilinia.
static constexpr int MARGIN_TOP = 2; // Separació amb la vora superior del canvas.
static constexpr float SLIDE_SPEED = 120.0F;
// Amplada màxima (sense comptar padding) que pot ocupar el text abans que
// `wrapToWidth` el parteixi en línies. Deixem marge respecte a la vora del
// canvas perquè la caixa no toqui els laterals.
static constexpr int MAX_TEXT_WIDTH = GameCanvas::WIDTH - 20 - (2 * PADDING_H);
private:
enum class Status : std::uint8_t { HIDDEN,
RISING,
ACTIVE,
VANISHING };
Notifier() = default;
~Notifier();
std::shared_ptr<Text> text_;
Palette ui_palette_{};
Status status_{Status::HIDDEN};
float y_{0.0F};
std::vector<std::string> current_lines_;
int current_box_w_{0};
int current_box_h_{0};
Uint8 current_text_color_{0};
Uint8 current_bg_color_{0};
int remaining_ms_{0};
};