OpenGOAL项目中的Jak3角色眼睛纹理渲染问题分析

问题现象

在OpenGOAL项目对Jak3游戏的逆向工程实现过程中，开发人员发现主角Jak的眼睛渲染出现了异常。具体表现为眼睛的虹膜/瞳孔部分使用了错误的纹理贴图，显示为一个彩虹色的图案，而不是预期的虹膜纹理。

通过RenderDoc图形调试工具捕获的渲染过程显示，游戏错误地使用了纹理库页面179(TBP 179)的纹理，而这个纹理实际上应该是用于游戏HUD元素"hud-npcring-bar-01"的。

技术背景

在PlayStation 2架构中，纹理是通过纹理库页面(Texture Bank Page)来管理的。每个纹理都有一个唯一的TBP编号，游戏引擎通过这个编号来引用纹理。在Jak3游戏中，眼睛的渲染需要正确加载和使用特定的虹膜纹理。

问题根源分析

通过日志分析发现，纹理179被多个不同的资源引用：

1. 首先被"level-default-minimap/hud-npcring-bar-01"使用
2. 然后被"level-default-pris/bam-iris-16x16"覆盖
3. 最后又被"level-default-minimap/hud-npcring-bar-01"重新上传

而眼睛渲染发生在"tex-lcom-tfrag"渲染桶(bucket)中，而不是预期的"tex-lcom-pris"桶。这导致了两个潜在问题：

1. 渲染桶选择不当：眼睛渲染应该在包含眼睛纹理上传的同一个渲染桶中进行，通常是"tex-lcom-pris"桶，但实际发生在"tex-lcom-tfrag"桶中。

2. 纹理上传时序问题：可能是原游戏中的bug，导致纹理179的上传时序不正确，而PC端口实现时无意中暴露了这个问题。

解决方案验证

开发人员尝试通过强制设置渲染目标的默认纹理页面来解决这个问题：

(set! (-> *target* draw default-texture-page) 1)

这个修改指定渲染目标使用"pris"纹理页面，成功使眼睛渲染恢复正常。这表明问题的根源可能是default-texture-page属性没有被正确设置。

技术启示

这个问题揭示了游戏引擎中几个重要的设计考量：

1. 纹理管理策略：共享纹理页面需要谨慎处理上传和使用时序，特别是在动态加载的场景中。

2. 渲染桶划分逻辑：相关资源的渲染应该放在同一个桶中，以确保状态一致性。

3. 逆向工程挑战：原游戏可能存在一些隐式依赖或未文档化的行为，在重新实现时需要特别注意。

这个案例也展示了如何使用图形调试工具和日志分析来诊断复杂的渲染问题，为游戏逆向工程提供了有价值的参考。