revisió de capçaleres

source/instructions.h

@@ -5,26 +5,27 @@
 #include <SDL3/SDL_stdinc.h> // Para Uint32
 #include <memory>			 // Para unique_ptr, shared_ptr
 #include <vector>			 // Para vector
-class Fade;					 // lines 8-8
-class Sprite;				 // lines 9-9
-class Text;					 // lines 10-10
-class Texture;				 // lines 11-11
-class TiledBG;				 // lines 12-12
+
+class Fade;
+class Sprite;
+class Text;
+class Texture;
+class TiledBG;
 
 /*
 	Esta clase gestiona un estado del programa. Se encarga de poner en pantalla
-	un texto explicativo para entender como se juega.
+	un texto explicativo para entender cómo se juega.
 
-	Ademas muestra algunos items y explica para qué sirven.
+	Además muestra algunos items y explica para qué sirven.
 
 	Utiliza dos texturas de apoyo, una con el texto ya escrito y otra donde se combina
 	tanto el texto de la primera textura como los sprites de los items.
 
 	Finalmente, una ventana recorre la textura para dar el efecto de que todo se desplaza
-	por la pantalla sobre el mosaico de fondo (gestionado por el correspondiente objeto)
+	por la pantalla sobre el mosaico de fondo (gestionado por el correspondiente objeto).
 */
 
-// Estructura para almacenar información de línea
+// Estructura para almacenar información de línea animada
 struct Line
 {
 	int y;			  // Coordenada Y de la línea
@@ -40,8 +41,18 @@ struct Line
 // Clase Instructions
 class Instructions
 {
+public:
+	// Constructor
+	Instructions();
+
+	// Destructor
+	~Instructions();
+
+	// Bucle principal
+	void run();
+
 private:
-	// Objetos y punteros
+	// --- Objetos y punteros ---
 	SDL_Renderer *renderer_;  // El renderizador de la ventana
 	SDL_Texture *texture_;	  // Textura fija con el texto
 	SDL_Texture *backbuffer_; // Textura para usar como backbuffer
@@ -52,7 +63,7 @@ private:
 	std::unique_ptr<TiledBG> tiled_bg_;					  // Objeto para dibujar el mosaico animado de fondo
 	std::unique_ptr<Fade> fade_;						  // Objeto para renderizar fades
 
-	// Variables
+	// --- Variables ---
 	int counter_ = 0;					 // Contador para manejar el progreso en la pantalla de instrucciones
 	Uint64 ticks_ = 0;					 // Contador de ticks para ajustar la velocidad del programa
 	SDL_FRect view_;					 // Vista del backbuffer que se va a mostrar por pantalla
@@ -63,49 +74,17 @@ private:
 	Uint32 start_delay_time_ = 0;		 // Tiempo de inicio del retraso para mover las líneas
 	bool start_delay_triggered_ = false; // Bandera para determinar si el retraso ha comenzado
 
-	// Actualiza las variables
-	void update();
-
-	// Pinta en pantalla
-	void render();
-
-	// Comprueba los eventos
-	void checkEvents();
-
-	// Comprueba las entradas
-	void checkInput();
-
-	// Rellena la textura de texto
-	void fillTexture();
-
-	// Rellena el backbuffer
-	void fillBackbuffer();
-
-	// Inicializa los sprites de los items
-	void iniSprites();
-
-	// Actualiza los sprites
-	void updateSprites();
-
-	// Método para inicializar las líneas
-	std::vector<Line> initializeLines(int height);
-
-	// Método para mover las líneas
-	bool moveLines(std::vector<Line> &lines, int width, float duration, Uint32 startDelay);
-
-	// Método para renderizar las líneas
-	void renderLines(SDL_Renderer *renderer, SDL_Texture *texture, const std::vector<Line> &lines);
-
-	// Gestiona la textura con los graficos
-	void updateBackbuffer();
-
-public:
-	// Constructor
-	Instructions();
-
-	// Destructor
-	~Instructions();
-
-	// Bucle principal
-	void run();
+	// --- Métodos internos ---
+	void update();																					// Actualiza las variables
+	void render();																					// Pinta en pantalla
+	void checkEvents();																				// Comprueba los eventos
+	void checkInput();																				// Comprueba las entradas
+	void fillTexture();																				// Rellena la textura de texto
+	void fillBackbuffer();																			// Rellena el backbuffer
+	void iniSprites();																				// Inicializa los sprites de los items
+	void updateSprites();																			// Actualiza los sprites
+	std::vector<Line> initializeLines(int height);													// Inicializa las líneas animadas
+	bool moveLines(std::vector<Line> &lines, int width, float duration, Uint32 startDelay);			// Mueve las líneas
+	void renderLines(SDL_Renderer *renderer, SDL_Texture *texture, const std::vector<Line> &lines); // Renderiza las líneas
+	void updateBackbuffer();																		// Gestiona la textura con los gráficos
 };