本篇文章是《The Book of Shaders》开源仓库 glossary 术语表 中textureCube词条的深度展开：它从 GLSL 内建函数textureCube()的声明、参数语义与 mipmap 层级细节出发，结合仓库内的samplerCube、texture2D()等相关词条与章节源码，讲清立方体贴图的取色机制、坐标系规则以及实际落地时的注意事项，帮助你在片元着色器里正确完成环境贴图（skybox）与反射类采样。

词条定位：GLSL 纹理查询函数族的一员

在仓库的 glossary/README.md 中，纹理查询函数（TEXTURE LOOKUP FUNCTIONS）目前收录了两个成员：

• texture2D()—— 对二维纹理采样；
• textureCube()—— 对立方体贴图采样。

这也是本词条存在的价值：它与 texture2D 词条 互为“See Also”引用，构成了这套术语表中“二维采样 ↔ 立方体采样”的对照体系。当你在 15 章《Image processing》 里看到大量texture2D(u_tex0, st)的用法时，textureCube()就是它的三维方向延伸——面向的不是一张平面图片，而是包围场景的六面立方体纹理。

函数声明与参数语义

textureCube()有两种重载形式，均返回vec4类型的纹理像素（texel）颜色：

vec4 textureCube(samplerCube sampler, vec3 coord) vec4 textureCube(samplerCube sampler, vec3 coord, float bias)

三个参数各自的语义如下：

与texture2D()相比，最本质的区别在第一、第二两个参数：sampler2D+vec2变为samplerCube+vec3。仓库的 texture2D 词条 明确写着它“有一个sampler2D类型参数和一个vec2类型参数”，而本词条则要求samplerCube与三维向量——因为立方体贴图本质上是用一个方向向量去命中六个面中的某一个，而不是用平面 UV 坐标去命中一个像素。

sampler：绑定纹理的 uniform

sampler参数是采样器类型的 uniform，纹理在 CPU 侧（OpenGL/WebGL 代码里）上传到 GPU 后，通过纹理单元绑定到这个 uniform 上。仓库 第 03 章 在介绍 uniform 数据类型时，把samplerCube与sampler2D一并列为 GLSL 支持的 uniform 类型，并强调 uniform 需要在片元着色器顶部、设置好浮点精度之后立即声明。GLSL ES 精度限定符相关词条见 precision、highp、mediump 等。

coord：方向向量而非平面 UV

coord是vec3类型的三维坐标。对于立方体贴图而言，它通常被解读为“从立方体中心出发的反射/视线方向向量”：硬件会依据该向量的最大分量决定命中哪一个面（+X、-X、+Y、-Y、+Z、-Z），再在对应面上换算成二维坐标完成取色。这也是它和texture2D()的vec2坐标在概念上的分水岭。

bias：LOD 计算之后、查询之前的偏移

第三个参数bias是可选的float。它的作用时机被原词条精确描述为：在计算出带 mipmap 的纹理所对应的细节层级之后、真正执行纹理查询操作之前，把该偏移值叠加到 LOD 上。bias常用于在片元着色器中人为地选择更模糊（正偏移、更大 mipmap 层级）或更清晰（负偏移、更小 mipmap 层级）的采样结果，例如为远距离反射做模糊效果。

返回值：一个 texel，即坐标处的（颜色）值

textureCube()返回一个 texel，也就是给定坐标处纹理的（颜色）值。原词条明确了两点：

1. 函数有一个samplerCube类型的输入参数和一个vec3类型的输入参数：前者是纹理所绑定的 uniform，后者是要查询的 texel 的三维坐标；
2. 返回的vec4即该坐标处的 RGBA 颜色。

这在 15 章《Image processing》 中与texture2D()的用法一脉相承：那里把纹理值描述为“一张由浮点向量构成的表（或矩阵）”，texture2D()返回vec4颜色。textureCube()只是把这张“表”从二维平面升级为六面立方体，返回值同样可以直接赋给gl_FragColor或参与光照、混合计算。

