Entrada, audio e interfaz
Asignación de acciones, mandos, atajos globales, reproducción sonora y widgets TGUI.
En esta página
Una acción, varias entradas
InputManager utiliza identificadores enteros de acción y un unordered_multimap de bindings. Una acción puede asociarse a más de una entrada. Pressed(action) devuelve verdadero cuando alguna de las asignaciones está presionada.
Los tipos de binding de la revisión de referencia son:
struct Keyboard {
sf::Keyboard::Scan key;
};
struct Mouse {
sf::Mouse::Button button;
};
struct Gamepad {
GamepadButton button;
int id = 0;
};
struct Axis {
sf::Joystick::Axis axis;
float threshold = 0.5f;
int id = 0;
};
using Binding = std::variant<Keyboard, Mouse, Gamepad, Axis>;Estos tipos pertenecen al namespace Input. La consulta es de estado actual, no un detector automático del instante de pulsación. Para eventos discretos, las escenas también disponen de OnEvent.
Los ejes se normalizan dividiendo su valor entre 100 y se comparan con el umbral positivo o negativo configurado. Engine limpia los bindings al cambiar de escena; cada juego debe volver a establecer los suyos al comenzar.
Mandos y cursor
El código contiene tablas de botones lógicos para Xbox y PlayStation. Selecciona la tabla Xbox cuando identifica el vendor de Microsoft; utiliza la tabla PlayStation en los demás casos. Esta heurística no garantiza que todo mando tenga el mismo mapeo.
Los gatillos L2/R2 no tienen botón en la tabla Xbox: su entrada figura como no disponible en ese mapeo de botones. Los ejes son un tipo de binding independiente.
CursorManager permite mover el cursor con el stick, respetando joystickDeadzone. También convierte la posición del ratón a coordenadas de una vista. GuiManager transforma el botón lógico South en eventos de clic para los widgets.
Atajos globales
| Entrada | Acción |
|---|---|
| F12 | Guardar una captura PNG. |
| R | Reiniciar la escena activa. |
| Escape / Start del mando | Alternar el overlay de pausa. |
| M / Select del mando | Solicitar Menu; esa escena no está registrada en la revisión documentada. |
Los atajos se procesan en EngineVisitor. La pérdida de foco pausa la escena. Al recuperarlo, se reanuda únicamente si el overlay no sigue abierto.
Audio de la revisión de referencia
AudioManager expone volumen global y posición/dirección del listener mediante SFML. ResourceManager entrega buffers de sonido y objetos de música; la escena posee las fuentes y controla su reproducción.
void AudioManager::SetGlobalVolume(float volume) {
sf::Listener::setGlobalVolume(volume);
}En esta revisión, los juegos coordinan su propio audio durante OnPause y OnCleanup. No hay un mezclador de buses configurable ni un editor de audio documentado.
Trabajo local en desarrollo
Durante la auditoría se encontraron AudioGroup.h y AudioGroup.cpp como archivos aún no incluidos en el commit de referencia. Agrupan fuentes por escena, distinguen canales Music/Effect y recuerdan cuáles estaban reproduciéndose antes de pausar.
También hay cambios locales para un reloj compartido de cooldowns. Son implementaciones observadas, pero no forman parte de los ejemplos públicos de esta guía. No uses esas API esperando encontrarlas en el commit enlazado.
Interfaz TGUI
GuiManager conecta TGUI con la ventana SFML. Carga Content/Themes/Dark.txt, aplica la fuente Relidux.otf, habilita el uso de Tab y proporciona métodos para añadir o retirar widgets.
El overlay crea botones a partir de OverlaySelection usando magic_enum. La selección se consume una vez y Engine ejecuta la acción correspondiente. La GUI se dibuja después del posprocesado de la escena.