可选的单 ROM 桌面检查
用于区分 ROM/内核输出问题和 Android 显示问题。它使用项目锁定的两个内核,以及生产代码的哈希、 兼容选项、像素转换和显示尺寸计算;不启动 Android、Oboe 或 GL,不代替实机验收。默认检查一份 ROM 的 1800 帧, 保存几个 PPM 帧和统计结果,再做一次核心状态往返;不会安装为应用或自动加入 Stage 检查。
本机已验证 MinGW GCC 16.1.0/Ninja。从项目根目录配置(先按 docs/build.md 获取固定第三方源码):
$taskSdkCmake = "$env:LOCALAPPDATA\Android\Sdk\cmake\3.22.1\bin"
$env:Path = "C:\gcc-16.1.0-64\bin;$env:Path"
& "$taskSdkCmake\cmake.exe" -S tools/rom-probe -B build/rom-check -G Ninja "-DCMAKE_MAKE_PROGRAM=$taskSdkCmake/ninja.exe" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_BUILD_TYPE=Release
& "$taskSdkCmake\cmake.exe" --build build/rom-check --target probe_fceumm probe_nestopia -j 8
Copy-Item -LiteralPath '龙珠英雄.nes' -Destination build/rom-check/sample.nes
& build/rom-check/probe_fceumm.exe build/rom-check/sample.nes build/rom-check/fceumm 1800
& build/rom-check/probe_nestopia.exe build/rom-check/sample.nes build/rom-check/nestopia 1800
Windows 的上游文件接口要求 UTF-8,而窄字符命令行编码可能不同,所以本机检查使用 ASCII 名称的 字节相同副本;它不修改原 ROM,也不涉及应用内已经使用哈希文件名的导入路径。样本不进入 Git。
可在帧数后传 original-defaults 暂时绕过兼容规则,重现两个内核的原始选项。帧数限 60~3600。
只核对显示尺寸时可传 60 帧;输出 texture 为回调纹理尺寸,base 为核心基础尺寸,
integer_viewport 为生产算法在 1664×1248 区域内计算的整数缩放结果,不是实际 Android 截图。
固定输入脚本在第 180、420 帧按 Start,在第 720~1620 帧每隔 180 帧按一次 A,每次 3 帧;这只是
可重复的启动/菜单操作,不是通用自动游玩或完整游戏验收。
输出中的非零音频计数表示核心确实产生音频样本,不代表听感测试通过。退出码为零仅表示加载及核心 状态往返成功;仍须查看帧内容判断是否卡死/黑屏。原始 NTSC 下的 CPU 卡死也可能支持状态序列化。 状态往返比较恢复前后再运行 30 帧的画面哈希,不触碰用户存档,也不替代应用存档封装/写盘测试。