Web 图形与 3D / 系统课时
用 vec 和 mat 组织着色器数据
用 vec 和 mat 组织着色器数据
在 GLSL 中,颜色、纹理坐标和空间位置通常由向量表示,坐标变换则由矩阵完成。类型或维度不匹配会导致着色器编译失败,矩阵乘法方向错误还可能让图形位置异常。本课通过一个可运行的 WebGL2 彩色三角形,掌握向量、矩阵、分量访问与显式类型转换。
学习目标
- 根据数据含义选择标量、
vec2、vec3、vec4与矩阵类型。 - 正确使用向量构造、分量访问、显式转换和矩阵乘法。
- 运行 WebGL2 示例,验证二维平移与颜色插值结果。
根据数据维度选择类型
GLSL ES 3.00 提供标量、向量和矩阵类型。标量表示一个值,向量组织固定数量的同类分量,矩阵则组织多行多列的数值,适合表示线性变换或齐次坐标变换。
| 数据用途 | GLSL 类型 | 示例 |
|---|---|---|
| 浮点强度 | float |
float opacity = 0.8; |
| 整数计数 | int |
int count = 3; |
| 条件标记 | bool |
bool enabled = true; |
| 二维坐标 | vec2 |
vec2 uv = vec2(0.25, 0.75); |
| RGB 颜色 | vec3 |
vec3 color = vec3(1.0, 0.2, 0.1); |
| RGBA 颜色 | vec4 |
vec4 rgba = vec4(color, 1.0); |
| 二维齐次变换 | mat3 |
mat3 transform = mat3(1.0); |
| 三维齐次变换 | mat4 |
mat4 model = mat4(1.0); |
vec2、vec3、vec4 的分量都是 float。整数向量使用 ivec2、ivec3、ivec4,无符号整数向量使用 uvec 系列,布尔向量使用 bvec 系列。
向量构造器允许组合已有数据。例如,vec4(color, 1.0) 将一个 RGB 向量和透明度分量组合为 RGBA;vec3(0.5) 会将三个分量全部设为 0.5,而不是只初始化第一个分量。
矩阵也有相应规则:mat3(1.0) 构造三阶单位矩阵,对角线为 1.0,其余元素为 0.0。它并不是所有元素都等于 1.0 的矩阵。mat4(1.0) 同理,常用于初始化没有旋转、缩放和平移的三维变换。
使用分量访问与显式转换
向量分量可以用位置名称 x/y/z/w、颜色名称 r/g/b/a 或纹理名称 s/t/p/q 访问。它们只是同一组分量的不同命名方式,并不改变底层数据。
例如,vec3 color = vec3(0.2, 0.6, 1.0); 声明一个 RGB 颜色后:
color.r和color.x都是0.2。color.gb返回vec2(0.6, 1.0)。color.bgr返回vec3(1.0, 0.6, 0.2),可用于交换通道顺序。color.rgb = vec3(1.0, 0.0, 0.0);可以同时更新三个分量。
这种多分量访问称为 swizzle。读取时可以重复使用同一个分量,例如 color.rrr;写入时目标分量不能重复,因此 color.rr = vec2(0.5) 是非法赋值。
GLSL ES 对不同标量类型的混用有严格要求。不要依赖整数自动转换为浮点数。例如,float gain = 80; 应改为 float gain = float(80);,也可以直接使用浮点字面量 80.0。
同样,vec2 + vec3 不允许直接相加。必须先明确需要保留或补充哪些分量,再把两个操作数转换为相同维度。单个 float 与浮点向量进行逐分量运算则是合法的,例如 color * 0.8 会将三个颜色分量分别乘以 0.8。
理解矩阵列顺序和乘法方向
GLSL 的矩阵构造器按列填充元素,索引形式是 matrix[column][row]。对于 mat3,第一组三个标量组成第一列,而不是第一行。
以二维平移为例,二维点 vec2(x, y) 需要先扩展为齐次坐标 vec3(x, y, 1.0),才能使用三阶矩阵完成平移。
沿 X 轴平移 0.25 的三阶矩阵可写成三列:
- 第 0 列:
vec3(1.0, 0.0, 0.0)。 - 第 1 列:
vec3(0.0, 1.0, 0.0)。 - 第 2 列:
vec3(0.25, 0.0, 1.0)。
使用 transform * vec3(x, y, 1.0) 时,结果为 vec3(x + 0.25, y, 1.0)。所以平移量位于 transform[2][0],不是 transform[0][2]。

