Files
NESLite/tools/rom-probe/README.md
T

31 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 可选的单 ROM 桌面检查
用于区分 ROM/内核输出问题和 Android 显示问题。它使用项目锁定的两个内核,以及生产代码的哈希、
兼容选项、像素转换和显示尺寸计算;不启动 Android、Oboe 或 GL,不代替实机验收。默认检查一份 ROM 的 1800 帧,
保存几个 PPM 帧和统计结果,再做一次核心状态往返;不会安装为应用或自动加入 Stage 检查。
本机已验证 MinGW GCC 16.1.0/Ninja。从项目根目录配置(先按 `docs/build.md` 获取固定第三方源码):
```powershell
$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 帧的画面哈希,不触碰用户存档,也不替代应用存档封装/写盘测试。