Web 图形与 3D / 知识点

WebGL 开发速查手册

手册条目

通过平移、旋转和缩放矩阵控制模型在世界空间中的位置和姿态。

执行模型变换

模型矩阵把顶点从模型空间变换到世界空间。常见组合是先缩放、再旋转、最后平移,并通过 uniform mat4 传给顶点着色器。

模型矩阵的缩放旋转平移顺序

基本语法

顶点着色器通常按 gl_Position = projection * view * model * position 计算。WebGL 的矩阵数据按列主序传入,uniformMatrix4fv 的第二个参数必须为 false。

glsl
attribute vec3 aPosition;
uniform mat4 uModel;
uniform mat4 uView;
uniform mat4 uProjection;

void main() {
    gl_Position = uProjection * uView * uModel * vec4(aPosition, 1.0);
}

片段示例:以上代码依赖已链接的 WebGL 程序,以及已绑定的顶点属性和三个矩阵 uniform。生效后,顶点会按模型、观察、投影的顺序进入裁剪空间。

可运行示例

下面代码可直接粘贴到浏览器开发者工具控制台。它构造 T × R × S 模型矩阵,并计算模型原点和点 (1, 0, 0) 的世界坐标。

js
function multiply(a, b) {
  const out = new Float32Array(16);
  for (let col = 0; col < 4; col++) {
    for (let row = 0; row < 4; row++) {
      let sum = 0;
      for (let k = 0; k < 4; k++) {
        sum += a[k * 4 + row] * b[col * 4 + k];
      }
      out[col * 4 + row] = sum;
    }
  }
  return out;
}

function translation(x, y, z) {
  return new Float32Array([
    1, 0, 0, 0,
    0, 1, 0, 0,
    0, 0, 1, 0,
    x, y, z, 1
  ]);
}

function rotationZ(rad) {
  const c = Math.cos(rad);
  const s = Math.sin(rad);
  return new Float32Array([
    c, s, 0, 0,
    -s, c, 0, 0,
    0, 0, 1, 0,
    0, 0, 0, 1
  ]);
}

function scaling(x, y, z) {
  return new Float32Array([
    x, 0, 0, 0,
    0, y, 0, 0,
    0, 0, z, 0,
    0, 0, 0, 1
  ]);
}

function transformPoint(m, [x, y, z]) {
  return [
    m[0] * x + m[4] * y + m[8] * z + m[12],
    m[1] * x + m[5] * y + m[9] * z + m[13],
    m[2] * x + m[6] * y + m[10] * z + m[14]
  ].map(v => Number(v.toFixed(3)));
}

const scale = scaling(2, 1, 1);
const rotate = rotationZ(Math.PI / 2);
const move = translation(3, 4, 0);

// 列向量约定:最右侧的缩放最先执行。
const model = multiply(move, multiply(rotate, scale));

console.log("origin:", transformPoint(model, [0, 0, 0]));
console.log("point:", transformPoint(model, [1, 0, 0]));

预期输出

text
origin: [3, 4, 0]
point: [3, 6, 0]

原点只受平移影响;点 (1, 0, 0) 先沿 X 轴放大为 (2, 0, 0),再旋转到 (0, 2, 0),最后平移到 (3, 6, 0)。

接入 WebGL

片段示例:以下代码假设 gl、当前程序和 uModel 已准备完成。

js
const uModel = gl.getUniformLocation(program, "uModel");
gl.useProgram(program);
gl.uniformMatrix4fv(uModel, false, model);

验证时可读取 gl.getError();返回 0 表示本次调用未产生 WebGL 错误。画面位置不正确时,优先打印 model[12]、model[13]、model[14] 检查平移分量。

风险与边界

  • 触发条件:把组合写成 S × R × T。后果:平移向量也会被缩放或旋转,模型位置明显偏离。安全替代:先明确列向量约定,并固定使用 T × R × S。
  • 触发条件:把角度直接传给三角函数。后果:旋转结果错误。安全替代:使用 degrees * Math.PI / 180 转为弧度。
  • 触发条件:对模型做非均匀缩放后仍直接用模型矩阵变换法线。后果:光照方向失真。安全替代:使用模型矩阵左上角 3×3 的逆转置矩阵处理法线。

兼容性

WebGL 1 和 WebGL 2 都支持 uniformMatrix4fv。两者都要求 transpose 为 false;矩阵库若采用行主序或行向量约定,必须先统一布局和乘法顺序。

目录与阅读设置

记录一个想法

WebGL 开发速查手册

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

登录哪都通