Afegit sistema de carrega de recursos on_demand

source/resource.h

@@ -19,10 +19,16 @@ struct JA_Sound_t;
 // --- Clase Resource: gestiona todos los recursos del juego (singleton) ---
 class Resource {
     public:
+        // --- Enum para el modo de carga ---
+        enum class LoadingMode {
+            PRELOAD,   // Carga todos los recursos al inicio
+            LAZY_LOAD  // Carga los recursos bajo demanda
+        };
+
         // --- Métodos de singleton ---
-        static void init();               // Inicializa el objeto Resource
-        static void destroy();            // Libera el objeto Resource
-        static auto get() -> Resource *;  // Obtiene el puntero al objeto Resource
+        static void init(LoadingMode mode = LoadingMode::PRELOAD);  // Inicializa el objeto Resource con modo de carga
+        static void destroy();                                      // Libera el objeto Resource
+        static auto get() -> Resource *;                            // Obtiene el puntero al objeto Resource
 
         // --- Métodos de acceso a recursos ---
         auto getSound(const std::string &name) -> JA_Sound_t *;                    // Obtiene el sonido por nombre
@@ -37,13 +43,16 @@ class Resource {
         void reload();          // Recarga todos los recursos
         void reloadTextures();  // Recarga solo las texturas
 
+        // --- Método para obtener el modo de carga actual ---
+        auto getLoadingMode() const -> LoadingMode { return loading_mode_; }
+
     private:
         // --- Estructuras para recursos individuales ---
         struct ResourceSound {
                 std::string name;   // Nombre del sonido
                 JA_Sound_t *sound;  // Objeto con el sonido
 
-                ResourceSound(std::string name, JA_Sound_t *sound)
+                ResourceSound(std::string name, JA_Sound_t *sound = nullptr)
                     : name(std::move(name)), sound(sound) {}
         };
 
@@ -51,7 +60,7 @@ class Resource {
                 std::string name;   // Nombre de la música
                 JA_Music_t *music;  // Objeto con la música
 
-                ResourceMusic(std::string name, JA_Music_t *music)
+                ResourceMusic(std::string name, JA_Music_t *music = nullptr)
                     : name(std::move(name)), music(music) {}
         };
 
@@ -59,7 +68,7 @@ class Resource {
                 std::string name;                  // Nombre de la textura
                 std::shared_ptr<Texture> texture;  // Objeto con la textura
 
-                ResourceTexture(std::string name, std::shared_ptr<Texture> texture)
+                ResourceTexture(std::string name, std::shared_ptr<Texture> texture = nullptr)
                     : name(std::move(name)), texture(std::move(texture)) {}
         };
 
@@ -67,7 +76,7 @@ class Resource {
                 std::string name;                       // Nombre del fichero
                 std::shared_ptr<Text::File> text_file;  // Objeto con los descriptores de la fuente de texto
 
-                ResourceTextFile(std::string name, std::shared_ptr<Text::File> text_file)
+                ResourceTextFile(std::string name, std::shared_ptr<Text::File> text_file = nullptr)
                     : name(std::move(name)), text_file(std::move(text_file)) {}
         };
 
@@ -75,7 +84,7 @@ class Resource {
                 std::string name;            // Nombre del objeto
                 std::shared_ptr<Text> text;  // Objeto de texto
 
-                ResourceText(std::string name, std::shared_ptr<Text> text)
+                ResourceText(std::string name, std::shared_ptr<Text> text = nullptr)
                     : name(std::move(name)), text(std::move(text)) {}
         };
 
@@ -83,7 +92,7 @@ class Resource {
                 std::string name;                // Nombre de la animación
                 AnimationsFileBuffer animation;  // Objeto con las animaciones
 
-                ResourceAnimation(std::string name, AnimationsFileBuffer animation)
+                ResourceAnimation(std::string name, AnimationsFileBuffer animation = {})
                     : name(std::move(name)), animation(std::move(animation)) {}
         };
 
@@ -102,6 +111,9 @@ class Resource {
                 }
         };
 
+        // --- Modo de carga ---
+        LoadingMode loading_mode_;
+
         // --- Vectores de recursos ---
         std::vector<ResourceSound> sounds_;          // Vector con los sonidos
         std::vector<ResourceMusic> musics_;          // Vector con las músicas
@@ -119,19 +131,32 @@ class Resource {
         SDL_FRect loading_full_rect_;
 
         // --- Métodos internos de carga y gestión ---
-        void loadSounds();      // Carga los sonidos
-        void loadMusics();      // Carga las músicas
-        void loadTextures();    // Carga las texturas
-        void loadTextFiles();   // Carga los ficheros de texto
-        void loadAnimations();  // Carga las animaciones
-        void loadDemoData();    // Carga los datos para el modo demostración
-        void addPalettes();     // Añade paletas a las texturas
-        void createTextures();  // Crea las texturas a partir de los datos cargados
-        void createText();      // Crea los objetos de texto
-        void clear();           // Vacía todos los vectores de recursos
-        void load();            // Carga todos los recursos
-        void clearSounds();     // Vacía el vector de sonidos
-        void clearMusics();     // Vacía el vector de músicas
+        void loadSounds();              // Carga los sonidos
+        void loadMusics();              // Carga las músicas
+        void loadTextures();            // Carga las texturas
+        void loadTextFiles();           // Carga los ficheros de texto
+        void loadAnimations();          // Carga las animaciones
+        void loadDemoData();            // Carga los datos para el modo demostración
+        void loadDemoDataQuiet();       // Carga los datos de demo sin mostrar progreso (para modo lazy)
+        void loadEssentialResources();  // Carga recursos esenciales en modo lazy
+        void loadEssentialTextures();   // Carga solo las texturas esenciales (fuentes)
+        void loadTextFilesQuiet();      // Carga ficheros de texto sin mostrar progreso (para modo lazy)
+        void addPalettes();             // Añade paletas a las texturas
+        void createTextures();          // Crea las texturas a partir de los datos cargados
+        void createText();              // Crea los objetos de texto
+        void clear();                   // Vacía todos los vectores de recursos
+        void load();                    // Carga todos los recursos
+        void clearSounds();             // Vacía el vector de sonidos
+        void clearMusics();             // Vacía el vector de músicas
+
+        // --- Métodos para carga perezosa ---
+        void initResourceLists();                                                       // Inicializa las listas de recursos sin cargar el contenido
+        auto loadSoundLazy(const std::string &name) -> JA_Sound_t *;                    // Carga un sonido específico bajo demanda
+        auto loadMusicLazy(const std::string &name) -> JA_Music_t *;                    // Carga una música específica bajo demanda
+        auto loadTextureLazy(const std::string &name) -> std::shared_ptr<Texture>;      // Carga una textura específica bajo demanda
+        auto loadTextFileLazy(const std::string &name) -> std::shared_ptr<Text::File>;  // Carga un fichero de texto específico bajo demanda
+        auto loadTextLazy(const std::string &name) -> std::shared_ptr<Text>;            // Carga un objeto de texto específico bajo demanda
+        auto loadAnimationLazy(const std::string &name) -> AnimationsFileBuffer;        // Carga una animación específica bajo demanda
 
         // --- Métodos internos para gestionar el progreso ---
         void calculateTotalResources();                // Calcula el número de recursos para cargar
@@ -142,8 +167,8 @@ class Resource {
         void updateProgressBar();                      // Actualiza la barra de estado
 
         // --- Constructores y destructor privados (singleton) ---
-        Resource();   // Constructor privado
-        ~Resource();  // Destructor privado
+        explicit Resource(LoadingMode mode);  // Constructor privado con modo de carga
+        ~Resource();                          // Destructor privado
 
         // --- Instancia singleton ---
         static Resource *instance;  // Instancia única de Resource