revisió de capçaleres

source/options.h

@@ -2,16 +2,17 @@
 
 #include <SDL3/SDL_gamepad.h>	  // Para SDL_GamepadButton
 #include <SDL3/SDL_surface.h>	  // Para SDL_ScaleMode
-#include <string>				  // Para string
-#include <vector>				  // Para vector
+#include <string>				  // Para std::string
+#include <vector>				  // Para std::vector
 #include "input.h"				  // Para InputAction, InputDeviceToUse
 #include "manage_hiscore_table.h" // Para HiScoreEntry
+
 namespace lang
 {
 	enum class Code : int;
-} // lines 11-11
+}
 
-// Dificultad del juego
+// --- Dificultad del juego ---
 enum class GameDifficulty
 {
 	EASY = 0,
@@ -19,58 +20,58 @@ enum class GameDifficulty
 	HARD = 2,
 };
 
-// Estructura para las opciones de la ventana
+// --- Opciones de la ventana ---
 struct WindowOptions
 {
-	std::string caption; // Texto que aparece en la barra de titulo de la ventana
-	int zoom = 1;		 // Contiene el valor por el que se multiplica el tamaño de la ventana
-	int max_zoom = 1;	 // Tamaño máximo para que el tamaño de la ventana no sea mayor que el tamaño de la pantalla
+	std::string caption; // Texto que aparece en la barra de título de la ventana
+	int zoom = 1;		 // Valor por el que se multiplica el tamaño de la ventana
+	int max_zoom = 1;	 // Tamaño máximo para que la ventana no sea mayor que la pantalla
 };
 
-// Estructura con opciones para el video
+// --- Opciones de vídeo ---
 struct VideoOptions
 {
 	SDL_ScaleMode scale_mode; // Filtro usado para el escalado de la imagen
-	bool fullscreen;		  // Contiene el valor del modo de pantalla completa
-	bool v_sync;			  // Indica si se quiere usar vsync o no
-	bool integer_scale;		  // Indica si se va a usar el escalado entero
-	bool shaders;			  // Indica si se van a usar shaders para los filtros de video
-	std::string info;		  // Información sobre el modo de video
+	bool fullscreen;		  // Indica si se usa pantalla completa
+	bool v_sync;			  // Indica si se usa vsync
+	bool integer_scale;		  // Indica si se usa escalado entero
+	bool shaders;			  // Indica si se usan shaders para los filtros de vídeo
+	std::string info;		  // Información sobre el modo de vídeo
 };
 
-// Estructura para las opciones de musica
+// --- Opciones de música ---
 struct MusicOptions
 {
-	bool enabled; // Indica si la musica suena o no
-	int volume;	  // Volumen al que suena la música
+	bool enabled; // Indica si la música suena o no
+	int volume;	  // Volumen de la música
 };
 
-// Estructura para las opciones de sonido
+// --- Opciones de sonido ---
 struct SoundOptions
 {
 	bool enabled; // Indica si los sonidos suenan o no
-	int volume;	  // Volumen al que suenan los sonidos
+	int volume;	  // Volumen de los sonidos
 };
 
-// Estructura para las opciones de audio
+// --- Opciones de audio ---
 struct AudioOptions
 {
 	MusicOptions music; // Opciones para la música
 	SoundOptions sound; // Opciones para los efectos de sonido
 	bool enabled;		// Indica si el audio está activo o no
-	int volume;			// Volumen al que suenan el audio
+	int volume;			// Volumen general del audio
 };
 
