epic: refactor SDL2_Renderer usage to IRenderer and queued texture rendering

- Updated the testing guide to clarify the testing framework's organization and execution methods, improving user understanding.
- Refactored CMakeLists to include new platform-specific files, ensuring proper integration of the rendering backend.
- Modified main application files to utilize the new IRenderer interface, enhancing flexibility in rendering operations.
- Implemented deferred texture management in various components, allowing for more efficient graphics handling and improved performance.
- Introduced new methods for texture creation and updates, streamlining the rendering process across the application.
- Enhanced logging and error handling in the rendering pipeline to facilitate better debugging and diagnostics.

src/app/emu/emu.cc

@@ -1,5 +1,5 @@
 #if __APPLE__
-#include "app/core/platform/app_delegate.h"
+#include "app/platform/app_delegate.h"
 #endif
 
 #include <SDL.h>
@@ -14,6 +14,8 @@
 #include "absl/flags/parse.h"
 #include "app/emu/snes.h"
 #include "app/rom.h"
+#include "app/gfx/backend/irenderer.h"
+#include "app/gfx/backend/sdl2_renderer.h"
 #include "util/sdl_deleter.h"
 
 ABSL_FLAG(std::string, emu_rom, "", "Path to the ROM file to load.");
@@ -86,17 +88,13 @@ int main(int argc, char **argv) {
     return EXIT_FAILURE;
   }
 
-  std::unique_ptr<SDL_Renderer, SDL_Deleter> renderer_(
-      SDL_CreateRenderer(window_.get(), -1,
-                         SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC),
-      SDL_Deleter());
-  if (!renderer_) {
-    printf("SDL_CreateRenderer failed: %s\n", SDL_GetError());
-    SDL_Quit();
-    return EXIT_FAILURE;
+  // Create and initialize the renderer
+  auto renderer = std::make_unique<yaze::gfx::SDL2Renderer>();
+  if (!renderer->Initialize(window_.get())) {
+      printf("Failed to initialize renderer\n");
+      SDL_Quit();
+      return EXIT_FAILURE;
   }
-  SDL_SetRenderDrawBlendMode(renderer_.get(), SDL_BLENDMODE_BLEND);
-  SDL_SetRenderDrawColor(renderer_.get(), 0x00, 0x00, 0x00, 0xFF);
 
   // Initialize audio system
   constexpr int kAudioFrequency = 48000;
@@ -120,10 +118,7 @@ int main(int argc, char **argv) {
   SDL_PauseAudioDevice(audio_device, 0);
 
   // Create PPU texture for rendering
-  SDL_Texture* ppu_texture = SDL_CreateTexture(renderer_.get(), 
-                                                SDL_PIXELFORMAT_RGBX8888,
-                                                SDL_TEXTUREACCESS_STREAMING, 
-                                                512, 480);
+  void* ppu_texture = renderer->CreateTexture(512, 480);
   if (!ppu_texture) {
     printf("SDL_CreateTexture failed: %s\n", SDL_GetError());
     SDL_CloseAudioDevice(audio_device);
@@ -271,20 +266,17 @@ int main(int argc, char **argv) {
         // Render PPU output to texture
         void *ppu_pixels = nullptr;
         int ppu_pitch = 0;
-        if (SDL_LockTexture(ppu_texture, nullptr, &ppu_pixels, &ppu_pitch) != 0) {
-          printf("Failed to lock texture: %s\n", SDL_GetError());
-          running = false;
-          break;
+        if (renderer->LockTexture(ppu_texture, nullptr, &ppu_pixels, &ppu_pitch)) {
+          snes_.SetPixels(static_cast<uint8_t*>(ppu_pixels));
+          renderer->UnlockTexture(ppu_texture);
         }
-        snes_.SetPixels(static_cast<uint8_t*>(ppu_pixels));
-        SDL_UnlockTexture(ppu_texture);
       }
     }
 
     // Present rendered frame
-    SDL_RenderClear(renderer_.get());
-    SDL_RenderCopy(renderer_.get(), ppu_texture, nullptr, nullptr);
-    SDL_RenderPresent(renderer_.get());
+    renderer->Clear();
+    renderer->RenderCopy(ppu_texture, nullptr, nullptr);
+    renderer->Present();
   }
 
   // === Cleanup SDL resources (in reverse order of initialization) ===
@@ -292,7 +284,7 @@ int main(int argc, char **argv) {
   
   // Clean up texture
   if (ppu_texture) {
-    SDL_DestroyTexture(ppu_texture);
+    renderer->DestroyTexture(ppu_texture);
     ppu_texture = nullptr;
   }
   
@@ -302,7 +294,7 @@ int main(int argc, char **argv) {
   SDL_CloseAudioDevice(audio_device);
   
   // Clean up renderer and window (done automatically by unique_ptr destructors)
-  renderer_.reset();
+  renderer->Shutdown();
   window_.reset();
   
   // Quit SDL subsystems