aplanat sub-bucles anidats de pausa, game over, instruccions i demo (milestone 2)

- Game::runPausedGame() convertit a enterPausedGame() + despatx directe en run()
- Game::runGameOverScreen() convertit a enterGameOverScreen() + despatx directe
- Eliminada variable static postFade, convertida a membre gameOverPostFade
- Extret SDL_PollEvent de updateGameOverScreen() a checkGameOverEvents()
- Game::run() refactoritzat amb iterate() + hasFinished() per preparar callbacks
- Title::runInstructions() i runDemoGame() convertits a no-bloquejants
- Instructions ara usa finished/quitRequested en lloc de modificar section directament
- Instructions exposa start(), update(), checkEvents(), render(), hasFinished()

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Makefile

@@ -103,7 +103,7 @@ windows_release:
 	@powershell -Command "Copy-Item 'LICENSE' -Destination '$(RELEASE_FOLDER)'"
 	@powershell -Command "Copy-Item 'README.md' -Destination '$(RELEASE_FOLDER)'"
 	@powershell -Command "Copy-Item 'release\windows\dll\*.dll' -Destination '$(RELEASE_FOLDER)'"
-	@powershell -Command "Copy-Item -Path '$(TARGET_FILE)' -Destination '\"$(WIN_RELEASE_FILE).exe\"'"
+	@powershell -Command "Copy-Item -Path '$(TARGET_FILE).exe' -Destination '$(WIN_RELEASE_FILE).exe'"
 	strip -s -R .comment -R .gnu.version "$(WIN_RELEASE_FILE).exe" --strip-unneeded
 
 # Crea el fichero .zip

source/fade.cpp

@@ -35,6 +35,12 @@ void Fade::init(Uint8 r, Uint8 g, Uint8 b) {
     mR = r;
     mG = g;
     mB = b;
+    mROriginal = r;
+    mGOriginal = g;
+    mBOriginal = b;
+    mLastSquareTicks = 0;
+    mSquaresDrawn = 0;
+    mFullscreenDone = false;
 }
 
 // Pinta una transición en pantalla
