53 lines
2.1 KiB
C++
53 lines
2.1 KiB
C++
#pragma once
|
|
|
|
#include <cstdint>
|
|
|
|
// Abstracció mínima del destí de renderitzat CPU. Tots els blitters del
|
|
// projecte (Surface, els HUDs via Screen::fillRect, ...) emeten píxels en
|
|
// format ARGB8888 sobre una única superfície lògica que el backend GPU
|
|
// després transfereix a la textura "scene". L'accés va per la funció
|
|
// activeCanvas() en lloc de Screen::get() directament, per a que els
|
|
// consumidors no depenguen del cicle de vida de Screen ni del seu header.
|
|
namespace Rendering {
|
|
|
|
// Bit alpha completament opac, ja preposicionat al canal alt del
|
|
// píxel ARGB8888. Qualsevol RGB | OPAQUE_ALPHA produeix el píxel final.
|
|
inline constexpr std::uint32_t OPAQUE_ALPHA = 0xFF000000U;
|
|
|
|
struct Canvas {
|
|
std::uint32_t* pixels{nullptr};
|
|
int width{0};
|
|
int height{0};
|
|
};
|
|
|
|
// Rectangle de clip (en píxels de canvas). Els blitters han de comprovar
|
|
// `clip` abans d'escriure cada píxel; fora del rectangle no es dibuixa.
|
|
// `push/pop` permet niar clips (tot i que de moment només en tenim un
|
|
// nivell d'ús, el menú). Si la pila és buida, `activeClip` retorna el
|
|
// canvas complet — comportament "sense clip".
|
|
struct Clip {
|
|
int x{0};
|
|
int y{0};
|
|
int w{0};
|
|
int h{0};
|
|
};
|
|
|
|
// Retorna el canvas actiu del joc. En aquesta fase del projecte n'hi ha
|
|
// sempre un i només un (el de Screen); en el futur, si cal renderitzar
|
|
// off-screen (miniatures, efectes), es podrà pushejar/popar per ací.
|
|
[[nodiscard]] auto activeCanvas() -> Canvas;
|
|
|
|
// Clip actiu. Si ningú ha fet push, és tot el canvas.
|
|
[[nodiscard]] auto activeClip() -> Clip;
|
|
|
|
// Restringeix el dibuix al rectangle donat fins al proper popClip().
|
|
// El rectangle es retalla contra el canvas (cap clip pot excedir els
|
|
// seus límits, així els blitters poden assumir-los sans).
|
|
void pushClip(Clip rect);
|
|
|
|
// Desapila el clip actiu i restaura l'anterior. Si no hi havia cap
|
|
// push previ, l'operació és idempotent i queda a "canvas complet".
|
|
void popClip();
|
|
|
|
} // namespace Rendering
|