revisió de capçaleres

source/title.h

@@ -3,12 +3,13 @@
 #include <SDL3/SDL_stdinc.h> // Para Uint32
 #include <memory>			 // Para unique_ptr, shared_ptr
 #include "section.h"		 // Para Options
-class DefineButtons;		 // lines 5-5
-class Fade;					 // lines 6-6
-class GameLogo;				 // lines 7-7
-class Sprite;				 // lines 8-8
-class Text;					 // lines 9-9
-class TiledBG;				 // lines 11-11
+
+class DefineButtons;
+class Fade;
+class GameLogo;
+class Sprite;
+class Text;
+class TiledBG;
 
 // Textos
 constexpr const char TEXT_COPYRIGHT[] = "@2020,2025 JailDesigner";
@@ -17,86 +18,56 @@ constexpr const char TEXT_COPYRIGHT[] = "@2020,2025 JailDesigner";
 constexpr bool ALLOW_TITLE_ANIMATION_SKIP = false;
 
 /*
-	Esta clase gestiona un estado del programa. Se encarga de la parte del titulo o menu
-	que sirve para empezar a jugar. Utiliza otras clases para:
-		- Mostrar el logo del juego
-		- Dibujar el tileado de fondo
-		- Redifinir los botones de los mandos de juego
-
-	Esta clase tiene tres estados:
-		- El titulo está animandose, con el fondo estático
-		- El titulo ya está en su sitio y el fondo se está animando
-		- Se ha pulsado el botón de start
-
-	Por razones de diseño, no se permite saltarse la animación del titulo, aunque es
-	configurable mediante un define
+	Clase que gestiona el estado de título/menú principal del juego.
+	Responsable de mostrar el logo, el fondo animado y gestionar la entrada para comenzar la partida.
+	No permite saltar la animación del título salvo que se cambie el define.
 */
 
 // Clase Title
 class Title
 {
-private:
-	// Enumeraciones
-	enum class TitleState
-	{
-		LOGO_ANIMATING,
-		LOGO_FINISHED,
-		START_HAS_BEEN_PRESSED,
-	};
-
-	// Objetos y punteros
-	std::shared_ptr<Text> text_;					// Objeto de texto para poder escribir textos en pantalla
-	std::unique_ptr<Fade> fade_;					// Objeto para realizar fundidos en pantalla
-	std::unique_ptr<TiledBG> tiled_bg_;				// Objeto para dibujar el mosaico animado de fondo
-	std::unique_ptr<GameLogo> game_logo_;			// Objeto para dibujar el logo con el título del juego
-	std::unique_ptr<Sprite> mini_logo_sprite_;		// Sprite con el logo de JailGames mini
-	std::unique_ptr<DefineButtons> define_buttons_; // Objeto para definir los botones del joystic
-
-	// Variable
-	int counter_ = 0;												// Temporizador para la pantalla de titulo
-	Uint64 ticks_ = 0;												// Contador de ticks para ajustar la velocidad del programa
-	section::Name next_section_;									// Indica cual es la siguiente sección a cargar cuando termine el contador del titulo
-	section::Options selection_ = section::Options::TITLE_TIME_OUT; // Opción elegida en el titulo
-	int num_controllers_;											// Número de mandos conectados
-	TitleState state_;												// Estado en el que se encuentra la sección
-
-	// Actualiza las variables del objeto
-	void update();
-
-	// Dibuja el objeto en pantalla
-	void render();
-
-	// Comprueba los eventos
-	void checkEvents();
-
-	// Comprueba las entradas
-	void checkInput();
-
-	// Reinicia el contador interno
-	void resetCounter();
-
-	// Intercambia la asignación de mandos a los jugadores
-	void swapControllers();
-
-	// Intercambia el teclado de jugador
-	void swapKeyboard();
-
-	// Muestra información sobre los controles y los jugadores
-	void showControllers();
-
-	// Actualiza el fade
-	void updateFade();
-
-	// Actualiza el estado
-	void updateState();
-
 public:
-	// Constructor
+	// --- Constructores y destructor ---
 	Title();
-
-	// Destructor
 	~Title();
 
-	// Bucle para el titulo del juego
-	void run();
+	// --- Método principal ---
+	void run(); // Bucle para el título del juego
+
+private:
+	// --- Enumeraciones ---
+	enum class TitleState
+	{
+		LOGO_ANIMATING,			// El logo está animándose
+		LOGO_FINISHED,			// El logo ha terminado de animarse
+		START_HAS_BEEN_PRESSED, // Se ha pulsado el botón de start
+	};
+
+	// --- Objetos y punteros ---
+	std::shared_ptr<Text> text_;					// Objeto de texto para escribir en pantalla
+	std::unique_ptr<Fade> fade_;					// Fundido en pantalla
+	std::unique_ptr<TiledBG> tiled_bg_;				// Fondo animado de tiles
+	std::unique_ptr<GameLogo> game_logo_;			// Logo del juego
+	std::unique_ptr<Sprite> mini_logo_sprite_;		// Logo JailGames mini
+	std::unique_ptr<DefineButtons> define_buttons_; // Definición de botones del joystick
+
+	// --- Variables de estado ---
+	int counter_ = 0;												// Temporizador para la pantalla de título
+	Uint64 ticks_ = 0;												// Contador de ticks para ajustar la velocidad
+	section::Name next_section_;									// Siguiente sección a cargar
+	section::Options selection_ = section::Options::TITLE_TIME_OUT; // Opción elegida en el título
+	int num_controllers_;											// Número de mandos conectados
+	TitleState state_;												// Estado actual de la sección
+
+	// --- Métodos internos ---
+	void update();			// Actualiza las variables del objeto
+	void render();			// Dibuja el objeto en pantalla
+	void checkEvents();		// Comprueba los eventos
+	void checkInput();		// Comprueba las entradas
+	void resetCounter();	// Reinicia el contador interno
+	void swapControllers(); // Intercambia la asignación de mandos a los jugadores
+	void swapKeyboard();	// Intercambia el teclado de jugador
+	void showControllers(); // Muestra información sobre los controles y los jugadores
+	void updateFade();		// Actualiza el fade
+	void updateState();		// Actualiza el estado
 };