[bug反馈]构建天空盒边缘被拉伸

10/0325 浏览BUG反馈

天空接缝：给平台/引擎组的缺陷报告（可复现）

============================================================

一句话

--------------------------------------------------

立方体贴图（TextureCube，未压缩 RGBA8，256×256×6）在 Techniques/DiffSkybox.xml +

StaticModel 下渲染时，每一个面与面的交界处都会出现一条"本面边缘像素被拉伸"的带；

该现象在安卓真机与桌面浏览器（WebGL）上完全一致，且跨越 1.0.139 → 1.0.356

共 67 个引擎版本持续存在。

环境

--------------------------------------------------

- 引擎版本：日志中 Version: 1.0.356（期间见过 1.0.139…1.0.356，共 67 个）

- engine-res：1.32

- 客户端运行时：2.16.35（本次全程未变）

- 复现平台：① Redmi 24129RT7CC / Android ② 桌面浏览器（官方 Web 预览）

复现步骤（最小化）

--------------------------------------------------

1. 建一个天空节点：StaticModel + Models/Sphere.mdl，node.scale = 200

2. 材质：Techniques/DiffSkybox.xml + SetTexture(TU_DIFFUSE, cube)（cube = 6 面 KTX）

+ mat.depthWrite = false

3. 观察任一对面交界处

关键证据（用"边缘标记测试图"把机制可视化）

--------------------------------------------------

把六个面做成：独特底色 + 左暗右亮 + 上饱和下灰 + 最外一圈画成白色。

真机与浏览器结果一致：

- 每个面的底色与朝向标记位置都正确 ⇒ 面序/朝向无误

- 每一条面与面的交界处都出现【白色】带 ⇒ 带里的内容 = 该面最外一圈像素被拉伸铺开

- 六面填成同一个纯色时，缝完全消失 ⇒ 常数的钳制不可见（与"边缘钳制"机理一致）

结论（我们的判断）

--------------------------------------------------

硬件立方体贴图采样在数学上是连续函数，不可能在面边界产生这类伪影。

出现"边缘被钳制/拉伸"的带 ⇒ 说明该路径没有走硬件的方向采样，

而是走了"按面 UV 采样 + 边缘钳制"的实现。

为什么我们无法自行规避

--------------------------------------------------

- 官方 Skybox 组件：在本运行时渲染不出天空（Box ⇒ 纯色+远处小盒子；Sphere ⇒ 纯色+远处小球）

- 自建 surface shader：本设备 SetSurfaceShader 从未生效（项目内亦有相同记载）

- 材质 pass 层：technique passes=1 正常，但 mat:GetPass(0) 返回 nil ⇒ 取不到 pass

⇒ 三条本可绕开的路径全部不可用，只剩"改烘焙好的贴图"。

顺带发现的一个资源缺失（可能与 Skybox 组件失效有关）

--------------------------------------------------

浏览器控制台报错：

------------------------------------------------------------

Could not find resource <official-res>/assets/DgRecSAR4qVdwosqqNXg2Hhe-73030c7e.ktx

------------------------------------------------------------

该文件名不在我们的工程里（全仓搜索无命中）⇒ 是引擎/官方资源侧引用的一个 ktx，但包内不存在。

怀疑：引擎的默认立方体贴图（Skybox/环境）缺失 ⇒ 官方 Skybox 组件因此渲染不出天空。

期望

--------------------------------------------------

1. TextureCube 采样走真正的硬件方向采样（面边界无缝）

2. 或提供可用的绕开路径（Skybox 组件 / surface shader / pass 层三者至少一个可用）

3. 补上 <official-res>/assets/…ktx 那个缺失资源

补充：为什么此前难以定位（供参考）

--------------------------------------------------

sources.engine.tag = "stable" 是别名 ⇒ 每次构建的引擎版本都在变

（九天 67 个、本日 11 个、最后 31 分钟 4 个）⇒ 实验之间条件不一致，极易误判。

建议：需要可复现的调试时，用 sources.engine.version = "1.0.356" 锁定。

============================================================

生成时间：2026-10-03 09:23

来源：pixel-spirit/SKY_SEAM_BUGREPORT.md（同内容）

TapTap 制造应用

9.8

前往论坛