primer commit

source/core/rendering/surface_animated_sprite.hpp

@@ -0,0 +1,59 @@
+#pragma once
+
+#include <SDL3/SDL.h>
+
+#include <memory>  // Para shared_ptr
+#include <string>  // Para string
+#include <utility>
+#include <vector>  // Para vector
+
+#include "core/rendering/surface_moving_sprite.hpp"  // Para SMovingSprite
+#include "core/resources/resource_types.hpp"         // Para AnimationResource
+
+class Surface;
+
+class SurfaceAnimatedSprite : public SurfaceMovingSprite {
+    public:
+        using Animations = std::vector<std::string>;  // Tipo para lista de animaciones
+
+        // Estructura pública de datos de animación
+        struct AnimationData {
+                std::string name;               // Nombre de la animacion
+                std::vector<SDL_FRect> frames;  // Cada uno de los frames que componen la animación
+                float speed{0.083F};            // Velocidad de la animación (segundos por frame)
+                int loop{0};                    // Indica a que frame vuelve la animación al terminar. -1 para que no vuelva
+                bool completed{false};          // Indica si ha finalizado la animación
+                int current_frame{0};           // Frame actual
+                float accumulated_time{0.0F};   // Tiempo acumulado para las animaciones (time-based)
+        };
+
+        // Métodos estáticos
+        static auto loadAnimationsFromYAML(const std::string& file_path, std::shared_ptr<Surface>& surface, float& frame_width, float& frame_height) -> std::vector<AnimationData>;  // Carga las animaciones desde fichero YAML
+
+        // Constructores
+        explicit SurfaceAnimatedSprite(const AnimationResource& cached_data);  // Constructor con datos pre-cargados del cache
+
+        ~SurfaceAnimatedSprite() override = default;  // Destructor
+
+        void update(float delta_time) override;  // Actualiza las variables del objeto (time-based)
+
+        // Consultas de estado
+        auto animationIsCompleted() -> bool;                                                                               // Comprueba si ha terminado la animación
+        auto getIndex(const std::string& name) -> int;                                                                     // Obtiene el índice de la animación por nombre
+        auto getCurrentAnimationSize() -> int { return static_cast<int>(animations_[current_animation_].frames.size()); }  // Número de frames de la animación actual
+
+        // Modificadores de animación
+        void setCurrentAnimation(const std::string& name = "default");  // Establece la animación actual por nombre
+        void setCurrentAnimation(int index = 0);                        // Establece la animación actual por índice
+        void resetAnimation();                                          // Reinicia la animación
+        void setCurrentAnimationFrame(int num);                         // Establece el frame actual de la animación
+
+    protected:
+        // Métodos protegidos
+        void animate(float delta_time);  // Calcula el frame correspondiente a la animación actual (time-based)
+
+    private:
+        // Variables miembro
+        std::vector<AnimationData> animations_;  // Vector con las diferentes animaciones
+        int current_animation_{0};               // Animación activa
+};