update readme and improve sound a little; also make it so the game saves/loads while still in menu

Author: finger563

README.md

@@ -7,6 +7,32 @@
     </tr>
 </table>
 
+![image](https://github.com/user-attachments/assets/209ed9aa-22f0-4ee0-9868-65abb1b64bbc)
+
+https://github.com/user-attachments/assets/2d3da6ea-2e80-42c3-bbd6-5a2c59601201
+
+<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
+**Table of Contents**
+
+- [esp-box-emu](#esp-box-emu)
+  - [Overview](#overview)
+  - [Images and Videos](#images-and-videos)
+  - [Parts](#parts)
+  - [Features](#features)
+  - [Cloning](#cloning)
+  - [Build and Flash](#build-and-flash)
+  - [Rom Setup and Configuration (uSD Card)](#rom-setup-and-configuration-usd-card)
+    - [ROM Images](#rom-images)
+    - [Metadata.csv format](#metadatacsv-format)
+  - [References and Inspiration:](#references-and-inspiration)
+    - [Other NES Emulators](#other-nes-emulators)
+    - [Other Genesis Emulators](#other-genesis-emulators)
+    - [Useful Background / Information](#useful-background--information)
+
+<!-- markdown-toc end -->
+
+## Overview
+
 The ESP-BOX-EMU is a gameboy-inspired add-on for the ESP32-S3-BOX and
 ESP32-S3-BOX-3 which provides:
 - Game Controller (gamepad input with a/b/x/y, start/select, d-pad)
@@ -37,10 +63,20 @@ ESP32-S3-BOX-3 which provides:
     and configuration (sound, brightness, display, etc.). (all generated from
     Squareline Studio)
 
+## Images and Videos
+
+![image](https://github.com/user-attachments/assets/d867d5fa-4c22-42e3-b04f-1edd5288c5d2)
+![image](https://github.com/user-attachments/assets/ad892905-37d4-4e16-8d5f-a7ff8d2a2c52)
+![image](https://github.com/user-attachments/assets/b141daab-2cda-481c-98c2-980b012f177e)
+
+![image](https://github.com/user-attachments/assets/d23659b6-10d4-4375-8017-675e156a1a4b)
+
 https://github.com/esp-cpp/esp-box-emu/assets/213467/3b77f6bd-4c42-417a-9eb7-a648f31b4008
 
 https://github.com/esp-cpp/esp-box-emu/assets/213467/a3d18d03-c6a1-4911-89d1-e18119e8cc03
 
+## Parts
+
 This project is designed to be in the same form factor as the Gameboy Color and
 to reuse the same button plastics and membranes for a good play feel.
 

components/doom/prboom/g_game.c

@@ -253,7 +253,6 @@ int defaultskill;               //note 1-based
 int    bodyqueslot, bodyquesize;        // killough 2/8/98
 mobj_t **bodyque = 0;                   // phares 8/10/98
 
-static void G_DoSaveGame (boolean menu);
 static const byte* G_ReadDemoHeader(const byte* demo_p, size_t size, boolean failonerror);
 
 //
@@ -1706,7 +1705,7 @@ void G_SaveGameName(char *name, size_t size, int slot)
   snprintf(name, size, "%s/sav%d-%d.dsg", basesavegame, gamemission, slot);
 }
 
-static void G_DoSaveGame (boolean menu)
+void G_DoSaveGame (boolean menu)
 {
   lprintf(LO_INFO, "G_DoSaveGame... \n");
 

components/doom/prboom/g_game.h

@@ -57,6 +57,7 @@ void G_LoadGame(int slot, boolean is_command); // killough 5/15/98
 void G_ForcedLoadGame(void);           // killough 5/15/98: forced loadgames
 void G_DoLoadGame(void);
 void G_SaveGame(int slot, char *description); // Called by M_Responder.
+void G_DoSaveGame(boolean menu);
 void G_BeginRecording(void);
 // CPhipps - const on these string params
 void G_RecordDemo(const char *name);          // Only called by startup code.

components/doom/prboom/z_zone.c

@@ -363,7 +363,7 @@ void (Z_ChangeTag)(void *ptr, int tag DA(const char *file, int line))
 {
   memblock_t *block = (memblock_t *)((char *) ptr - HEADER_SIZE);
 
-  if (!ptr || tag == block->tag)
+  if (!ptr || !block || tag == block->tag)
     return;
 
 #ifdef INSTRUMENTED

components/doom/src/doom.cpp

@@ -15,6 +15,7 @@ static bool unlock = false;
 
 static uint16_t doom_palette[256];
 
+// Range is [0, 15]
 static constexpr int DEFAULT_AUDIO_VOLUME = 15;
 static std::unique_ptr<espp::Task> audio_task;
 
@@ -522,6 +523,7 @@ void load_doom(std::string_view save_path, int save_slot) {
         // load the game
         bool command = false;
         G_LoadGame(save_slot, command);
+        G_DoLoadGame();
     }
 }
 
@@ -532,6 +534,7 @@ void save_doom(std::string_view save_path, int save_slot) {
         // save the game
         auto description = fmt::format("Save Slot {}", save_slot);
         G_SaveGame(save_slot, const_cast<char*>(description.c_str()));
+        G_DoSaveGame(true);
     }
 }