-// Estructura para las opciones del juego
+// --- Opciones del juego ---
 struct GameOptions
 {
 	GameDifficulty difficulty;						 // Dificultad del juego
 	lang::Code language;							 // Idioma usado en el juego
 	bool autofire;									 // Indicador de autofire
 	std::vector<HiScoreEntry> hi_score_table;		 // Tabla de mejores puntuaciones
-	std::vector<int> last_hi_score_entry = {-1, -1}; // Inicialización directa con dos elementos en -1
+	std::vector<int> last_hi_score_entry = {-1, -1}; // Últimas posiciones de entrada en la tabla
 
-	// Método para reiniciar las últimas entradas de puntuación
+	// Reinicia las últimas entradas de puntuación
 	void clear_last_hi_score_entries()
 	{
 		last_hi_score_entry[0] = -1;
@@ -78,16 +79,16 @@ struct GameOptions
 	}
 };
 
-// Estructura para los controles del juego
+// --- Opciones de mando ---
 struct GamepadOptions
 {
-	int index;								// Indice en el vector de mandos
+	int index;								// Índice en el vector de mandos
 	int player_id;							// Jugador asociado al mando
-	InputDeviceToUse type;					// Indica si se utilizará teclado o mando o ambos
+	InputDeviceToUse type;					// Indica si se usará teclado, mando o ambos
 	std::string name;						// Nombre del dispositivo
-	bool plugged;							// Indica si el mando se encuentra conectado
-	std::vector<InputAction> inputs;		// Listado de inputs
-	std::vector<SDL_GamepadButton> buttons; // Listado de botones asignados a cada input
+	bool plugged;							// Indica si el mando está conectado
+	std::vector<InputAction> inputs;		// Listado de acciones asignadas
+	std::vector<SDL_GamepadButton> buttons; // Listado de botones asignados a cada acción
 
 	// Constructor por defecto
 	GamepadOptions()
@@ -96,36 +97,24 @@ struct GamepadOptions
 		  buttons{SDL_GAMEPAD_BUTTON_WEST, SDL_GAMEPAD_BUTTON_NORTH, SDL_GAMEPAD_BUTTON_EAST, SDL_GAMEPAD_BUTTON_START, SDL_GAMEPAD_BUTTON_BACK} {}
 };
 
-// Estructura con todas las opciones de configuración del programa
+// --- Opciones generales del programa ---
 struct Options
 {
-	WindowOptions window;					 // Opciones para la ventana del programa
-	GameOptions game;						 // Opciones para el propio juego
-	VideoOptions video;						 // Opciones relativas a la clase screen
-	AudioOptions audio;						 // Opciones para el audio
-	std::vector<GamepadOptions> controllers; // Opciones con las asignaciones del mando para cada jugador
+	WindowOptions window;					 // Opciones de la ventana
+	GameOptions game;						 // Opciones del juego
+	VideoOptions video;						 // Opciones de vídeo
+	AudioOptions audio;						 // Opciones de audio
+	std::vector<GamepadOptions> controllers; // Opciones de mando para cada jugador
 };
 
-// Variables
+// --- Variables globales ---
 extern Options options;
 
-// Inicializa las opciones del programa
-void initOptions();
-
-// Carga el fichero de configuración
-bool loadOptionsFile(std::string file_path);
-
-// Guarda el fichero de configuración
-bool saveOptionsFile(std::string file_path);
-
-// Asigna el teclado al jugador
-void setKeyboardToPlayer(int player_id);
-
-// Intercambia el teclado de jugador
-void swapOptionsKeyboard();
-
-// Intercambia los jugadores asignados a los dos primeros mandos
-void swapOptionsControllers();
-
-// Averigua quien está usando el teclado
-int getPlayerWhoUsesKeyboard();
+// --- Funciones de configuración ---
+void initOptions();							 // Inicializa las opciones del programa
+bool loadOptionsFile(std::string file_path); // Carga el fichero de configuración
+bool saveOptionsFile(std::string file_path); // Guarda el fichero de configuración
+void setKeyboardToPlayer(int player_id);	 // Asigna el teclado al jugador
+void swapOptionsKeyboard();					 // Intercambia el teclado de jugador
+void swapOptionsControllers();				 // Intercambia los jugadores asignados a los dos primeros mandos
+int getPlayerWhoUsesKeyboard();				 // Averigua quién está usando el teclado