Correct selection orientation, game-entry lifecycle, mounted NPCs, labels and skill panels. Add the native GPU scene path, resident geometry, bounded texture and Python caches, and collision broad phase. Pin the independently maintained Metin2 SDK through a submodule and document reproducible setup. Include rendering regressions and macOS packaging improvements. Validation: client Debug build and 12 targeted client tests passed; SDK build and all 14 SDK tests passed.
41 lines
2.7 KiB
Markdown
41 lines
2.7 KiB
Markdown
# 选角标题、国旗和边框重复的原因
|
||
|
||
调查日期:2026-10-10。对应用户 22:58:52 截图。
|
||
|
||
## 已确认的根因
|
||
|
||
移植版图片实例的销毁过程遗漏了状态初始化:
|
||
|
||
- `src/eter_image/GrpImageInstance.h` 的 `Destroy()` 只清除图片引用,没有调用 `Initialize()`,缩放、颜色/透明度、位置和翻转状态可能被保留。
|
||
- `src/eter_image/GrpExpandedImageInstance.h` 的 `Destroy()` 只调用基类销毁,没有调用派生类 `Initialize()`,平铺范围、旋转和混合模式等状态可能被保留。
|
||
- `shared/common/DynamicPool.h` 的 `Alloc()` 直接返回空闲对象,不重新运行构造函数。它依赖对象在归还时重置状态。
|
||
|
||
登录 UI 的边框使用正的 `SetRenderingRect` 扩展值来平铺纹理。对象释放并在选角 UI 中复用后,这些值被新图片继承。`GrpImageInstance.cpp` 的扩展图片渲染会据此扩大目标矩形,并调用 `SDL_RenderTextureTiled`,于是标题、国旗和角落纹理被重复绘制。
|
||
|
||
Windows 参考实现中,基类和扩展图片类的 `Destroy()` 都会调用各自的 `Initialize()`。移植版遗漏了这两个调用。
|
||
|
||
## 验证证据
|
||
|
||
使用原版 Python 登录 UI 和模拟角色数据,在本地测试中关闭登录 UI、释放登录阶段回调引用、执行 Python GC 和窗口管理器 Update,再创建选角 UI。没有进行服务器认证。
|
||
|
||
复用日志记录到:
|
||
|
||
```text
|
||
locale/en/ui/select/name_warrior.sub rect=(0,0,32.3125,0)
|
||
locale/en/ui/select/empire/empireflag_c.sub rect=(0,0,10,0)
|
||
thinboard_corner_lefttop_gold.tga rect=(0,0,0,22)
|
||
thinboard_corner_righttop_gold.tga rect=(0,0,20.4375,0)
|
||
```
|
||
|
||
生成截图复现了用户图中的横向 Warrior 标题、国旗横条,以及横向/纵向重复的边框。重复数量受窗口尺寸、裁剪和对象复用顺序影响。
|
||
|
||
临时在两个 `Destroy()` 中恢复 `Initialize()`,以同一复现流程运行后,这些继承的扩展值和重复条带消失,四角色选角检查通过。实验结束后,临时源代码修改和诊断日志均已撤回;本次没有更新发布包。
|
||
|
||
证据保存在忽略的生成目录 `build/verification/pool-investigation/`:`before/slot0.png`、`after/slot0.png`、`before.log`、`after.log`、`login_select_repro.cpp` 和 `proposed-reset.patch`。
|
||
|
||
## 修复及验证建议
|
||
|
||
恢复基类、派生类销毁时的初始化。应保留 UI 边框正常使用的平铺功能。
|
||
|
||
先前测试直接进入选角,未覆盖登录图片对象回收。现有选角测试的白块、模型和字体断言也没有检测重复纹理,因此复现图异常时仍会通过。后续应增加对象复用状态断言、登录到选角的转换,以及标题/国旗绘制范围检查,并覆盖返回登录后再次选角。
|