图形渲染与 Shader / 系统课时

把 Shader 做成跨平台可维护版本

把 Shader 做成跨平台可维护版本

同一个 Shader 在桌面端正常,并不代表在移动端、不同图形 API 或不同纹理格式下仍然稳定。本节把精度、关键词、资源格式和平台差异收敛到一套可检查的维护方式,让后续扩展效果时尽量只改公共逻辑,而不是不断复制平台分支。

学习目标

  • 区分应放在公共 Shader 逻辑中的内容与必须平台适配的差异
  • 用精度、关键词和资源约束减少编译变体与设备差异
  • 建立最小跨平台验证清单,避免只在单一设备上“看起来没问题”

先把变化点分层

可维护的核心不是把所有平台写成完全相同,而是让差异集中。通常可以把 Shader 拆成“公共计算、可选特性、平台边界”三层:公共层处理坐标、采样和光照;关键词只控制确实需要裁剪的功能;平台边界处理精度、纹理能力和编译器差异。

跨平台 Shader 维护分层示意

一旦发现某个平台需要修改公共公式,先判断它究竟是编译器限制、精度问题还是资源输入不同。只有确定无法通过统一写法解决时,才引入平台分支,否则维护成本会很快随平台数量增长。

精度先按用途选择

移动 GPU 上的精度选择会直接影响寄存器占用和计算稳定性。颜色、遮罩、部分 UV 往往可以使用中等精度;世界坐标、长距离深度、累积时间、法线重建等对误差敏感的量更适合高精度。不要为了“保险”全部升成高精度,也不要为了性能把所有量统一降级。

下面是一份可独立通过 GLSL ES 3.00 语法检查的片元 Shader。它显式声明浮点和整数默认精度,并把采样结果限制在最简单的跨平台路径上。

glsl
#version 300 es
precision highp float;
precision highp int;

uniform sampler2D uMainTex;
in vec2 vUv;
out vec4 fragColor;

void main() {
    vec4 color = texture(uMainTex, vUv);
    fragColor = vec4(color.rgb, 1.0);
}

可以使用 glslangValidator 做最小语法验证:

bash
glslangValidator -S frag portable.frag && echo compile-ok

预期输出:

text
compile-ok

若工具版本不同,成功时可能还会附带文件名等提示,但命令退出码应为 0。真正进入引擎后,还要分别在目标后端检查最终编译产物,而不是只依赖这一层语法检查。

关键词只控制真正的变体

关键词最容易让 Shader 从“一个文件”膨胀成大量编译变体。雾效、阴影接收、法线贴图这类会改变代码路径和资源绑定的功能,适合使用编译期关键词;颜色强度、阈值、速度等连续参数更适合运行时 uniform,不应为每个取值生成变体。

例如某个效果只有“是否启用雾”这一处分支,可以保持为单一关键词:

glsl
#ifdef USE_FOG
    color.rgb = mix(uFogColor, color.rgb, fogFactor);
#endif

这是片段示例,依赖当前 Shader 已定义 color、uFogColor 和 fogFactor。它的生效行为是:未定义 USE_FOG 时相关代码不会进入编译结果;定义后才编译雾效路径。验证时应分别构建开启和关闭两种变体,确认二者都能通过编译且视觉符合预期。

资源格式也属于 Shader 契约

很多所谓“平台 Shader 问题”其实来自资源格式。法线贴图是否经过正确导入、颜色纹理是否按 sRGB 解码、HDR 数据是否被低精度格式截断、压缩格式是否被目标设备支持,都会让相同代码得到不同结果。

维护时应给每类纹理写清契约:它表达的是颜色还是数据、需要几通道、是否允许压缩、是否依赖线性采样。只要资源输入不一致,继续调公式通常只会掩盖问题。

用固定清单做跨平台验收

至少覆盖一个桌面后端和一个真实移动设备,并检查正常视角、极端距离、低亮度、高亮度、透明叠加和功能关键词组合。出现差异时先比较输入资源与编译变体,再比较精度和坐标,最后才修改公式。

跨平台维护的目标不是消灭所有差异,而是让差异有固定位置、有验证入口,并且不会随着新效果加入而复制整套 Shader。做到这一点后,后续扩展通常只需修改公共层,再用同一份清单确认各平台没有回归。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把 Shader 做成跨平台可维护版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通