Fase 1c: rename d'escenes i sistema d'escenes

Tots els tipus, fitxers, namespace, enums i metodes relacionats amb les escenes passen del catala a l'angles seguint el .clang-tidy: Fitxers (renames git): - source/game/escenes/escena_joc.{hpp,cpp} -> game/scenes/game_scene.{hpp,cpp} - source/game/escenes/escena_titol.{hpp,cpp} -> game/scenes/title_scene.{hpp,cpp} - source/game/escenes/escena_logo.{hpp,cpp} -> game/scenes/logo_scene.{hpp,cpp} - source/core/system/context_escenes.hpp -> core/system/scene_context.hpp - Carpeta game/escenes/ -> game/scenes/ Tipus (CamelCase): - EscenaJoc -> GameScene - EscenaTitol -> TitleScene - EscenaLogo -> LogoScene - ContextEscenes -> SceneContext - Escena (enum class) -> SceneType - Opcio -> Option - EstatGameOver -> GameOverState - EstatTitol -> TitleState - EstatAnimacio -> AnimationState - ConfigPartida -> MatchConfig Namespace: - GestorEscenes -> SceneManager Valors d'enum SceneType: - TITOL -> TITLE - JOC -> GAME - EIXIR -> EXIT (LOGO mantingut) Metodes (camelBack): - executar -> run - canviar_escena -> setNextScene - escena_desti -> nextScene - opcio (getter) -> option - consumir_opcio -> consumeOption - reset_opcio -> resetOption - set_config_partida -> setMatchConfig - get_config_partida -> getMatchConfig Camps privats (lower_case_): - escena_desti_ -> next_scene_ - opcio_ -> option_ - config_partida_ -> match_config_ Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 11:41:11 +02:00
parent ae5cc1cfb4
commit 5871d29d48
14 changed files with 368 additions and 368 deletions
@@ -0,0 +1,112 @@
+// escena_titol.hpp - Pantalla de títol del joc
+// Mostra missatge "PRESS BUTTON TO PLAY" i copyright
+// © 2025 Port a C++20
+
+#pragma once
+
+#include <SDL3/SDL.h>
+
+#include <array>
+#include <memory>
+#include <vector>
+
+#include "core/defaults.hpp"
+#include "core/graphics/shape.hpp"
+#include "core/graphics/starfield.hpp"
+#include "core/graphics/vector_text.hpp"
+#include "core/input/input_types.hpp"
+#include "core/rendering/sdl_manager.hpp"
+#include "core/system/scene_context.hpp"
+#include "core/system/game_config.hpp"
+#include "core/types.hpp"
+#include "game/title/ship_animator.hpp"
+
+// Botones para INICIAR PARTIDA desde MAIN (solo START)
+static constexpr std::array<InputAction, 1> START_GAME_BUTTONS = {
+    InputAction::START};
+
+class TitleScene {
+    public:
+        explicit TitleScene(SDLManager& sdl, SceneManager::SceneContext& context);
+        ~TitleScene();   // Destructor per aturar música
+        void run();  // Bucle principal de l'escena
+
+    private:
+        // Màquina d'estats per la pantalla de títol
+        enum class TitleState {
+            STARFIELD_FADE_IN,  // Fade-in del starfield (3.0s)
+            STARFIELD,          // Pantalla amb camp d'estrelles (4.0s)
+            MAIN,               // Pantalla de títol amb text (indefinit, fins START)
+            PLAYER_JOIN_PHASE,  // Fase d'unió de jugadors: fade-out música + text parpellejant (2.5s)
+            BLACK_SCREEN        // Pantalla negra de transició (2.0s)
+        };
+
+        // Estructura per emmagatzemar informació de cada lletra del títol
+        struct LetraLogo {
+                std::shared_ptr<Graphics::Shape> forma;  // Forma vectorial de la lletra
+                Vec2 posicio;                            // Posició en pantalla
+                float ancho;                             // Amplada escalada
+                float altura;                            // Altura escalada
+                float offset_centre;                     // Offset del centre per posicionament
+        };
+
+        SDLManager& sdl_;
+        SceneManager::SceneContext& context_;
+        GameConfig::MatchConfig match_config_;            // Configuració de jugadors actius
+        Graphics::VectorText text_;                           // Sistema de text vectorial
+        std::unique_ptr<Graphics::Starfield> starfield_;      // Camp d'estrelles de fons
+        std::unique_ptr<Title::ShipAnimator> ship_animator_;  // Naus 3D flotants
+        TitleState estat_actual_;                             // Estat actual de la màquina
+        float temps_acumulat_;                                // Temps acumulat per l'estat INIT
+
+        // Lletres del títol "ORNI ATTACK!"
+        std::vector<LetraLogo> lletres_orni_;    // Lletres de "ORNI" (línia 1)
+        std::vector<LetraLogo> lletres_attack_;  // Lletres de "ATTACK!" (línia 2)
+        float y_attack_dinamica_;                // Posició Y calculada dinàmicament per "ATTACK!"
+
+        // Estat d'animació del logo
+        float temps_animacio_;                          // Temps acumulat per animació orbital
+        std::vector<Vec2> posicions_originals_orni_;    // Posicions originals de "ORNI"
+        std::vector<Vec2> posicions_originals_attack_;  // Posicions originals de "ATTACK!"
+
+        // Estat d'arrencada de l'animació
+        float temps_estat_main_;  // Temps acumulat en estat MAIN
+        bool animacio_activa_;    // Flag: true quan animació està activa
+        float factor_lerp_;       // Factor de lerp actual (0.0 → 1.0)
+
+        // Constants
+        static constexpr float BRIGHTNESS_STARFIELD = 1.2F;  // Brightness del starfield (>1.0 = més brillant)
+        static constexpr float DURACIO_FADE_IN = 3.0F;       // Duració del fade-in del starfield (1.5 segons)
+        static constexpr float DURACIO_INIT = 4.0F;          // Duració de l'estat INIT (2 segons)
+        static constexpr float DURACIO_TRANSITION = 2.5F;    // Duració de la transició (1.5 segons)
+        static constexpr float ESPAI_ENTRE_LLETRES = 10.0F;  // Espai entre lletres
+        static constexpr float BLINK_FREQUENCY = 3.0F;       // Freqüència de parpelleig (3 Hz)
+        static constexpr float DURACIO_BLACK_SCREEN = 2.0F;  // Duració pantalla negra (2 segons)
+        static constexpr int MUSIC_FADE = 1500;              // Duracio del fade de la musica del titol al començar a jugar
+
+        // Constants d'animació del logo
+        static constexpr float ORBIT_AMPLITUDE_X = 4.0F;    // Amplitud oscil·lació horitzontal (píxels)
+        static constexpr float ORBIT_AMPLITUDE_Y = 3.0F;    // Amplitud oscil·lació vertical (píxels)
+        static constexpr float ORBIT_FREQUENCY_X = 0.8F;    // Velocitat oscil·lació horitzontal (Hz)
+        static constexpr float ORBIT_FREQUENCY_Y = 1.2F;    // Velocitat oscil·lació vertical (Hz)
+        static constexpr float ORBIT_PHASE_OFFSET = 1.57F;  // Desfasament entre X i Y (90° per circular)
+
+        // Constants d'ombra del logo
+        static constexpr float SHADOW_DELAY = 0.5F;       // Retard temporal de l'ombra (segons)
+        static constexpr float SHADOW_BRIGHTNESS = 0.4F;  // Multiplicador de brillantor de l'ombra (0.0-1.0)
+        static constexpr float SHADOW_OFFSET_X = 2.0F;    // Offset espacial X fix (píxels)
+        static constexpr float SHADOW_OFFSET_Y = 2.0F;    // Offset espacial Y fix (píxels)
+
+        // Temporització de l'arrencada de l'animació
+        static constexpr float DELAY_INICI_ANIMACIO = 10.0F;  // 10s estàtic abans d'animar
+        static constexpr float DURACIO_LERP = 2.0F;           // 2s per arribar a amplitud completa
+
+        // Mètodes privats
+        void update(float delta_time);
+        void actualitzar_animacio_logo(float delta_time);  // Actualitza l'animació orbital del logo
+        void draw();
+        void processar_events(const SDL_Event& event);
+        auto checkSkipButtonPressed() -> bool;
+        auto checkStartGameButtonPressed() -> bool;
+        void inicialitzar_titol();  // Carrega i posiciona les lletres del títol
+};