47 lines
2.1 KiB
C++
47 lines
2.1 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.
|
|
//
|
|
// El mateix patró aplica al gamepad: `getGamepadButton`/`getGamepadAxis`
|
|
// retornen zero/false quan el bloqueig és actiu. Els mandos concrets els
|
|
// obtén el caller via `GamepadManager::get().getPrimary()` o similars.
|
|
|
|
#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*;
|
|
|
|
// Versió filtrada de `SDL_GetGamepadButton`. Retorna false si el bloqueig
|
|
// és actiu o si `gp` és nullptr (cas habitual: no hi ha cap mand).
|
|
[[nodiscard]] auto getGamepadButton(SDL_Gamepad* gp, SDL_GamepadButton b) -> bool;
|
|
|
|
// Versió filtrada de `SDL_GetGamepadAxis`. Retorna 0 si el bloqueig
|
|
// és actiu o si `gp` és nullptr.
|
|
[[nodiscard]] auto getGamepadAxis(SDL_Gamepad* gp, SDL_GamepadAxis ax) -> Sint16;
|
|
|
|
} // namespace InputState
|