Refactorizar estilo del proyecto: .h → .hpp, #pragma once, includes desde raíz
Modernizar convenciones de código C++ aplicando las siguientes directivas:
## Cambios principales
**1. Renombrar headers (.h → .hpp)**
- 36 archivos renombrados a extensión .hpp (estándar C++)
- Mantenidos como .h: stb_image.h, stb_image_resize2.h (librerías C externas)
**2. Modernizar include guards (#ifndef → #pragma once)**
- resource_manager.hpp: #ifndef RESOURCE_MANAGER_H → #pragma once
- resource_pack.hpp: #ifndef RESOURCE_PACK_H → #pragma once
- spatial_grid.hpp: #ifndef SPATIAL_GRID_H → #pragma once
**3. Sistema de includes desde raíz del proyecto**
- CMakeLists.txt: añadido include_directories(${CMAKE_SOURCE_DIR}/source)
- Eliminadas rutas relativas (../) en todos los includes
- Includes ahora usan rutas absolutas desde source/
**Antes:**
```cpp
#include "../defines.h"
#include "../text/textrenderer.h"
```
**Ahora:**
```cpp
#include "defines.hpp"
#include "text/textrenderer.hpp"
```
## Archivos afectados
- 1 archivo CMakeLists.txt modificado
- 36 archivos renombrados (.h → .hpp)
- 32 archivos .cpp actualizados (includes)
- 36 archivos .hpp actualizados (includes + guards)
- 1 archivo tools/ actualizado
**Total: 70 archivos modificados**
## Verificación
✅ Proyecto compila sin errores
✅ Todas las rutas de includes correctas
✅ Include guards modernizados
✅ Librerías externas C mantienen extensión .h
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
196
source/state/state_manager.hpp
Normal file
196
source/state/state_manager.hpp
Normal file
@@ -0,0 +1,196 @@
|
||||
#pragma once
|
||||
|
||||
#include <SDL3/SDL_stdinc.h> // for Uint64
|
||||
#include <cstddef> // for size_t
|
||||
|
||||
#include "defines.hpp" // for AppMode, ShapeType, GravityDirection
|
||||
|
||||
// Forward declarations
|
||||
class Engine;
|
||||
class Shape;
|
||||
class PNGShape;
|
||||
|
||||
/**
|
||||
* @class StateManager
|
||||
* @brief Gestiona los estados de aplicación (SANDBOX/DEMO/DEMO_LITE/LOGO)
|
||||
*
|
||||
* Responsabilidad única: Máquina de estados y lógica de modos automáticos
|
||||
*
|
||||
* Características:
|
||||
* - Control de modo DEMO (auto-play completo)
|
||||
* - Control de modo DEMO_LITE (solo física/figuras)
|
||||
* - Control de modo LOGO (easter egg con convergencia)
|
||||
* - Timers y triggers automáticos
|
||||
* - Sistema de convergencia y espera de flips
|
||||
* - Callbacks al Engine para ejecutar acciones
|
||||
*/
|
||||
class StateManager {
|
||||
public:
|
||||
/**
|
||||
* @brief Constructor
|
||||
*/
|
||||
StateManager();
|
||||
|
||||
/**
|
||||
* @brief Destructor
|
||||
*/
|
||||
~StateManager();
|
||||
|
||||
/**
|
||||
* @brief Inicializa el StateManager con referencia al Engine
|
||||
* @param engine Puntero al Engine (para callbacks)
|
||||
*/
|
||||
void initialize(Engine* engine);
|
||||
|
||||
/**
|
||||
* @brief Actualiza la máquina de estados (timers, triggers, acciones)
|
||||
* @param delta_time Delta time para timers
|
||||
* @param shape_convergence Convergencia actual de la forma (0.0-1.0)
|
||||
* @param active_shape Puntero a la forma activa (para flip detection)
|
||||
*/
|
||||
void update(float delta_time, float shape_convergence, Shape* active_shape);
|
||||
|
||||
/**
|
||||
* @brief Cambia el estado de aplicación
|
||||
* @param new_mode Nuevo modo (SANDBOX/DEMO/DEMO_LITE/LOGO)
|
||||
* @param current_screen_width Ancho de pantalla (para escalar tiempos)
|
||||
* @param current_screen_height Alto de pantalla (para escalar tiempos)
|
||||
*/
|
||||
void setState(AppMode new_mode, int current_screen_width, int current_screen_height);
|
||||
|
||||
/**
|
||||
* @brief Toggle del modo DEMO completo (tecla L)
|
||||
* @param current_screen_width Ancho de pantalla
|
||||
* @param current_screen_height Alto de pantalla
|
||||
*/
|
||||
void toggleDemoMode(int current_screen_width, int current_screen_height);
|
||||
|
||||
/**
|
||||
* @brief Toggle del modo DEMO_LITE (tecla L x2)
|
||||
* @param current_screen_width Ancho de pantalla
|
||||
* @param current_screen_height Alto de pantalla
|
||||
*/
|
||||
void toggleDemoLiteMode(int current_screen_width, int current_screen_height);
|
||||
|
||||
/**
|
||||
* @brief Toggle del modo LOGO (tecla K)
|
||||
* @param current_screen_width Ancho de pantalla
|
||||
* @param current_screen_height Alto de pantalla
|
||||
* @param ball_count Número de bolas actual
|
||||
*/
|
||||
void toggleLogoMode(int current_screen_width, int current_screen_height, size_t ball_count);
|
||||
|
||||
// === Getters ===
|
||||
|
||||
/**
|
||||
* @brief Obtiene el modo actual
|
||||
*/
|
||||
AppMode getCurrentMode() const { return current_app_mode_; }
|
||||
|
||||
/**
|
||||
* @brief Obtiene el modo previo (antes de LOGO)
|
||||
*/
|
||||
AppMode getPreviousMode() const { return previous_app_mode_; }
|
||||
|
||||
/**
|
||||
* @brief Verifica si LOGO está activo
|
||||
*/
|
||||
bool isLogoModeActive() const { return current_app_mode_ == AppMode::LOGO; }
|
||||
|
||||
/**
|
||||
* @brief Verifica si DEMO (completo o lite) está activo
|
||||
*/
|
||||
bool isDemoModeActive() const {
|
||||
return current_app_mode_ == AppMode::DEMO || current_app_mode_ == AppMode::DEMO_LITE;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief Obtiene índice de tema guardado (para restaurar al salir de LOGO)
|
||||
*/
|
||||
int getLogoPreviousTheme() const { return logo_previous_theme_; }
|
||||
|
||||
/**
|
||||
* @brief Obtiene índice de textura guardada (para restaurar al salir de LOGO)
|
||||
*/
|
||||
size_t getLogoPreviousTextureIndex() const { return logo_previous_texture_index_; }
|
||||
|
||||
/**
|
||||
* @brief Obtiene escala de forma guardada (para restaurar al salir de LOGO)
|
||||
*/
|
||||
float getLogoPreviousShapeScale() const { return logo_previous_shape_scale_; }
|
||||
|
||||
/**
|
||||
* @brief Obtiene si LOGO fue activado manualmente (tecla K) o automáticamente (desde DEMO)
|
||||
*/
|
||||
bool getLogoEnteredManually() const { return logo_entered_manually_; }
|
||||
|
||||
/**
|
||||
* @brief Establece valores previos de LOGO (llamado por Engine antes de entrar)
|
||||
*/
|
||||
void setLogoPreviousState(int theme, size_t texture_index, float shape_scale);
|
||||
|
||||
/**
|
||||
* @brief Entra al modo LOGO (público para permitir salto automático desde DEMO)
|
||||
* @param from_demo true si viene desde DEMO, false si es manual
|
||||
* @param current_screen_width Ancho de pantalla
|
||||
* @param current_screen_height Alto de pantalla
|
||||
* @param ball_count Número de bolas
|
||||
*/
|
||||
void enterLogoMode(bool from_demo, int current_screen_width, int current_screen_height, size_t ball_count);
|
||||
|
||||
/**
|
||||
* @brief Sale del modo LOGO (público para permitir salida manual)
|
||||
* @param return_to_demo true si debe volver a DEMO/DEMO_LITE
|
||||
*/
|
||||
void exitLogoMode(bool return_to_demo);
|
||||
|
||||
private:
|
||||
// === Referencia al Engine (callback) ===
|
||||
Engine* engine_;
|
||||
|
||||
// === Estado de aplicación ===
|
||||
AppMode current_app_mode_;
|
||||
AppMode previous_app_mode_;
|
||||
|
||||
// === Sistema DEMO (timers) ===
|
||||
float demo_timer_;
|
||||
float demo_next_action_time_;
|
||||
|
||||
// === Sistema LOGO (convergencia) ===
|
||||
float logo_convergence_threshold_;
|
||||
float logo_min_time_;
|
||||
float logo_max_time_;
|
||||
|
||||
// === Sistema LOGO (espera de flips) ===
|
||||
bool logo_waiting_for_flip_;
|
||||
int logo_target_flip_number_;
|
||||
float logo_target_flip_percentage_;
|
||||
int logo_current_flip_count_;
|
||||
|
||||
// === Control de entrada LOGO ===
|
||||
bool logo_entered_manually_;
|
||||
|
||||
// === Estado previo LOGO (restauración) ===
|
||||
int logo_previous_theme_;
|
||||
size_t logo_previous_texture_index_;
|
||||
float logo_previous_shape_scale_;
|
||||
|
||||
// === Métodos privados ===
|
||||
|
||||
/**
|
||||
* @brief Ejecuta una acción del modo DEMO
|
||||
* @param is_lite true si es DEMO_LITE, false si es DEMO completo
|
||||
*/
|
||||
void performDemoAction(bool is_lite);
|
||||
|
||||
/**
|
||||
* @brief Randomiza estado al entrar a modo DEMO
|
||||
* @param is_lite true si es DEMO_LITE, false si es DEMO completo
|
||||
*/
|
||||
void randomizeOnDemoStart(bool is_lite);
|
||||
|
||||
/**
|
||||
* @brief Toggle de gravedad ON/OFF (para DEMO)
|
||||
*/
|
||||
void toggleGravityOnOff();
|
||||
};
|
||||
Reference in New Issue
Block a user