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

4.1 KiB
Raw Blame History

原始整数缩放比例修复(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$' 选择;真实核心尺寸检查见 探针说明,传入 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。