Web 图形与 3D / 系统课时

编译 GLSL 着色器并链接程序

编译 GLSL 着色器并链接程序

把顶点与片元两段 GLSL ES 3.00 源码变成真正可使用的 WebGLProgram,需要分别编译 Shader,再将它们附加到 Program 并链接。本课完成后,你可以独立检查编译、链接和绑定结果,并为下一步传入顶点数据做好准备。

学习目标

  • 写出符合 WebGL 2 规范的最小顶点着色器和片元着色器。
  • 使用编译、链接及状态查询 API 创建可绑定的 Program。
  • 通过信息日志定位失败,并正确处理 Shader 与 Program 的生命周期。

两段 GLSL ES 3.00 源码

WebGL 2 使用 GLSL ES 3.00。两段源码都必须以 #version 300 es 开始;版本指令放在字符串第一行,不要在它前面插入空行或注释。

顶点着色器通过 layout(location = 0) in vec2 a_position; 接收二维坐标,在 main() 中将其扩展成 vec4(x, y, 0.0, 1.0) 并写入 gl_Position。这里使用裁剪空间坐标,后续向槽位 0 提供顶点数据即可。

片元着色器声明 precision mediump float; 与 out vec4 outColor;,在 main() 中输出 vec4(0.1, 0.6, 0.9, 1.0),四个分量依次为红、绿、蓝和不透明度。GLSL ES 3.00 不再使用旧版的 attribute、varying 和 gl_FragColor 写法。

编译与链接的先后关系

WebGLShader 是单个阶段的编译对象;WebGLProgram 则组合顶点和片元阶段。每段源码编译成功,不代表两段之间一定能链接,例如顶点输出与片元输入的变量类型不匹配时,链接仍可能失败。

两条 Shader 编译分支汇入 Program 链接的流程

实际调用顺序如下:

  1. 对两种类型分别调用 createShader、shaderSource、compileShader,用 getShaderParameter(shader, gl.COMPILE_STATUS) 判断各自是否编译成功;失败时读取 getShaderInfoLog。
  2. 通过 createProgram 创建容器,调用两次 attachShader,然后 linkProgram;用 getProgramParameter(program, gl.LINK_STATUS) 判断链接是否成功,失败时读取 getProgramInfoLog。
  3. 对成功的 Program 调用 useProgram;通过 getParameter(gl.CURRENT_PROGRAM) 检查当前绑定。链接成功后可分离并删除阶段性 Shader,对应的 Program 仍可用于绘制。

在浏览器中完成一次编译与链接

在支持 WebGL 2 的浏览器中打开空白页面,按 F12 进入开发者工具的 Console,粘贴并运行下面的完整 JavaScript。示例创建一张 480×270 的画布,不依赖第三方库;GLSL 写在 JavaScript 模板字符串中,因此 #version 必须紧贴字符串开头。

js
(() => {
  const canvas = document.createElement("canvas");
  canvas.width = 480;
  canvas.height = 270;
  canvas.style.border = "1px solid #94a3b8";
  document.body.appendChild(canvas);

  const gl = canvas.getContext("webgl2");
  if (!gl) throw new Error("无法创建 WebGL 2 上下文");

  const vertexSource = `#version 300 es
layout(location = 0) in vec2 a_position;
void main() {
  gl_Position = vec4(a_position, 0.0, 1.0);
}`;
  const fragmentSource = `#version 300 es
precision mediump float;
out vec4 outColor;
void main() {
  outColor = vec4(0.1, 0.6, 0.9, 1.0);
}`;

  function compileShader(type, source) {
    const shader = gl.createShader(type);
    if (!shader) throw new Error("创建 Shader 失败");
    gl.shaderSource(shader, source);
    gl.compileShader(shader);
    if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
      const log = gl.getShaderInfoLog(shader) || "无编译日志";
      gl.deleteShader(shader);
      throw new Error(`Shader 编译失败:${log}`);
    }
    return shader;
  }

  let vertexShader = null;
  let fragmentShader = null;
  let program = null;
  try {
    vertexShader = compileShader(gl.VERTEX_SHADER, vertexSource);
    fragmentShader = compileShader(gl.FRAGMENT_SHADER, fragmentSource);

    program = gl.createProgram();
    if (!program) throw new Error("创建 Program 失败");
    gl.attachShader(program, vertexShader);
    gl.attachShader(program, fragmentShader);
    gl.linkProgram(program);

    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
      throw new Error(`Program 链接失败:${gl.getProgramInfoLog(program) || "无链接日志"}`);
    }

    console.log("顶点编译:", gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS));
    console.log("片元编译:", gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS));
    console.log("程序链接:", gl.getProgramParameter(program, gl.LINK_STATUS));

    // 已链接的程序可以脱离阶段性 Shader 继续使用
    gl.detachShader(program, vertexShader);
    gl.detachShader(program, fragmentShader);
    gl.useProgram(program);
    console.log("当前 Program 正确:", gl.getParameter(gl.CURRENT_PROGRAM) === program);
    console.log("a_position 槽位:", gl.getAttribLocation(program, "a_position"));

    // 保留 Program,下一步可以继续绑定缓冲区并绘制
    window.webglDemo = { canvas, gl, program };
  } catch (error) {
    if (program) gl.deleteProgram(program);
    throw error;
  } finally {
    if (vertexShader) gl.deleteShader(vertexShader);
    if (fragmentShader) gl.deleteShader(fragmentShader);
  }
})();

预期输出(浏览器控制台):

text
顶点编译: true
片元编译: true
程序链接: true
当前 Program 正确: true
a_position 槽位: 0

程序运行后会新增一个带边框的空画布。画布尚未显示三角形是正常的:当前只创建了 Program,没有上传顶点数据,也没有调用 drawArrays。对象保存在 window.webglDemo,刷新页面则需要重新运行。

区分编译失败、链接失败与资源释放

将片元源码中的 outColor 故意改为未声明的 wrongColor 并重新运行:此时编译检查应失败,错误由 getShaderInfoLog 提供;不同浏览器或显卡驱动的报错文字、行号可能不同,不能依赖固定日志字符串。

如果两段 Shader 的 COMPILE_STATUS 都为 true,但 LINK_STATUS 为 false,先核对顶点着色器 out 与片元着色器 in 的名称、类型及数组声明是否匹配,再查看 getProgramInfoLog。不要用 gl.getError() 代替专门的编译、链接状态查询。

本例在成功链接后执行 detachShader,并在 finally 中 deleteShader,保留可继续使用的 Program;创建或链接失败时则用 deleteProgram 回收程序对象。不要在准备继续绘制时删除 Program。如果需要重建着色器程序,应先创建并验证新 Program,再切换绑定并释放旧 Program,避免把失败的重建结果投入绘制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编译 GLSL 着色器并链接程序

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

登录哪都通