jdd_opendingux/source/game/scenes/ending.hpp

#pragma once

#include <SDL3/SDL.h>

#include <memory>     // Para shared_ptr
#include <string>     // Para string
#include <vector>     // Para vector
class SurfaceSprite;  // lines 8-8
class Surface;        // lines 9-9
class DeltaTimer;

class Ending {
    public:
        // --- Constructor y Destructor ---
        Ending();
        ~Ending() = default;

        // --- Bucle principal ---
        void run();

    private:
        // --- Estados ---
        enum class State {
            WARMING_UP,
            SCENE_0,
            SCENE_1,
            SCENE_2,
            SCENE_3,
            SCENE_4,
            ENDING
        };

        // --- Constantes de tiempo (basado en 60 FPS) ---
        static constexpr float WARMUP_DURATION = 3.333F;      // 200 frames @ 60fps
        static constexpr float FADEOUT_DURATION = 1.667F;     // 100 frames @ 60fps
        static constexpr float SCENE_0_DURATION = 16.667F;    // 1000 frames @ 60fps
        static constexpr float SCENE_1_DURATION = 23.333F;    // 1400 frames @ 60fps
        static constexpr float SCENE_2_DURATION = 16.667F;    // 1000 frames @ 60fps
        static constexpr float SCENE_3_DURATION = 13.333F;    // 800 frames @ 60fps
        static constexpr float SCENE_4_DURATION = 16.667F;    // 1000 frames @ 60fps
        static constexpr float TEXT_REVEAL_SPEED = 30.0F;     // 2px cada 4 frames @ 60fps
        static constexpr float IMAGE_REVEAL_SPEED = 60.0F;    // 2px cada 2 frames @ 60fps
        static constexpr float TEXT_LAPSE = 1.333F;           // 80 frames @ 60fps
        static constexpr float FADEOUT_START_OFFSET = 1.667F; // Inicio fade-out 100 frames antes del fin

        // --- Estructuras ---
        struct EndingSurface  // Estructura con dos texturas y sprites, uno para mostrar y el otro hace de cortinilla
        {
                std::shared_ptr<Surface> image_surface;       // Surface a mostrar
                std::shared_ptr<SurfaceSprite> image_sprite;  // SSprite para mostrar la textura
                std::shared_ptr<Surface> cover_surface;       // Surface que cubre a la otra textura
                std::shared_ptr<SurfaceSprite> cover_sprite;  // SSprite para mostrar la textura que cubre a la otra textura
                int cover_clip_desp;                          // Desplazamiento del spriteClip de la textura de cobertura
                int cover_clip_height;                        // Altura del spriteClip de la textura de cobertura
        };

        struct TextAndPosition  // Estructura con un texto y su posición en el eje Y
        {
                std::string caption;  // Texto
                int pos;              // Posición
        };

        struct TextIndex {
                int index;
                int trigger;
        };

        struct SceneData  // Estructura para crear cada una de las escenas del final
        {
                std::vector<TextIndex> text_index;  // Indices del vector de textos a mostrar y su disparador
                int picture_index;                  // Indice del vector de imagenes a mostrar
                int counter_end;                    // Valor del contador en el que finaliza la escena
        };

        // --- Objetos y punteros ---
        std::shared_ptr<Surface> cover_surface_;  // Surface para cubrir el texto

        // --- Variables ---
        std::unique_ptr<DeltaTimer> delta_timer_;  // Temporizador delta para time-based update
        State state_ = State::WARMING_UP;          // Estado actual
        float state_time_ = 0.0F;                  // Tiempo acumulado en el estado actual
        float total_time_ = 0.0F;                  // Tiempo total acumulado desde el inicio
        float fadeout_time_ = 0.0F;                // Tiempo acumulado para el fade-out
        float current_delta_ = 0.0F;               // Delta time del frame actual
        std::vector<EndingSurface> sprite_texts_;  // Vector con los sprites de texto con su cortinilla
        std::vector<EndingSurface> sprite_pics_;   // Vector con los sprites de texto con su cortinilla
        int current_scene_ = 0;                    // Escena actual (0-4)
        std::vector<SceneData> scenes_;            // Vector con los textos e imagenes de cada escena

        // --- Funciones ---
        void update();                         // Actualiza el objeto
        void render();                         // Dibuja el final en pantalla
        static void checkEvents();             // Comprueba el manejador de eventos
        static void checkInput();              // Comprueba las entradas
        void iniTexts();                       // Inicializa los textos
        void iniPics();                        // Inicializa las imagenes
        void iniScenes();                      // Inicializa las escenas
        void updateState(float delta_time);    // Actualiza la máquina de estados
        void transitionToState(State new_state); // Transición entre estados
        void updateSpriteCovers();             // Actualiza las cortinillas de los elementos
        void checkChangeScene();               // Comprueba si se ha de cambiar de escena
        void fillCoverTexture();               // Rellena la textura para la cortinilla
        void renderCoverTexture();             // Dibuja la cortinilla de cambio de escena
        void updateMusicVolume() const;        // Actualiza el volumen de la musica
};