[Feat] (trace-replay): add Minecraft main menu trace

tools/trace_replay/CMakeLists.txt

@@ -365,3 +365,13 @@ add_trace_replay_test_for_backends(minecraft-1.21.4-startup
         HEIGHT 480
         TOLERANCE 20
         FUZZ_PERCENT 20)
+
+add_trace_replay_test_for_backends(minecraft-1.21.4-main-menu
+        TRACE_ARCHIVE ${MOBILEGL_TRACE_ROOT}/fixtures/minecraft-1.21.4-main-menu.tgz
+        TRACE_FILE trace.trace
+        GOLDEN ${MOBILEGL_TRACE_ROOT}/fixtures/minecraft-1.21.4-main-menu.0000481787.png
+        TARGET_CALL 481787
+        WIDTH 854
+        HEIGHT 480
+        TOLERANCE 500
+        FUZZ_PERCENT 20)

tools/trace_replay/README.md

@@ -9,6 +9,8 @@ The bundled fixtures cover:
   traces rejected because they rely on compatibility/fixed-function OpenGL.
 - `minecraft-1.21.4-startup`: captured from Minecraft 1.21.4's Mojang Studios startup screen. The fixture is trimmed
   to call 92195, immediately after the startup screen draw into Minecraft's offscreen framebuffer.
+- `minecraft-1.21.4-main-menu`: captured from Minecraft 1.21.4's English (US) main menu. The fixture is trimmed to
+  call 481787, immediately after the main menu draw into Minecraft's offscreen framebuffer.
 
 Build from the MobileGL repository root:
 
@@ -48,6 +50,10 @@ build-test/tools/trace_replay/mobilegl_trace_replay \
 
 The Minecraft startup fixture uses `tools/trace_replay/fixtures/minecraft-1.21.4-startup.tgz`, golden image
 `minecraft-1.21.4-startup.0000092195.png`, `--target-call 92195`, `--width 854`, and `--height 480`.
+The Minecraft main-menu fixture uses `tools/trace_replay/fixtures/minecraft-1.21.4-main-menu.tgz`, golden image
+`minecraft-1.21.4-main-menu.0000481787.png`, `--target-call 481787`, `--width 854`, `--height 480`, and
+`--tolerance 500`.
+Each replay that has a golden image writes `${case}-diff.png` in the backend output directory.
 
 The Linux runner loads MobileGL by path with `dlopen`. It uses an EGL pbuffer for `DirectGLES` and maps the pbuffer
 path to `VK_EXT_headless_surface` for `DirectVulkan`, so CI does not need an X11 or Wayland window.

tools/trace_replay/run_trace_case.cmake

@@ -50,6 +50,7 @@ execute_process(
         COMMAND "${TRACE_REPLAY_EXE}"
         --trace "${trace_path}"
         --golden "${TRACE_GOLDEN}"
+        --diff "${TRACE_OUTPUT_DIR}/output/${TRACE_CASE_NAME}-diff.png"
         --output "${TRACE_OUTPUT_DIR}/output"
         --backend "${TRACE_BACKEND}"
         --mobilegl-library "${MOBILEGL_LIBRARY}"

tools/trace_replay/trace_replay_cli.cpp

@@ -14,6 +14,7 @@ void PrintUsage(const char *argv0) {
             << "\n"
             << "Options:\n"
             << "  --golden PATH             Golden PNG to compare against\n"
+            << "  --diff PATH               Difference PNG output path\n"
             << "  --backend NAME            DirectGLES or DirectVulkan (default: DirectGLES)\n"
             << "  --mobilegl-library PATH   libMobileGL.so path (default: libMobileGL.so)\n"
             << "  --width N                 Replay surface width override\n"
@@ -63,6 +64,8 @@ bool ParseArgs(int argc, char **argv, mobilegl_trace::Request &request) {
             if (!ReadValue(argc, argv, i, request.tracePath)) return false;
         } else if (arg == "--golden") {
             if (!ReadValue(argc, argv, i, request.goldenPath)) return false;
+        } else if (arg == "--diff") {
+            if (!ReadValue(argc, argv, i, request.diffPath)) return false;
         } else if (arg == "--output") {
             if (!ReadValue(argc, argv, i, request.outputDir)) return false;
         } else if (arg == "--backend") {
@@ -131,6 +134,7 @@ int main(int argc, char **argv) {
 
     std::cout << result.message << "\n"
               << "result: " << result.resultPath << "\n"
-              << "actual: " << result.actualPath << "\n";
+              << "actual: " << result.actualPath << "\n"
+              << "diff: " << result.diffPath << "\n";
     return result.passed ? 0 : result.statusCode;
 }