在顶点着色器中,gl_Position 必须是 vec4。二维结果通常可写成 vec4(transformed.xy, 0.0, 1.0),分别补充 Z 坐标和齐次 W 分量。
注意乘法方向:matrix * vector 按列向量约定执行变换。vector * matrix 在维度允许时也可能合法,但数学含义不同,不能随意交换顺序。多个变换矩阵相乘时,顺序同样会影响最终位置。
运行完整的 WebGL2 示例
下面创建一个 480×320 的画布,将三个顶点的位置和颜色送入顶点着色器,再用 mat3 使整个三角形向右平移。片元着色器接收插值后的颜色,并把亮度调整到原来的 80%。
将下面完整代码保存为 index.html,使用支持 WebGL2 的现代浏览器打开。不需要安装外部库。
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='utf-8'>
<title>GLSL 向量与矩阵示例</title>
</head>
<body>
<canvas width='480' height='320'></canvas>
<script>
const canvas = document.querySelector('canvas');
const gl = canvas.getContext('webgl2');
if (!gl) throw new Error('当前浏览器不支持 WebGL2');
const vertexSource = `#version 300 es
precision highp float;
layout(location = 0) in vec2 aPosition;
layout(location = 1) in vec3 aColor;
out vec3 vColor;
void main() {
// 三列构造二维齐次平移矩阵,X 方向移动 0.25
mat3 move = mat3(
vec3(1.0, 0.0, 0.0),
vec3(0.0, 1.0, 0.0),
vec3(0.25, 0.0, 1.0)
);
vec3 transformed = move * vec3(aPosition, 1.0);
gl_Position = vec4(transformed.xy, 0.0, 1.0);
vColor = aColor.rgb;
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec3 vColor;
out vec4 outColor;
void main() {
// 将整数百分比显式转换为浮点亮度系数
int brightnessPercent = 80;
float gain = float(brightnessPercent) / 100.0;
outColor = vec4(vColor.rgb * gain, 1.0);
}`;
function compileShader(type, source) {
const shader = gl.createShader(type);
gl.shaderSource(shader, source);
gl.compileShader(shader);
if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
throw new Error(gl.getShaderInfoLog(shader));
}
return shader;
}
const program = gl.createProgram();
gl.attachShader(program, compileShader(gl.VERTEX_SHADER, vertexSource));
gl.attachShader(program, compileShader(gl.FRAGMENT_SHADER, fragmentSource));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
// 每个顶点依次存储两个位置分量和三个颜色分量
const vertices = new Float32Array([
-0.65, -0.55, 1.0, 0.2, 0.2,
0.65, -0.55, 0.2, 1.0, 0.2,
0.00, 0.65, 0.2, 0.4, 1.0
]);
const vao = gl.createVertexArray();
gl.bindVertexArray(vao);
const buffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW);
// 每个顶点跨度20字节,颜色从第8字节开始
const stride = 5 * Float32Array.BYTES_PER_ELEMENT;
gl.enableVertexAttribArray(0);
gl.vertexAttribPointer(0, 2, gl.FLOAT, false, stride, 0);
gl.enableVertexAttribArray(1);
gl.vertexAttribPointer(1, 3, gl.FLOAT, false, stride, 8);
gl.viewport(0, 0, canvas.width, canvas.height);
gl.clearColor(0.97, 0.97, 0.98, 1.0);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.drawArrays(gl.TRIANGLES, 0, 3);
</script>
</body>
</html>预期结果:浏览器显示浅灰白背景和一个彩色三角形。三角形左下角偏红、右下角偏绿、顶部偏蓝,内部颜色平滑过渡;整体相对原始顶点位置向右移动 60 个画布像素,最终颜色分量乘以 0.8。
这里可以从三个位置验证数据类型是否正确:
- 顶点缓冲区每个顶点有
5个float,前两个输入vec2 aPosition,后三个输入vec3 aColor。 - 顶点着色器使用
mat3 * vec3计算位置,再通过.xy取出二维分量,构造vec4 gl_Position。 out vec3 vColor与片元着色器中的in vec3 vColor对应,光栅化阶段对三个顶点的颜色进行插值,最后构造vec4 outColor。
原始裁剪空间 X 坐标增加 0.25,在 480 像素宽的画布上,对应移动 0.25 × 480 ÷ 2 = 60 像素。这个值可以直接通过截图中的顶点位置核对。
排查常见的类型与矩阵错误
编译失败时,首先查看浏览器开发者工具 Console。示例中的 compileShader() 会抛出实际编译日志,可以借助其中的行号定位错误。
| 错误写法 | 原因 | 正确做法 |
|---|---|---|
float x = 1; |
整数不能在普通赋值中隐式转换为浮点数 | float x = 1.0; |
vec3 c = vec2(1.0); |
目标需要三个分量,来源只有两个 | vec3 c = vec3(vec2(1.0), 0.0); |
vec2 p = vec3(1.0); |
类型维度不匹配 | vec2 p = vec3(1.0).xy; |
vec2 p = mat3(1.0) * vec2(1.0); |
三阶矩阵不能直接乘二维向量 | vec3 p = mat3(1.0) * vec3(1.0, 1.0, 1.0); |
如果编译成功但图形位置不对,优先检查 mat3 构造器中的列顺序、齐次坐标最后一个分量,以及矩阵乘法左右两侧的位置。如果三角形消失,还要检查变换后的坐标是否落在可见裁剪范围之外。
可以做一个直接验证:将示例中的第三列从 vec3(0.25, 0.0, 1.0) 改成 vec3(-0.25, 0.0, 1.0)。重新打开页面后,三角形应当相对原始位置向左移动 60 像素,而颜色保持不变。这说明位置矩阵和颜色向量分别承担不同职责,数据类型、维度以及矩阵方向均符合预期。