add pause and quit

docs/index.html

@@ -63,7 +63,7 @@
                 <tr><td>Start (Enter)</td><td>Pause</td></tr>
                 <tr><td>Select (V)</td><td>About</td></tr>
             </table>
-            <p>Press Left or Right on the title screen to show either the black or white highscores. Press Select to show the about screen and build info.</p>
+            <p>Press Left or Right on the title screen to show either the black or white highscores. Press Select to show the about screen and build info. In-game press Start to pause and resume. While paused press Select to return to the menu.</p>
             <p>Collect small white spheres to get +5 white score. Collect small black spheres to get +5 black score. The opposite color will reduce your score when collected. Large black holes will attract you and damage your ship when touched. Large white spheres will repel you and replenish your health when touched. Accelerating will reduce your fuel, which will recharge when not accelerating. You can shoot large spheres for +10 points.<p>
             <p>For a more detailed description of the original game check out the <a href="https://gta.fandom.com/wiki/Duality">Duality article on GTA Wiki</a>.</p>
             <hr>

src/game.c

@@ -22,6 +22,7 @@
 #include <rand.h>
 #include <stdint.h>
 
+#include "gb/gb.h"
 #include "maps.h"
 #include "obj.h"
 #include "sprites.h"
@@ -297,14 +298,35 @@ int32_t game(void) NONBANKED {
             }
         }
 
+        // re-draw ship sprite when we've just rotated or are starting or stopping acceleration
+        uint8_t redraw = (acc & ACC_R) || ((prev_acc & (ACC_X | ACC_Y)) != (acc & (ACC_X | ACC_Y)));
+
+        if (key_pressed(J_START)) {
+            uint8_t hiwater = SPR_NUM_START;
+            spr_draw(SPR_PAUSE, FLIP_NONE, 0, 0, 0, &hiwater);
+            hide_sprites_range(hiwater, MAX_HARDWARE_SPRITES);
+
+            while (1) {
+                key_read();
+                if (key_pressed(J_START)) {
+                    break;
+                } else if (key_pressed(J_SELECT)) {
+                    return score;
+                }
+                vsync();
+            }
+
+            // re-draw ship sprite
+            redraw = 1;
+        }
+
         pos_x += spd_x;
         pos_y += spd_y;
         move_bkg(pos_x >> POS_SCALE_BG, pos_y >> POS_SCALE_BG);
 
         uint8_t hiwater = SPR_NUM_START;
 
-        // re-draw ship sprite when we've just rotated or are starting or stopping acceleration
-        if ((acc & ACC_R) || ((prev_acc & (ACC_X | ACC_Y)) != (acc & (ACC_X | ACC_Y)))) {
+        if (redraw) {
             spr_ship(rot, acc & (ACC_X | ACC_Y), &hiwater);
             ship_hiwater = hiwater;
         } else {

src/sprite_data.c

@@ -28,6 +28,7 @@
 #include "shoot.h"
 #include "bar_spr8.h"
 #include "expl_spr16.h"
+#include "pause.h"
 
 BANKREF(power_palettes)
 
@@ -135,5 +136,16 @@ struct sprites metasprites[SPRITE_COUNT] = {
         .cnt = expl_spr16_TILE_COUNT,
         .off = TILE_NUM_START,
         .bank = BANK(expl_spr16),
-    }
+    },
+    { // SPR_PAUSE
+        .ms = pause_metasprites,
+        .ms_n = ARR_LEN(pause_metasprites),
+        .ti = pause_tiles,
+        .pa = pause_palettes,
+        .pa_n = pause_PALETTE_COUNT,
+        .pa_i = OAMF_CGB_PAL7,
+        .cnt = pause_TILE_COUNT,
+        .off = TILE_NUM_START,
+        .bank = BANK(pause),
+    },
 };

src/sprites.h

@@ -35,6 +35,7 @@ enum SPRITES {
     SPR_HEALTH,
     SPR_POWER,
     SPR_EXPL,
+    SPR_PAUSE,
 
     SPRITE_COUNT
 };