47 lines
2.2 KiB
C++
47 lines
2.2 KiB
C++
#pragma once
|
|
|
|
// Wrapper de l'estat d'input (polling) amb gating de bloqueig.
|
|
//
|
|
// El service menu (i qualsevol UI modal futura) ha de poder "amagar" l'estat
|
|
// d'entrada als consumidors de polling — el jugador, entitats controlades
|
|
// per l'usuari, etc. — mentre la UI captura l'atenció, sense interrompre la
|
|
// resta del joc. Per això tots els consumidors de polling han de llegir a
|
|
// través d'aquest mòdul i no cridar `SDL_GetKeyboardState` directament. Si
|
|
// `setBlocked(true)` està actiu, el wrapper retorna un buffer tot-a-zero;
|
|
// altrament, la crida és transparent (mateix pointer que SDL).
|
|
//
|
|
// El menú NO passa per aquí: consumeix events (`SDL_EVENT_KEY_DOWN`) abans
|
|
// que l'escena els vegi, així que la seva navegació segueix funcionant per
|
|
// molt que el flag estigui posat.
|
|
//
|
|
// --- Nota per a l'extensió a gamepad (pròxima iteració) ---
|
|
// Quan s'afegeixi suport de comandament, el jugador haurà de llegir eixos
|
|
// i botons via polling (p.ex. `SDL_GetGamepadAxis`/`SDL_GetGamepadButton`).
|
|
// Aquest mòdul s'ha d'ampliar amb:
|
|
// [[nodiscard]] auto getGamepadAxis(SDL_Gamepad* gp, SDL_GamepadAxis ax)
|
|
// -> Sint16; // 0 si bloquejat
|
|
// [[nodiscard]] auto getGamepadButton(SDL_Gamepad* gp, SDL_GamepadButton b)
|
|
// -> bool; // false si bloquejat
|
|
// Mateix patró: zero/false quan `blocked_`, pass-through altrament. Així
|
|
// Player (i el que sigui) només ha de canviar el nom de la crida; el menú
|
|
// no ha de saber res del gamepad més enllà de processar els seus events.
|
|
|
|
#include <SDL3/SDL.h>
|
|
|
|
namespace InputState {
|
|
|
|
// Activa/desactiva el bloqueig global de polling. El ServiceMenu el
|
|
// crida a `toggle()`/`close()`. No es toca des de cap altre lloc.
|
|
void setBlocked(bool value);
|
|
|
|
[[nodiscard]] auto isBlocked() -> bool;
|
|
|
|
// Equivalent a `SDL_GetKeyboardState(nullptr)`: retorna un buffer de
|
|
// `SDL_SCANCODE_COUNT` bools. Si l'input està bloquejat, tots zero —
|
|
// el consumidor veu com si cap tecla estigués premuda, sense branques
|
|
// explícites. El buffer és estable mentre dura la sessió; no cal
|
|
// guardar-lo frame a frame.
|
|
[[nodiscard]] auto getKeyboardState() -> const bool*;
|
|
|
|
} // namespace InputState
|