两个必须知道的平台与精度细节

iOS 设备：纹理查询仅限片元着色器

原词条专门给出的旁注是：在 iOS 设备上，纹理查询功能只在片元着色器（fragment shader）中可用。这意味着使用textureCube()的着色器若要在 iOS 的 OpenGL ES 环境（例如 GLSL ES 1.00）下运行，就必须把采样逻辑放在片元着色器里，不能在顶点着色器中做立方体贴图查询。这也是 WebGL/移动端 GLSL ES 与桌面 GLSL 之间的一个常见差异点，写跨平台 shader 时需格外留意。

与精度相关的实践提示

结合仓库 第 03 章 对 uniform 的说明：sampler2D、samplerCube等 sampler 类型需要与数值类型保持一致，并在着色器开头、设定默认浮点精度之后声明。实际仓库示例（如 15/texture.frag）的写法是：

#ifdef GL_ES precision mediump float; #endif uniform sampler2D u_tex0; uniform vec2 u_tex0Resolution; uniform vec2 u_resolution; uniform vec2 u_mouse; uniform float u_time; void main () { vec2 st = gl_FragCoord.xy / u_resolution.xy; vec4 color = vec4(st.x, st.y, 0.0, 1.0); color = texture2D(u_tex0, st); gl_FragColor = color; }

若把texture2D换成textureCube，只需将u_tex0声明为uniform samplerCube，并把st换成vec3方向坐标即可——声明位置、精度设置、uniform 命名与赋值流程完全一致。

立方体贴图采样的核心流程与坐标系

立方体贴图（cubemap）由 6 张正方形纹理面组成，分别对应 ±X、±Y、±Z 六个方向。textureCube()的采样流程可以概括为：

1. 以coord这个三维向量为方向（通常来自视线反射向量或法线反射向量）；
2. 由硬件判断该方向与立方体哪个面相交，选出对应的纹理面；
3. 在该面上按交点位置进行二维纹理采样（可含 mipmap 层级选择）；
4. 若提供了bias，则先把它叠加到算好的 LOD 上，再执行最终的纹理查询；
5. 返回该 texel 的vec4颜色值。

这个“以方向定面”的机制，让textureCube()天然适合天空盒（skybox）、镜面反射、环境光遮蔽等需要“从任意方向观察环境”的效果。

在仓库中的使用背景与边界说明

需要如实说明的是：在《The Book of Shaders》仓库当前的源码与章节示例中，并没有直接调用textureCube()的.frag示例文件——仓库正文主推的是二维纹理管线，例如 15/texture.frag、15/texture-noise.frag 全部基于uniform sampler2D u_tex0与texture2D()；glossary 中的 samplerCube 词条 也还是一个未填充内容的占位页。因此，textureCube()词条在本仓库中承担的是“GLSL 术语参考”角色：它面向的是那些需要自行编写环境贴图/反射 shader 的进阶读者，而非仓库内已内置的可运行 demo。理解这一点，有助于你正确评估该函数在本项目中的应用场景边界。

与之形成对照的是 texture2D 词条：后者与仓库 15 章 的纹理示例、texture2D 分类索引 紧密配套，属于“仓库内有实际使用证据”的词条；而textureCube()则需要你带着上述声明、参数与平台知识，在自己的项目（如 WebGL 天空盒、Three.js 反射材质）中落地验证。

小结

textureCube()是 GLSL 纹理查询函数族中面向三维方向的成员：

• 声明：vec4 textureCube(samplerCube sampler, vec3 coord[, float bias])；
• 语义：以三维方向坐标在立方体贴图的六个面中选择并取回一个 texel 的vec4颜色；
• bias：可选，在 mipmap LOD 计算完成后、实际查询前叠加的偏移量；
• 平台限制：iOS 设备上纹理查询仅限片元着色器；
• 周边词条：可与 texture2D、samplerCube、vec3、vec4 配合查阅，完整索引 按主题与字母顺序均可检索到。