Web 图形与 3D / 知识点

WebGL 开发速查手册

手册条目

通过一次绘制调用渲染大量结构相同但属性不同的对象。

执行实例化绘制

当大量对象共用同一套顶点或索引数据,只是位置、颜色、缩放等属性不同,用实例化绘制可把多次 draw* 调用合并为一次,减少 CPU 到 GPU 的调用开销。

实例化绘制的数据复用关系

基本语法

WebGL 2 直接提供 drawArraysInstanced、drawElementsInstanced 和 vertexAttribDivisor。除数为 0 时属性按顶点推进,为 1 时每绘制一个实例推进一次。

js
gl.vertexAttribDivisor(instanceAttributeLocation, 1);
gl.drawArraysInstanced(mode, first, vertexCount, instanceCount);

// 使用索引缓冲时
gl.drawElementsInstanced(mode, indexCount, indexType, indexOffset, instanceCount);

以上是片段示例,依赖已完成的着色器、缓冲区和顶点属性配置。

可运行示例

下面用一份三角形顶点数据和三组实例属性,一次调用绘制三个不同位置、不同颜色的三角形。

html
<!doctype html>
<meta charset="utf-8">
<canvas id="gl" width="640" height="300"></canvas>
<script>
const gl = document.querySelector("#gl").getContext("webgl2");
if (!gl) throw new Error("需要支持 WebGL 2");

function shader(type, source) {
  const s = gl.createShader(type);
  gl.shaderSource(s, source);
  gl.compileShader(s);
  if (!gl.getShaderParameter(s, gl.COMPILE_STATUS)) {
    throw new Error(gl.getShaderInfoLog(s));
  }
  return s;
}

const vs = shader(gl.VERTEX_SHADER, `#version 300 es
in vec2 aPosition;
in vec2 aOffset;
in vec3 aColor;
out vec3 vColor;
void main() {
  gl_Position = vec4(aPosition * 0.35 + aOffset, 0.0, 1.0);
  vColor = aColor;
}`);
const fs = shader(gl.FRAGMENT_SHADER, `#version 300 es
precision mediump float;
in vec3 vColor;
out vec4 outColor;
void main() {
  outColor = vec4(vColor, 1.0);
}`);

const program = gl.createProgram();
gl.attachShader(program, vs);
gl.attachShader(program, fs);
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
  throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);

const vao = gl.createVertexArray();
gl.bindVertexArray(vao);

function attribute(name, data, size, divisor) {
  const buffer = gl.createBuffer();
  gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
  gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(data), gl.STATIC_DRAW);
  const location = gl.getAttribLocation(program, name);
  gl.enableVertexAttribArray(location);
  gl.vertexAttribPointer(location, size, gl.FLOAT, false, 0, 0);
  // divisor=1 表示每个实例读取一组数据,而不是每个顶点读取
  gl.vertexAttribDivisor(location, divisor);
}

attribute("aPosition", [0, 0.8, -0.7, -0.6, 0.7, -0.6], 2, 0);
attribute("aOffset", [-0.65, 0, 0, 0, 0.65, 0], 2, 1);
attribute("aColor", [1, 0.25, 0.2, 0.2, 0.8, 0.35, 0.2, 0.45, 1], 3, 1);

gl.viewport(0, 0, gl.canvas.width, gl.canvas.height);
gl.clearColor(0.08, 0.09, 0.12, 1);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.drawArraysInstanced(gl.TRIANGLES, 0, 3, 3);
console.log("instances=3");
</script>

预期结果

text
控制台输出:instances=3
画布显示 3 个共用几何形状、位置和颜色不同的三角形。

高频用法

实例位置、颜色或缩放通常各占一个实例属性并设置除数 1。实例变换矩阵需要拆成四个 vec4 属性,四个属性都要调用 vertexAttribDivisor(location, 1)。

静态实例数据用 STATIC_DRAW;每帧更新实例缓冲时可用 DYNAMIC_DRAW,并优先通过 bufferSubData 更新已有存储。网格已使用索引缓冲时,改用 drawElementsInstanced,索引数量仍表示单个实例的索引数。

风险与边界

当 instanceCount 大于实例缓冲可提供的数据组数时,着色器可能读取越界数据并产生未定义结果。安全做法是按最短实例属性数组计算实例数,并在绘制前校验容量。

实例矩阵会快速消耗顶点属性槽位,超过 MAX_VERTEX_ATTRIBS 会导致属性配置失败。可先查询限制,再把部分数据改放纹理或统一缓冲方案中。

实例化减少绘制调用,但不会自动减少片元填充、透明混合或过度绘制成本。对象遮挡严重时仍应配合视锥裁剪、距离分级或批次拆分。

排障清单

  • 所有实例重叠:检查位移或矩阵属性是否设置了除数 1。
  • 颜色按顶点变化:颜色属性的除数仍为 0。
  • 只显示部分实例:核对实例缓冲长度、instanceCount 和属性步长。
  • 画面完全空白:检查程序链接、属性位置、视口及裁剪空间坐标。

速查:共享几何属性使用除数 0,每实例属性使用除数 1,最后只调用一次实例化绘制。

目录与阅读设置

记录一个想法

WebGL 开发速查手册

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

登录哪都通