// ship_animator.hpp - Sistema de animación de naves para l'escena de título // © 2026 JailDesigner #pragma once #include "core/rendering/render_context.hpp" #include #include #include #include #include "core/graphics/shape.hpp" #include "core/types.hpp" namespace Title { // Estats de l'animación de la ship enum class ShipState : std::uint8_t { ENTERING, // Entrant desde fuera de pantalla FLOATING, // Flotante en posición estàtica EXITING // Volant hacia el point de fuga }; // Dades de una ship individual al título. // Todos los miembros tienen inicializador por defecto: ShipAnimator::ships_ // es un std::array y sin estos defaults los campos primitivos // quedarían indeterminados al instanciar el animador. struct TitleShip { // Identificació int player_id{0}; // 1 o 2 // Estat ShipState state{ShipState::ENTERING}; float state_time{0.0F}; // Temps acumulat en l'state actual // Posicions Vec2 initial_position{}; // Posición de start (fuera de pantalla per ENTERING) Vec2 target_position{}; // Posición objetivo (rellotge 8 o 4) Vec2 current_position{}; // Posición interpolada actual // Escales (simulació eix Z) float initial_scale{1.0F}; // Escala de start (més grande = més a prop) float target_scale{1.0F}; // Escala objetivo (mida flotació) float current_scale{1.0F}; // Escala interpolada actual // Flotació float oscillation_phase{0.0F}; // Acumulador de fase per movement sinusoïdal // Parámetros de entrada float entry_delay{0.0F}; // Delay antes de entrar (0.0 per P1, 0.5 per P2) // Parámetros de oscil·lació per ship float amplitude_x{0.0F}; float amplitude_y{0.0F}; float frequency_x{0.0F}; float frequency_y{0.0F}; // Forma std::shared_ptr shape; // Visibilitat bool visible{false}; }; // Gestor de animación de naves para l'escena de título class ShipAnimator { public: explicit ShipAnimator(Rendering::Renderer* renderer); // Cicle de vida void init(); void update(float delta_time); void draw() const; // Control de state (cridat per TitleScene) void startEntryAnimation(); void triggerExitAnimation(); // Anima todas las naves void triggerExitAnimationForPlayer(int player_id); // Anima solo una ship (P1=1, P2=2) void skipToFloatingState(); // Salta directament a FLOATING sin animación // Control de visibilitat void setVisible(bool visible); [[nodiscard]] auto isAnimationComplete() const -> bool; [[nodiscard]] auto isVisible() const -> bool; // Comprova si alguna ship es visible private: Rendering::Renderer* renderer_; std::array ships_; // Naves P1 i P2 // Métodos de animación. Estáticos: solo modifican el TitleShip pasado, // sin tocar otros miembros del ShipAnimator. static void updateEntering(TitleShip& ship, float delta_time); static void updateFloating(TitleShip& ship, float delta_time); static void updateExiting(TitleShip& ship, float delta_time); // Configuración (también estáticos: trabajan sobre el ship pasado). static void configureShipP1(TitleShip& ship); static void configureShipP2(TitleShip& ship); [[nodiscard]] static auto computeOffscreenPosition(float angle_rellotge) -> Vec2; }; } // namespace Title