The Book of Shaders 精读:GLSL precision 精度限定符(lowp / mediump / highp)详解
The Book of Shaders 精读:GLSL precision 精度限定符(lowp / mediump / highp)详解
导读
在《The Book of Shaders》的碎片着色器(Fragment Shader)代码中,几乎每个示例的第一行都写着 precision mediump float;。这行看似不起眼的声明,实际上决定了 GPU 内部所有浮点与整型变量被存储和计算时的最小位宽与取值范围,直接关系着渲染画质与运行速度。本文以仓库 glossary/precision/README-ua.md 词条为核心,结合仓库内数十个 .frag 着色器示例,系统讲解 precision 的声明语法、三个精度级别的量化范围、与 GL_ES 条件编译的配合方式,以及在不同场景下如何权衡精度与性能。
precision 是什么:为变量存储设定最小精度的限定符
精度限定符(precision qualifier)声明了底层实现(GPU 驱动/着色器编译器)在存储相应类型变量时必须使用的最小范围与精度。换句话说,precision lowp float; 并不是把浮点运算"锁死"在一个固定精度上,而是告诉编译器:这类变量至少要达到 lowp 所规定的位宽与范围,具体实现可以做得更好,但不能更差。
这一点从词条的乌克兰语原文可以直读出来:"Кваліфікатор точності оголошує мінімальний діапазон і точність, які базова реалізація повинна використовувати під час зберігання відповідних змінних"——即"精度限定符声明了基础实现在存储相应变量时必须使用的最小范围与精度"。关键词是"最小"(мінімальний):它定义的是下限契约,而非精确的位宽规格。
声明语法:六种合法组合
precision 语句位于着色器源码顶层(通常在 main() 之前),语法为:
precision <精度级别> <数据类型>;
词条给出了全部六种合法组合:
precision lowp float;
precision mediump float;
precision highp float;
precision lowp int;
precision mediump int;
precision highp int;
三个精度级别 lowp、mediump、highp 可分别作用于 float(单精度浮点)与 int(整型)两类标量类型。声明之后,该着色器内所有未单独指定精度的对应类型变量,都会继承这一全局精度设置。
三个精度级别的量化范围
词条为每种组合给出了 GLSL 规范层面的最小保证范围,整理如下:
| 精度级别 | 位宽(bits) | float 范围 |
int 范围 |
|---|---|---|---|
lowp |
8+ | 从 -2 到 2 | 从 -2^8 到 2^8(即 -256 ~ 256) |
mediump |
16+ | 从 -2^14 到 +2^14 | 从 -2^10 到 2^10(即 -1024 ~ 1024) |
highp |
32+ | 从 -2^62 到 +2^62 | 从 -2^16 到 2^16(即 -65536 ~ 65536) |
需要特别指出的是,表中"位宽 8+/16+/32+"与范围是相互独立的两组下限指标:例如 mediump float 意味着至少 16 位存储,同时至少能表达 -2^14 到 +2^14 的动态范围;而 lowp float 虽然位宽要求只有 8 位以上,但其范围要求仅为 -2 到 2,这导致 lowp 浮点在小数值上的相对精度(可分辨的最小步长)非常粗糙——在 -2 到 2 这样窄的区间里做高动态范围运算时,极易出现可见的带状断层(banding)。
- 词条原文:glossary/precision/README-ua.md
- 各精度词条细节可对照:lowp 词条、mediump 词条、highp 词条,以及完整的 glossary 索引。
为什么仓库里总写 #ifdef GL_ES 包裹精度声明
翻阅仓库中任意一个 .frag 示例,精度声明几乎总是被 #ifdef 宏包裹,例如首个示例 02/hello_world.frag:
#ifdef GL_ES
precision mediump float;
#endif
uniform float u_time;
void main() {
gl_FragColor = vec4(1.0,0.0,1.0,1.0);
}
同样的模式出现在 03/space.frag、05/easing.frag、11/2d-noise.frag、13/2d-fbm.frag 等数十个示例中,也贯穿各框架移植版本,如 04/openFrameworks/bin/data/shader.frag 与 04/processing/data/shader.frag。
这一写法的原因在于:
GL_ES宏标记"GLSL ES"环境。GL_ES由编译器在目标为 OpenGL ES(移动端 GPU、WebGL/浏览器)时预定义。第 02 章的教程原文(02/README-ch.md)明确说明:"如果定义了GL_ES这个变量,才会插入运行第 2 行的代码,这个通常用在移动端或浏览器的编译中"。- GLSL ES 强制要求显式声明默认浮点精度。在 ES 环境下,如果片元着色器没有声明
precision,部分实现会直接编译失败或产生未定义行为;而桌面 OpenGL 的 GLSL 为浮点提供了内置的highp默认精度,无需(也不允许重复)声明。 - 宏是预编译阶段的行为,在真正编译前一刻发生:
#ifdef检查GL_ES是否已定义,已定义则插入precision mediump float;一行,否则整段被跳过。这与第 02 章教程第 5 点对预处理宏的讲解一致。
因此这套 #ifdef GL_ES / #endif 包裹结构,使同一份着色器源码既能跑在桌面 OpenGL,也能跑在移动端与浏览器(WebGL)环境,是仓库全部示例采用的"跨平台精度策略"。
精度与性能的权衡:速度、质量与选择权
第 02 章教程(02/README-ch.md)对精度的重要性给出了一句非常精辟的总结:
float类型在 shaders 中非常重要,所以精度非常重要。更低的精度会有更快的渲染速度,但是会以质量为代价。
由此可以得到本主题最核心的工程权衡:
lowp(低精度):GPU 可用更少的电路/寄存器位完成存储与运算,吞吐更高、功耗更低,适合对数值范围要求不高的颜色输出、简单图案等场景;但浮点相对精度差,容易产生色带与量化噪声。mediump(中精度):仓库示例的默认选择,在绝大多数归一化坐标(0~1)、简单数学运算场景下足够,是"画质与性能"的折中点。highp(高精度):位宽可达 32 位以上、动态范围达 ±2^62,适合噪声分形(fbm)、Voronoi 距离计算、复杂光照等对数值敏感的算法;代价是寄存器占用与计算开销更高,在移动端部分 GPU 上还可能是可选项而非必选项(GLSL ES 不保证所有设备都支持片元级highp)。
同时,教程还提示了一个容易被忽略的细节(02/README-ch.md):GLSL 规范并不保证变量会被自动转换类型,vec4 需要 float 分量,因此必须养成在浮点数值中写小数点(如 1.0 而非 1)的习惯——这与精度声明共同构成了着色器数值正确性的两道防线。
全局声明之外的精细化控制
precision 语句是"全局默认值",但 GLSL 允许在变量声明处单独覆盖精度级别,实现同一着色器内"按变量分级":
precision mediump float; // 全局默认:中精度浮点
lowp vec4 color; // 该变量单独使用低精度
highp float preciseDist; // 距离计算使用高精度,避免累积误差
这种"全局兜底 + 局部覆盖"的模式,正是精度限定符设计意图的完整体现:先用 precision mediump float; 保证大多数变量的基本质量与性能,再对极少数关键变量单独提升到 highp,或者对纯颜色输出类变量降级到 lowp 换取速度。从源码结构看,仓库示例均只使用全局声明而未使用局部覆盖,这是因为示例以教学演示为主、数值范围普遍温和,mediump 已足够覆盖;但读者在自研复杂着色器时,完全可以借助局部限定符做精细化调优。
实践建议与常见陷阱
综合词条、第 02 章教程与仓库示例,可以总结出几条可直接落地的规则:
- 默认跟随仓库惯例:新写着色器时,照抄
#ifdef GL_ES precision mediump float; #endif结构,保证桌面与移动端/浏览器都可编译运行。 - 涉及大范围或高精度计算时升级
highp:噪声、fbm(如 13/2d-fbm.frag)、分形几何等对数值累加与距离敏感的场景,mediump的相对精度可能不足,应评估升级到highp。 - 移动端慎用
highp:GLSL ES 规范不保证片元着色器支持highp浮点,跨设备发布前需要针对机型验证,必要时回退mediump并接受轻微画质损失。 int范围远小于直觉:注意lowp int只有 -2^8~2^8、mediump int只有 -2^10~2^10,大整数索引或循环计数建议使用highp int或改用浮点。- 精度声明只规定"下限":不同厂商 GPU 的
mediump实际位宽可能不同(有的接近全 32 位),因此同一段代码在不同设备上的表现会有细微差异,调试白屏或色带问题时优先检查精度设置。
延伸阅读
- precision 词条(乌克兰语):本文主题词条原文
- lowp 词条、mediump 词条、highp 词条:三个精度级别的独立条目
- glossary 索引:术语表总入口,可按关键词检索全部 GLSL 词条
- 02/README-ch.md:Hello World 章节,含精度与预编译宏的入门讲解
- 02/hello_world.frag 与 03/space.frag:
#ifdef GL_ES+precision mediump float;标准写法的最小范例 - 04/openFrameworks/bin/data/shader.frag:同一精度写法在 openFrameworks 等外部框架移植版中的体现