feat(ship-animator3d): animador 3D de naus per al títol amb extrusió de ship.shp

2026-05-22 08:14:29 +02:00
parent 8722a46d06
commit 7a3a71e1dc
2 changed files with 352 additions and 0 deletions
@@ -0,0 +1,81 @@
+// ship_animator3d.hpp - Sistema d'animació de naus 3D per a l'escena de títol
+// © 2026 JailDesigner
+//
+// Equivalent 3D del `Title::ShipAnimator`. Manté la mateixa màquina d'estats
+// (ENTERING → FLOATING → EXITING) però treballa amb posicions Vec3 i emet
+// wireframes a través d'una `Camera3D`. La geometria s'extrau de `ship.shp`
+// (P1) i `ship2.shp` (P2) per extrusió en Z.
+
+#pragma once
+
+#include <array>
+#include <cstdint>
+
+#include "core/graphics/camera3d.hpp"
+#include "core/graphics/wireframe3d.hpp"
+#include "core/rendering/render_context.hpp"
+#include "core/types.hpp"
+
+namespace Title {
+
+    enum class ShipState3D : std::uint8_t {
+        ENTERING,
+        FLOATING,
+        EXITING,
+    };
+
+    struct TitleShip3D {
+        int player_id{0};
+        ShipState3D state{ShipState3D::ENTERING};
+        float state_time{0.0F};
+
+        Vec3 initial_position{};
+        Vec3 target_position{};
+        Vec3 current_position{};
+
+        float initial_scale{1.0F};
+        float target_scale{1.0F};
+        float current_scale{1.0F};
+
+        float oscillation_phase{0.0F};
+        float entry_delay{0.0F};
+
+        float amplitude_x{0.0F};
+        float amplitude_y{0.0F};
+        float frequency_x{0.0F};
+        float frequency_y{0.0F};
+
+        Graphics::Mesh3D mesh;
+        bool visible{false};
+    };
+
+    class ShipAnimator3D {
+       public:
+        ShipAnimator3D(Rendering::Renderer* renderer, const Graphics::Camera3D* camera);
+
+        void init();
+        void update(float delta_time);
+        void draw() const;
+
+        void startEntryAnimation();
+        void triggerExitAnimation();
+        void triggerExitAnimationForPlayer(int player_id);
+        void skipToFloatingState();
+
+        void setVisible(bool visible);
+        [[nodiscard]] auto isAnimationComplete() const -> bool;
+        [[nodiscard]] auto isVisible() const -> bool;
+
+       private:
+        Rendering::Renderer* renderer_;
+        const Graphics::Camera3D* camera_;
+        std::array<TitleShip3D, 2> ships_;
+
+        static void updateEntering(TitleShip3D& ship, float delta_time);
+        static void updateFloating(TitleShip3D& ship, float delta_time);
+        static void updateExiting(TitleShip3D& ship, float delta_time);
+        static void configureShipP1(TitleShip3D& ship);
+        static void configureShipP2(TitleShip3D& ship);
+    };
+
+}  // namespace Title