Files
NESLite/docs/reports/integer-scaling-0.9.18.md
T

53 lines
4.1 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.
# 原始整数缩放比例修复(0.9.18)
日期:2026-09-14。对应 F04/M2-03a、M2-03b。本次修复用户截图中 Nestopia 游戏画面横向拉宽的
问题,完成 L1 局部验证并提供调试 APK;未连接 Android 设备,M2-03b 的 L2 画面复核仍待完成。
## 原因与改动
固定提交的 Nestopia 默认启用复合视频过滤,视频回调输出为 602×224,
`retro_get_system_av_info` 给出的基础尺寸仍为 256×224。原渲染器直接以纹理宽高计算整数倍率,
把横向扩展的采样宽度当成了 NES 原始像素宽度,因此整幅画面变扁。
- 视频缓冲同时保存纹理尺寸和基础尺寸,像素与基础尺寸在同一帧快照内交接;重复帧保留上一完整快照,
新帧使用当时的基础尺寸,缺失基础尺寸时成对回退为纹理尺寸。
- GL 仍按纹理实际宽高上传;整数显示改按基础宽高选择最大共同整数倍率并居中。空间不足一倍时,
等比例缩小以完整显示。4:3 模式继续按 4:3 适配,暂停时切换模式也重新计算显示区域。
- 沿用内核选项、固定提交、存档配置身份与存档路径;这次只修正前端显示尺寸。
在 1664×1248 的显示区域中,Nestopia 旧算法得到 1204×448;修复后为 1280×1120,即
256×224 的五倍,与同基础尺寸的 FCEUmm 相同。原始整数模式保持基础像素比例,与强制 4:3 显示有区别。
## 分级验证
| 层级/检查 | 结果与范围 |
| --- | --- |
| L1/显示与缓冲 | `neslite_video_viewport_test` 通过:扩展纹理与基础尺寸分离、共同整数倍率、4:3 切换、区域大小变化、重复帧、缓冲清空与新帧尺寸、缺失基础尺寸、刚好一倍和不足一倍边界 |
| L1/共享缓冲回归 | `neslite_core_selection_test` 通过,保留原有格式转换与跨内核帧序号检查 |
| L1/真实内核尺寸 | 对已有本地“龙珠英雄”样本,两内核各采集 60 帧;FCEUmm 为纹理 256×224/基础 256×224,Nestopia 为纹理 602×224/基础 256×224,生产显示算法均计算出 1280×1120,位置 192,64 |
| L1/应用构建 | 最终 `assembleDebug` 通过;`BuildIdentityTest` 1 项和 `AspectRatioFrameLayoutTest` 3 项通过 |
| L1/最终 APK | 3 个 arm64 原生库的 ELF LOAD 段与 APK 16 KB 对齐检查通过,版本 0.9.18-debug/9018 |
| L2/手机画面 | 待复核;ADB 无已连接设备。桌面探针使用真实内核和生产尺寸算法,不启动 Android/GL,也未运行截图中的 Mario ROM |
本次没有运行 Stage 全量、全 ROM 遍历、长稳或重新执行历史专项。桌面探针自带的一次核心状态往返
也返回通过,仅保留在日志中,不作为本次存档验收。尺寸验证使用原样本的字节相同副本,ROM 不进入 APK。
日志:`.build/video-viewport-native-0.9.18.log`、`.build/video-viewport-android-0.9.18.log`、
`.build/video-viewport-final-build-0.9.18.log`、`.build/video-viewport-native-apk-0.9.18.json`;
真实内核尺寸为 `.build/rom-probe/video-fceumm-0.9.18.log` 与 `video-nestopia-0.9.18.log`。
局部原生测试可在构建对应目标后用 CTest 的
`-R '^neslite_(video_viewport|core_selection)_test$'` 选择;真实核心尺寸检查见
[探针说明](../../tools/rom-probe/README.md),传入 60 帧即可。
## 安装包与待复核步骤
- APK:`.build/releases/NESLite-0.9.18-debug-arm64-v8a.apk`,与
`app/build/outputs/apk/debug/app-debug.apk` 字节相同;24,176,631 字节。
- SHA-256:`015D5C76BC8BF0E25549059DE21704470543D0A7170FB5F5D6C0BC6AEC7964E6`。
- application ID:`org.neslite.app.debug`;`versionCode = 9018`。当前工作区构建,未创建 Git 提交。
安装新版后,用 Nestopia 打开原截图中的游戏,在设置中切换“原始整数缩放”和“保持 4:3”,检查人物、
文字与场景不再横向拉宽,整数模式保留居中黑边;暂停时再切换一次确认立即生效。FCEUmm 的同类复核
与 XCORE-04 的切换检查合并完成,不重复跑同一路径;目标手机结果记录后再完成 M2-03b。