@@ -42,21 +48,13 @@ void Fade::render() {
     if (mEnabled && !mFinished) {
         switch (mFadeType) {
             case FADE_FULLSCREEN: {
+                if (!mFullscreenDone) {
                     SDL_FRect fRect1 = {0, 0, (float)GAMECANVAS_WIDTH, (float)GAMECANVAS_HEIGHT};
 
-                for (int i = 0; i < 256; i += 4) {
+                    int alpha = mCounter * 4;
-                    // Dibujamos sobre el renderizador
+                    if (alpha >= 255) {
-                    SDL_SetRenderTarget(mRenderer, nullptr);
+                        alpha = 255;
-
+                        mFullscreenDone = true;
-                    // Copia el backbuffer con la imagen que había al renderizador
-                    SDL_RenderTexture(mRenderer, mBackbuffer, nullptr, nullptr);
-
-                    SDL_SetRenderDrawColor(mRenderer, mR, mG, mB, i);
-                    SDL_RenderFillRect(mRenderer, &fRect1);
-
-                    // Vuelca el renderizador en pantalla
-                    SDL_RenderPresent(mRenderer);
-                }
 
                         // Deja todos los buffers del mismo color
                         SDL_SetRenderTarget(mRenderer, mBackbuffer);
@@ -66,6 +64,19 @@ void Fade::render() {
                         SDL_SetRenderTarget(mRenderer, nullptr);
                         SDL_SetRenderDrawColor(mRenderer, mR, mG, mB, 255);
                         SDL_RenderClear(mRenderer);
+
+                        mFinished = true;
+                    } else {
+                        // Dibujamos sobre el renderizador
+                        SDL_SetRenderTarget(mRenderer, nullptr);
+
+                        // Copia el backbuffer con la imagen que había al renderizador
+                        SDL_RenderTexture(mRenderer, mBackbuffer, nullptr, nullptr);
+
+                        SDL_SetRenderDrawColor(mRenderer, mR, mG, mB, alpha);
+                        SDL_RenderFillRect(mRenderer, &fRect1);
+                    }
+                }
                 break;
             }
 
@@ -89,14 +100,17 @@ void Fade::render() {
             }
 
             case FADE_RANDOM_SQUARE: {
+                Uint32 now = SDL_GetTicks();
+                if (mSquaresDrawn < 50 && now - mLastSquareTicks >= 100) {
+                    mLastSquareTicks = now;
+
                     SDL_FRect fRs = {0, 0, 32, 32};
 
-                for (Uint16 i = 0; i < 50; i++) {
                     // Crea un color al azar
-                    mR = 255 * (rand() % 2);
+                    Uint8 r = 255 * (rand() % 2);
-                    mG = 255 * (rand() % 2);
+                    Uint8 g = 255 * (rand() % 2);
-                    mB = 255 * (rand() % 2);
+                    Uint8 b = 255 * (rand() % 2);
-                    SDL_SetRenderDrawColor(mRenderer, mR, mG, mB, 64);
+                    SDL_SetRenderDrawColor(mRenderer, r, g, b, 64);
 
                     // Dibujamos sobre el backbuffer
                     SDL_SetRenderTarget(mRenderer, mBackbuffer);
@@ -108,12 +122,14 @@ void Fade::render() {
                     // Volvemos a usar el renderizador de forma normal
                     SDL_SetRenderTarget(mRenderer, nullptr);
 
+                    mSquaresDrawn++;
+                }
+
                 // Copiamos el backbuffer al renderizador
                 SDL_RenderTexture(mRenderer, mBackbuffer, nullptr, nullptr);
 
-                    // Volcamos el renderizador en pantalla
+                if (mSquaresDrawn >= 50) {
-                    SDL_RenderPresent(mRenderer);
+                    mFinished = true;
-                    SDL_Delay(100);
                 }
                 break;
             }
@@ -140,6 +156,12 @@ void Fade::activateFade() {
     mEnabled = true;
     mFinished = false;
     mCounter = 0;
+    mSquaresDrawn = 0;
+    mLastSquareTicks = 0;
+    mFullscreenDone = false;
+    mR = mROriginal;
+    mG = mGOriginal;
+    mB = mBOriginal;
 }
 
 // Comprueba si está activo

source/fade.h

@@ -17,6 +17,10 @@ class Fade {
     bool mEnabled;                             // Indica si el fade está activo
     bool mFinished;                            // Indica si ha terminado la transición
     Uint8 mR, mG, mB;                          // Colores para el fade
+    Uint8 mROriginal, mGOriginal, mBOriginal;  // Colores originales para FADE_RANDOM_SQUARE
+    Uint32 mLastSquareTicks;                   // Ticks del último cuadrado dibujado (FADE_RANDOM_SQUARE)
+    Uint16 mSquaresDrawn;                      // Número de cuadrados dibujados (FADE_RANDOM_SQUARE)
+    bool mFullscreenDone;                      // Indica si el fade fullscreen ha terminado la fase de fundido
     SDL_Rect mRect1;                           // Rectangulo usado para crear los efectos de transición
     SDL_Rect mRect2;                           // Rectangulo usado para crear los efectos de transición
 

source/game.cpp

@@ -284,6 +284,12 @@ void Game::init() {
     effect.flash = false;
     effect.shake = false;
     effect.shakeCounter = SHAKE_COUNTER;
+    deathShake.active = false;
+    deathShake.step = 0;
+    deathShake.lastStepTicks = 0;
+    deathSequence.phase = DeathPhase::None;
+    deathSequence.phaseStartTicks = 0;
+    deathSequence.player = nullptr;
     helper.needCoffee = false;
     helper.needCoffeeMachine = false;
     helper.needPowerBall = false;
@@ -299,6 +305,9 @@ void Game::init() {
     coffeeMachineEnabled = false;
     pauseCounter = 0;
     leavingPauseMenu = false;
+    pauseInitialized = false;
+    gameOverInitialized = false;
+    gameOverPostFade = 0;
 
     if (demo.enabled) {
         const int num = rand() % 2;
@@ -2363,20 +2372,47 @@ void Game::killPlayer(Player *player) {
             player->removeExtraHit();
             throwCoffee(player->getPosX() + (player->getWidth() / 2), player->getPosY() + (player->getHeight() / 2));
             JA_PlaySound(coffeeOutSound);
-        } else {
+        } else if (deathSequence.phase == DeathPhase::None) {
             JA_PauseMusic();
             stopAllBalloons(10);
             JA_PlaySound(playerCollisionSound);
             shakeScreen();
-            SDL_Delay(500);
+            deathSequence.phase = DeathPhase::Shaking;
+            deathSequence.phaseStartTicks = SDL_GetTicks();
+            deathSequence.player = player;
+        }
+    }
+}
+
+// Actualiza la secuencia de muerte del jugador
+void Game::updateDeathSequence() {
+    switch (deathSequence.phase) {
+        case DeathPhase::None:
+        case DeathPhase::Done:
+            break;
+
+        case DeathPhase::Shaking:
+            // Espera a que termine el efecto de agitación
+            if (!isDeathShaking()) {
+                deathSequence.phase = DeathPhase::Waiting;
+                deathSequence.phaseStartTicks = SDL_GetTicks();
+            }
+            break;
+
+        case DeathPhase::Waiting:
+            // Espera 500ms antes de completar la muerte
+            if (SDL_GetTicks() - deathSequence.phaseStartTicks >= 500) {
                 JA_PlaySound(coffeeOutSound);
-            player->setAlive(false);
+                deathSequence.player->setAlive(false);
                 if (allPlayersAreDead()) {
                     JA_StopMusic();
                 } else {
                     JA_ResumeMusic();
                 }
+                deathSequence.phase = DeathPhase::Done;
+                deathSequence.player = nullptr;
             }
+            break;
     }
 }
 
@@ -2439,6 +2475,15 @@ void Game::update() {
     // Actualiza el audio
     JA_Update();
 
+    // Actualiza los efectos basados en tiempo real (no en el throttle del juego)
+    updateDeathShake();
+    updateDeathSequence();
+
+    // Durante la secuencia de muerte, congela el resto del juego
+    if (deathSequence.phase == DeathPhase::Shaking || deathSequence.phase == DeathPhase::Waiting) {
+        return;
+    }
+
     // Comprueba que la diferencia de ticks sea mayor a la velocidad del juego
     if (SDL_GetTicks() - ticks > ticksSpeed) {
         // Actualiza el contador de ticks
@@ -2550,7 +2595,10 @@ void Game::updateBackground() {
     grassSprite->setSpriteClip(0, (6 * (counter / 20 % 2)), 256, 6);
 
     // Mueve los edificios en funcion de si está activo el efecto de agitarlos
-    if (effect.shake) {
+    if (deathShake.active) {
+        const int v[] = {-1, 1, -1, 1, -1, 1, -1, 0};
+        buildingsSprite->setPosX(v[deathShake.step]);
+    } else if (effect.shake) {
         buildingsSprite->setPosX(((effect.shakeCounter % 2) * 2) - 1);
     } else {
         buildingsSprite->setPosX(0);
@@ -2868,59 +2916,60 @@ void Game::disableTimeStopItem() {
     }
 }
 
-// Agita la pantalla
+// Inicia el efecto de agitación intensa de la pantalla
 void Game::shakeScreen() {
-    const int v[] = {-1, 1, -1, 1, -1, 1, -1, 0};
+    deathShake.active = true;
-    for (int n = 0; n < 8; ++n) {
+    deathShake.step = 0;
-        // Prepara para empezar a dibujar en la textura de juego
+    deathShake.lastStepTicks = SDL_GetTicks();
-        screen->start();
+}
 
-        // Limpia la pantalla
+// Actualiza el efecto de agitación intensa
-        screen->clean(bgColor);
+void Game::updateDeathShake() {
+    if (!deathShake.active) return;
 
-        // Dibuja los objetos
+    Uint32 now = SDL_GetTicks();
-        buildingsSprite->setPosX(0);
+    if (now - deathShake.lastStepTicks >= 50) {
-        buildingsSprite->setWidth(1);
+        deathShake.lastStepTicks = now;
-        buildingsSprite->setSpriteClip(0, 0, 1, 160);
+        deathShake.step++;
-        renderBackground();
+        if (deathShake.step >= 8) {
-
+            deathShake.active = false;
-        buildingsSprite->setPosX(255);
+        }
-        buildingsSprite->setSpriteClip(255, 0, 1, 160);
-        buildingsSprite->render();
-
-        buildingsSprite->setPosX(v[n]);
-        buildingsSprite->setWidth(256);
-        buildingsSprite->setSpriteClip(0, 0, 256, 160);
-        buildingsSprite->render();
-
-        grassSprite->render();
-        renderBalloons();
-        renderBullets();
-        renderItems();
-        renderPlayers();
-        renderScoreBoard();
-
-        // Vuelca el contenido del renderizador en pantalla
-        screen->blit();
-        SDL_Delay(50);
     }
 }
 
-// Bucle para el juego
+// Indica si el efecto de agitación intensa está activo
-void Game::run() {
+bool Game::isDeathShaking() {
-    while (section->name == SECTION_PROG_GAME) {
+    return deathShake.active;
+}
+
+// Ejecuta un frame del juego
+void Game::iterate() {
     // Sección juego en pausa
     if (section->subsection == SUBSECTION_GAME_PAUSE) {
-            runPausedGame();
+        if (!pauseInitialized) {
+            enterPausedGame();
+        }
+        updatePausedGame();
+        checkEvents();
+        renderPausedGame();
     }
 
     // Sección Game Over
-        if (section->subsection == SUBSECTION_GAME_GAMEOVER) {
+    else if (section->subsection == SUBSECTION_GAME_GAMEOVER) {
-            runGameOverScreen();
+        if (!gameOverInitialized) {
+            enterGameOverScreen();
+        }
+        updateGameOverScreen();
+        checkGameOverEvents();
+        renderGameOverScreen();
     }
 
     // Sección juego jugando
-        if ((section->subsection == SUBSECTION_GAME_PLAY_1P) || (section->subsection == SUBSECTION_GAME_PLAY_2P)) {
+    else if ((section->subsection == SUBSECTION_GAME_PLAY_1P) || (section->subsection == SUBSECTION_GAME_PLAY_2P)) {
+        // Resetea los flags de inicialización de sub-estados
+        pauseInitialized = false;
+        gameOverInitialized = false;
+
         // Si la música no está sonando
         if ((JA_GetMusicState() == JA_MUSIC_INVALID) || (JA_GetMusicState() == JA_MUSIC_STOPPED)) {
             // Reproduce la música
@@ -2946,6 +2995,17 @@ void Game::run() {
         render();
     }
 }
+
+// Indica si el juego ha terminado
+bool Game::hasFinished() const {
+    return section->name != SECTION_PROG_GAME;
+}
+
+// Bucle para el juego
+void Game::run() {
+    while (!hasFinished()) {
+        iterate();
+    }
 }
 
 // Actualiza las variables del menu de pausa del juego
@@ -3045,8 +3105,8 @@ void Game::renderPausedGame() {
     screen->blit();
 }
 
-// Bucle para el menu de pausa del juego
+// Inicializa el estado de pausa del juego
-void Game::runPausedGame() {
+void Game::enterPausedGame() {
     // Pone en pausa la música
     if (JA_GetMusicState() == JA_MUSIC_PLAYING) {
         JA_PauseMusic();
@@ -3058,19 +3118,11 @@ void Game::runPausedGame() {
 
     // Inicializa variables
     pauseCounter = 90;
-
+    pauseInitialized = true;
-    while ((section->subsection == SUBSECTION_GAME_PAUSE) && (section->name == SECTION_PROG_GAME)) {
-        updatePausedGame();
-        checkEvents();
-        renderPausedGame();
-    }
 }
 
 // Actualiza los elementos de la pantalla de game over
 void Game::updateGameOverScreen() {
-    // Variables
-    static int postFade = 0;
-
     // Calcula la lógica de los objetos
     if (SDL_GetTicks() - ticks > ticksSpeed) {
         // Actualiza el contador de ticks
@@ -3084,7 +3136,7 @@ void Game::updateGameOverScreen() {
 
         // Si ha terminado el fade, actua segun se haya operado
         if (fade->hasEnded()) {
-            switch (postFade) {
+            switch (gameOverPostFade) {
                 case 0:  // YES
                     section->name = SECTION_PROG_GAME;
                     deleteAllVectorObjects();
@@ -3109,12 +3161,12 @@ void Game::updateGameOverScreen() {
             // Comprueba si se ha seleccionado algún item del menú
             switch (gameOverMenu->getItemSelected()) {
                 case 0:  // YES
-                    postFade = 0;
+                    gameOverPostFade = 0;
                     fade->activateFade();
                     break;
 
                 case 1:  // NO
-                    postFade = 1;
+                    gameOverPostFade = 1;
                     fade->activateFade();
                     break;
 
@@ -3123,8 +3175,10 @@ void Game::updateGameOverScreen() {
             }
         }
     }
+}
 
-    // Comprueba los eventos que hay en la cola
+// Comprueba los eventos de la pantalla de game over
+void Game::checkGameOverEvents() {
     while (SDL_PollEvent(eventHandler) != 0) {
         // Evento de salida de la aplicación
         if (eventHandler->type == SDL_EVENT_QUIT) {
@@ -3132,7 +3186,7 @@ void Game::updateGameOverScreen() {
             break;
         } else if (eventHandler->type == SDL_EVENT_KEY_DOWN && eventHandler->key.repeat == 0) {
             if (gameCompleted) {
-                postFade = 1;
+                gameOverPostFade = 1;
                 fade->activateFade();
                 JA_PlaySound(itemPickUpSound);
             }
@@ -3196,18 +3250,15 @@ void Game::renderGameOverScreen() {
     screen->blit();
 }
 
-// Bucle para la pantalla de game over
+// Inicializa el estado de game over
-void Game::runGameOverScreen() {
+void Game::enterGameOverScreen() {
     // Guarda los puntos
     saveScoreFile();
 
     // Reinicia el menu
     gameOverMenu->reset();
-
+    gameOverPostFade = 0;
-    while ((section->subsection == SUBSECTION_GAME_GAMEOVER) && (section->name == SECTION_PROG_GAME)) {
+    gameOverInitialized = true;
-        updateGameOverScreen();
-        renderGameOverScreen();
-    }
 }
 
 // Indica si se puede crear una powerball

source/game.h

@@ -88,6 +88,26 @@ class Game {
         Uint8 shakeCounter;  // Contador para medir el tiempo que dura el efecto
     };
 
+    // Estado para el efecto de agitación intensa (muerte del jugador)
+    struct deathShake_t {
+        bool active;           // Indica si el efecto está activo
+        Uint8 step;            // Paso actual del efecto (0-7)
+        Uint32 lastStepTicks;  // Ticks del último paso
+    };
+
+    // Fases de la secuencia de muerte del jugador
+    enum class DeathPhase { None,
+        Shaking,
+        Waiting,
+        Done };
+
+    // Estado de la secuencia de muerte del jugador
+    struct deathSequence_t {
+        DeathPhase phase;        // Fase actual
+        Uint32 phaseStartTicks;  // Ticks del inicio de la fase actual
+        Player *player;          // Jugador que está muriendo
+    };
+
     struct helper_t {
         bool needCoffee;            // Indica si se necesitan cafes
         bool needCoffeeMachine;     // Indica si se necesita PowerUp
@@ -214,6 +234,8 @@ class Game {
     float enemySpeed;                                             // Velocidad a la que se mueven los enemigos
     float defaultEnemySpeed;                                      // Velocidad base de los enemigos, sin incrementar
     effect_t effect;                                              // Variable para gestionar los efectos visuales
+    deathShake_t deathShake;                                      // Variable para gestionar el efecto de agitación intensa
+    deathSequence_t deathSequence;                                // Variable para gestionar la secuencia de muerte
     helper_t helper;                                              // Variable para gestionar las ayudas
     bool powerBallEnabled;                                        // Indica si hay una powerball ya activa
     Uint8 powerBallCounter;                                       // Contador de formaciones enemigas entre la aparicion de una PowerBall y otra
@@ -233,6 +255,9 @@ class Game {
     int cloudsSpeed;                                              // Velocidad a la que se desplazan las nubes
     int pauseCounter;                                             // Contador para salir del menu de pausa y volver al juego
     bool leavingPauseMenu;                                        // Indica si esta saliendo del menu de pausa para volver al juego
+    bool pauseInitialized;                                        // Indica si la pausa ha sido inicializada
+    bool gameOverInitialized;                                     // Indica si el game over ha sido inicializado
+    int gameOverPostFade;                                         // Opción a realizar cuando termina el fundido del game over
 #ifdef PAUSE
     bool pause;
 #endif
@@ -459,17 +484,26 @@ class Game {
     // Deshabilita el efecto del item de detener el tiempo
     void disableTimeStopItem();
 
-    // Agita la pantalla
+    // Inicia el efecto de agitación intensa de la pantalla
     void shakeScreen();
 
+    // Actualiza el efecto de agitación intensa
+    void updateDeathShake();
+
+    // Indica si el efecto de agitación intensa está activo
+    bool isDeathShaking();
+
+    // Actualiza la secuencia de muerte del jugador
+    void updateDeathSequence();
+
     // Actualiza las variables del menu de pausa del juego
     void updatePausedGame();
 
     // Dibuja el menu de pausa del juego
     void renderPausedGame();
 
-    // Bucle para el menu de pausa del juego
+    // Inicializa el estado de pausa del juego
-    void runPausedGame();
+    void enterPausedGame();
 
     // Actualiza los elementos de la pantalla de game over
     void updateGameOverScreen();
@@ -477,8 +511,11 @@ class Game {
     // Dibuja los elementos de la pantalla de game over
     void renderGameOverScreen();
 
-    // Bucle para la pantalla de game over
+    // Inicializa el estado de game over
-    void runGameOverScreen();
+    void enterGameOverScreen();
+
+    // Comprueba los eventos de la pantalla de game over
+    void checkGameOverEvents();
 
     // Indica si se puede crear una powerball
     bool canPowerBallBeCreated();
@@ -519,4 +556,10 @@ class Game {
 
     // Bucle para el juego
     void run();
+
+    // Ejecuta un frame del juego
+    void iterate();
+
+    // Indica si el juego ha terminado
+    bool hasFinished() const;
 };

source/instructions.cpp

@@ -17,8 +17,6 @@
 #include "texture.h"       // for Texture
 #include "utils.h"         // for color_t, section_t
 
-const Uint8 SELF = 0;
-
 // Constructor
 Instructions::Instructions(SDL_Renderer *renderer, Screen *screen, Asset *asset, Input *input, Lang *lang, section_t *section) {
     // Copia los punteros
@@ -62,12 +60,13 @@ Instructions::Instructions(SDL_Renderer *renderer, Screen *screen, Asset *asset,
     }
 
     // Inicializa variables
-    section->name = SELF;
     ticks = 0;
     ticksSpeed = 15;
     manualQuit = false;
     counter = 0;
     counterEnd = 600;
+    finished = false;
+    quitRequested = false;
 }
 
 // Destructor
@@ -99,15 +98,13 @@ void Instructions::update() {
             counter++;
 
             if (counter == counterEnd) {
-                section->name = SECTION_PROG_TITLE;
+                finished = true;
-                section->subsection = SUBSECTION_TITLE_1;
             }
         } else {  // Modo manual
             ++counter %= 60000;
 
             if (manualQuit) {
-                section->name = SECTION_PROG_TITLE;
+                finished = true;
-                section->subsection = SUBSECTION_TITLE_3;
             }
         }
     }
@@ -215,7 +212,8 @@ void Instructions::checkEvents() {
     while (SDL_PollEvent(eventHandler) != 0) {
         // Evento de salida de la aplicación
         if (eventHandler->type == SDL_EVENT_QUIT) {
-            section->name = SECTION_PROG_QUIT;
+            quitRequested = true;
+            finished = true;
             break;
         }
     }
@@ -224,7 +222,8 @@ void Instructions::checkEvents() {
 // Comprueba las entradas
 void Instructions::checkInput() {
     if (input->checkInput(input_exit, REPEAT_FALSE)) {
-        section->name = SECTION_PROG_QUIT;
+        quitRequested = true;
+        finished = true;
     }
 
     else if (input->checkInput(input_window_fullscreen, REPEAT_FALSE)) {
@@ -242,8 +241,7 @@ void Instructions::checkInput() {
     else if (input->checkInput(input_pause, REPEAT_FALSE) || input->checkInput(input_accept, REPEAT_FALSE) || input->checkInput(input_fire_left, REPEAT_FALSE) || input->checkInput(input_fire_center, REPEAT_FALSE) || input->checkInput(input_fire_right, REPEAT_FALSE)) {
         if (mode == m_auto) {
             JA_StopMusic();
-            section->name = SECTION_PROG_TITLE;
+            finished = true;
-            section->subsection = SUBSECTION_TITLE_1;
         } else {
             if (counter > 30) {
                 manualQuit = true;
@@ -252,13 +250,41 @@ void Instructions::checkInput() {
     }
 }
 
-// Bucle para la pantalla de instrucciones
+// Bucle para la pantalla de instrucciones (compatibilidad)
 void Instructions::run(mode_e mode) {
-    this->mode = mode;
+    start(mode);
 
-    while (section->name == SELF) {
+    while (!finished) {
         update();
         checkEvents();
         render();
     }
+
+    // Aplica los cambios de sección según el resultado
+    if (quitRequested) {
+        section->name = SECTION_PROG_QUIT;
+    } else {
+        section->name = SECTION_PROG_TITLE;
+        section->subsection = (mode == m_auto) ? SUBSECTION_TITLE_1 : SUBSECTION_TITLE_3;
+    }
+}
+
+// Inicia las instrucciones (sin bucle)
+void Instructions::start(mode_e mode) {
+    this->mode = mode;
+    finished = false;
+    quitRequested = false;
+    manualQuit = false;
+    counter = 0;
+    ticks = 0;
+}
+
+// Indica si las instrucciones han terminado
+bool Instructions::hasFinished() const {
+    return finished;
+}
+
+// Indica si se ha solicitado salir de la aplicación
+bool Instructions::isQuitRequested() const {
+    return quitRequested;
 }

source/instructions.h

@@ -40,15 +40,8 @@ class Instructions {
     Uint32 ticksSpeed;   // Velocidad a la que se repiten los bucles del programa
     bool manualQuit;     // Indica si se quiere salir del modo manual
     mode_e mode;         // Modo en el que se van a ejecutar las instrucciones
-
+    bool finished;       // Indica si las instrucciones han terminado
-    // Actualiza las variables
+    bool quitRequested;  // Indica si se ha solicitado salir de la aplicación
-    void update();
-
-    // Pinta en pantalla
-    void render();
-
-    // Comprueba los eventos
-    void checkEvents();
 
     // Comprueba las entradas
     void checkInput();
@@ -62,4 +55,22 @@ class Instructions {
 
     // Bucle principal
     void run(mode_e mode);
+
+    // Inicia las instrucciones (sin bucle)
+    void start(mode_e mode);
+
+    // Actualiza las variables
+    void update();
+
+    // Pinta en pantalla
+    void render();
+
+    // Comprueba los eventos
+    void checkEvents();
+
+    // Indica si las instrucciones han terminado
+    bool hasFinished() const;
+
+    // Indica si se ha solicitado salir de la aplicación
+    bool isQuitRequested() const;
 };

source/title.cpp

@@ -120,6 +120,11 @@ void Title::init() {
     ticksSpeed = 15;
     fade->init(0x17, 0x17, 0x26);
     demo = true;
+    vibrationStep = 0;
+    vibrationInitialized = false;
+    instructionsActive = false;
+    demoGameActive = false;
+    demoThenInstructions = false;
 
     // Pone valores por defecto a las opciones de control
     options->input.clear();
@@ -257,21 +262,27 @@ void Title::update() {
 
             // Sección 2 - Titulo vibrando
             case SUBSECTION_TITLE_2: {
-                // Agita la pantalla
+                // Captura las posiciones base y reproduce el sonido la primera vez
-                static const int v[] = {-1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, 0};
+                if (!vibrationInitialized) {
-                static const int a = coffeeBitmap->getPosX();
+                    vibrationCoffeeBaseX = coffeeBitmap->getPosX();
-                static const int b = crisisBitmap->getPosX();
+                    vibrationCrisisBaseX = crisisBitmap->getPosX();
-                static int step = 0;
+                    vibrationInitialized = true;
+                }
 
-                coffeeBitmap->setPosX(a + v[step / 3]);
+                // Agita la pantalla
-                crisisBitmap->setPosX(b + v[step / 3]);
+                const int v[] = {-1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, 0};
+
+                coffeeBitmap->setPosX(vibrationCoffeeBaseX + v[vibrationStep / 3]);
+                crisisBitmap->setPosX(vibrationCrisisBaseX + v[vibrationStep / 3]);
                 dustBitmapR->update();
                 dustBitmapL->update();
 
-                step++;
+                vibrationStep++;
 
-                if (step == 33) {
+                if (vibrationStep >= 33) {
                     section->subsection = SUBSECTION_TITLE_3;
+                    vibrationStep = 0;
+                    vibrationInitialized = false;
                 }
             } break;
 
@@ -311,10 +322,8 @@ void Title::update() {
                                 counter = TITLE_COUNTER;
                                 menu.active->reset();
                                 if (demo) {
+                                    demoThenInstructions = true;
                                     runDemoGame();
-                                    if (section->name != SECTION_PROG_QUIT) {
-                                        runInstructions(m_auto);
-                                    }
                                 } else
                                     section->name = SECTION_PROG_LOGO;
                                 break;
@@ -482,13 +491,8 @@ void Title::update() {
                     }
                 } else if (counter == 0) {
                     if (demo) {
+                        demoThenInstructions = true;
                         runDemoGame();
-                        if (section->name != SECTION_PROG_QUIT) {
-                            runInstructions(m_auto);
-                        }
-                        init();
-                        demo = false;
-                        counter = TITLE_COUNTER;
                     } else {
                         section->name = SECTION_PROG_LOGO;
                     }
@@ -497,8 +501,6 @@ void Title::update() {
                 // Sección Instrucciones
                 if (section->subsection == SUBSECTION_TITLE_INSTRUCTIONS) {
                     runInstructions(m_auto);
-                    counter = TITLE_COUNTER;
-                    demo = true;
                 }
             }
 
@@ -539,14 +541,7 @@ void Title::render() {
         } break;
 
         // Sección 2 - Titulo vibrando
-        case SUBSECTION_TITLE_2: {  // Reproduce el efecto sonoro
+        case SUBSECTION_TITLE_2: {
-            JA_PlaySound(crashSound);
-
-            // Agita la pantalla
-            const int v[] = {-1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, -1, 1, 0};
-            const int a = coffeeBitmap->getPosX();
-            const int b = crisisBitmap->getPosX();
-            for (int n = 0; n < 11 * 3; ++n) {
             // Prepara para empezar a dibujar en la textura de juego
             screen->start();
 
@@ -562,25 +557,16 @@ void Title::render() {
             // Dibuja el degradado
             gradient->render();
 
-                // Dibuja los objetos
+            // Dibuja los objetos (posiciones ya actualizadas por update)
-                coffeeBitmap->setPosX(a + v[n / 3]);
-                crisisBitmap->setPosX(b + v[n / 3]);
             coffeeBitmap->render();
             crisisBitmap->render();
 
-                dustBitmapR->update();
-                dustBitmapL->update();
             dustBitmapR->render();
             dustBitmapL->render();
 
             // Vuelca el contenido del renderizador en pantalla
             screen->blit();
-            }
+        } break;
-
-            section->subsection = SUBSECTION_TITLE_3;
-        }
-
-        break;
 
         // Sección 3 - La pantalla de titulo con el menú y la música
         case SUBSECTION_TITLE_3: {  // Prepara para empezar a dibujar en la textura de juego
@@ -902,25 +888,83 @@ void Title::applyOptions() {
 
 // Bucle para el titulo del juego
 void Title::run() {
-    while (section->name == SECTION_PROG_TITLE) {
+    while (section->name == SECTION_PROG_TITLE || instructionsActive || demoGameActive) {
+        // Si las instrucciones están activas, delega el frame
+        if (instructionsActive) {
+            instructions->update();
+            instructions->checkEvents();
+            instructions->render();
+
+            if (instructions->hasFinished()) {
+                bool wasQuit = instructions->isQuitRequested();
+                delete instructions;
+                instructions = nullptr;
+                instructionsActive = false;
+
+                if (wasQuit) {
+                    section->name = SECTION_PROG_QUIT;
+                } else if (instructionsMode == m_auto) {
+                    // Tras instrucciones automáticas (post-demo o subsection), reinicia título
+                    section->name = SECTION_PROG_TITLE;
+                    init();
+                    demo = true;
+                } else {
+                    // Tras instrucciones manuales (HOW TO PLAY), vuelve al menú
+                    section->name = SECTION_PROG_TITLE;
+                    section->subsection = SUBSECTION_TITLE_3;
+                }
+            }
+            continue;
+        }
+
+        // Si el juego demo está activo, delega el frame
+        if (demoGameActive) {
+            demoGame->iterate();
+
+            if (demoGame->hasFinished()) {
+                bool wasQuit = (section->name == SECTION_PROG_QUIT);
+                delete demoGame;
+                demoGame = nullptr;
+                demoGameActive = false;
+
+                if (wasQuit) {
+                    section->name = SECTION_PROG_QUIT;
+                } else if (demoThenInstructions) {
+                    // Restaura el section para Title y lanza instrucciones
+                    section->name = SECTION_PROG_TITLE;
+                    section->subsection = SUBSECTION_TITLE_3;
+                    demoThenInstructions = false;
+                    runInstructions(m_auto);
+                } else {
+                    section->name = SECTION_PROG_TITLE;
+                    section->subsection = SUBSECTION_TITLE_1;
+                }
+            }
+            continue;
+        }
+
+        // Ejecución normal del título
         update();
         checkEvents();
         render();
     }
 }
 
-// Ejecuta la parte donde se muestran las instrucciones
+// Inicia la parte donde se muestran las instrucciones
 void Title::runInstructions(mode_e mode) {
     instructions = new Instructions(renderer, screen, asset, input, lang, section);
-    instructions->run(mode);
+    instructions->start(mode);
-    delete instructions;
+    instructionsActive = true;
+    instructionsMode = mode;
 }
 
-// Ejecuta el juego en modo demo
+// Inicia el juego en modo demo
 void Title::runDemoGame() {
+    // Guardamos el section actual para que Game pueda funcionar
+    section->name = SECTION_PROG_GAME;
+    section->subsection = SUBSECTION_GAME_PLAY_1P;
     demoGame = new Game(1, 0, renderer, screen, asset, lang, input, true, options, section);
-    demoGame->run();
+    demoGameActive = true;
-    delete demoGame;
 }
 
 // Modifica las opciones para los controles de los jugadores

source/title.h

@@ -22,7 +22,7 @@ struct JA_Music_t;
 struct JA_Sound_t;
 
 // Textos
-constexpr const char *TEXT_COPYRIGHT = "@2020 JailDesigner (v2.3.3)";
+constexpr const char *TEXT_COPYRIGHT = "@2020 JailDesigner (v2.3.4)";
 
 // Contadores
 constexpr int TITLE_COUNTER = 800;
@@ -90,6 +90,18 @@ class Title {
     std::vector<input_t> availableInputDevices;  // Vector con todos los metodos de control disponibles
     std::vector<int> deviceIndex;                // Indice para el jugador [i] del vector de dispositivos de entrada disponibles
 
+    // Variables para la vibración del título (SUBSECTION_TITLE_2)
+    int vibrationStep;          // Paso actual de la vibración
+    int vibrationCoffeeBaseX;   // Posición X base del bitmap Coffee
+    int vibrationCrisisBaseX;   // Posición X base del bitmap Crisis
+    bool vibrationInitialized;  // Indica si se han capturado las posiciones base
+
+    // Variables para sub-estados delegados (instrucciones y demo)
+    bool instructionsActive;    // Indica si las instrucciones están activas
+    bool demoGameActive;        // Indica si el juego demo está activo
+    mode_e instructionsMode;    // Modo de las instrucciones activas
+    bool demoThenInstructions;  // Indica si tras la demo hay que mostrar instrucciones
+
     // Inicializa los valores
     void init();