Web 图形与 3D / 系统课时

设置 GLSL ES 3.00 输出接口

设置 GLSL ES 3.00 输出接口

用 WebGL2 绘制图形时,着色器即使写了 main,也可能因为版本声明、精度或片元输出方式不匹配而编译失败。本课用一段可直接在浏览器控制台运行的示例,建立 GLSL ES 3.00 的顶点与片元接口,并确认颜色确实写入画布。

学习目标

  • 正确放置 #version 300 es、精度声明与 main 入口。
  • 区分顶点位置输出 gl_Position 和片元颜色输出 out vec4。
  • 编译、链接并绘制一个三角形,定位常见接口错误。

区分顶点和片元输出

WebGL2 通过 canvas.getContext('webgl2') 获取上下文。顶点着色器负责写入裁剪空间位置,片元着色器负责给覆盖到的片元提供颜色;二者的输出不是同一个变量。

源码位置 必要或关键写法 作用
两种着色器的第一条指令 #version 300 es 选择 GLSL ES 3.00 语法
顶点着色器 layout(location = 0) in vec2 aPosition; 从属性槽 0 读取二维顶点
顶点着色器的 main gl_Position = vec4(aPosition, 0.0, 1.0); 输出四维裁剪空间坐标
片元着色器 precision highp float; 指定浮点数默认精度
片元着色器 layout(location = 0) out vec4 fragColor; 声明写往颜色输出位置 0 的 RGBA 变量

#version 前只能有空白或注释,不能先写 precision、in 或其他指令。两种着色器都必须定义 void main();片元着色器没有默认的浮点精度,因此示例明确声明 highp。fragColor 是自行命名的变量,不是内置关键字。

WebGL2 顶点位置与片元颜色输出接口的数据流

在浏览器中运行完整示例

在支持 WebGL2 的桌面浏览器中打开一个空白网页,按 F12 进入开发者工具的 Console,粘贴下面的完整 JavaScript 并执行。代码创建 360×220 像素画布,编译两种着色器、链接程序,再从属性槽 0 读取三个顶点。源码模板字符串紧贴 #version 开始,避免首行位置产生歧义。

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

  const gl = canvas.getContext('webgl2');
  if (!gl) throw new Error('当前浏览器无法创建 WebGL2 上下文');

  // 每份 GLSL ES 3.00 源码都从版本指令开始。
  const vertexSource = `#version 300 es
layout(location = 0) in vec2 aPosition;
void main() {
  gl_Position = vec4(aPosition, 0.0, 1.0);
}`;

  const fragmentSource = `#version 300 es
precision highp float;
layout(location = 0) out vec4 fragColor;
void main() {
  fragColor = vec4(0.12, 0.65, 0.77, 1.0);
}`;

  function compile(type, source) {
    const shader = gl.createShader(type);
    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(log || '着色器编译失败');
    }
    return shader;
  }

  const vs = compile(gl.VERTEX_SHADER, vertexSource);
  const fs = compile(gl.FRAGMENT_SHADER, fragmentSource);
  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.deleteShader(vs);
  gl.deleteShader(fs);

  // VAO 记录属性槽 0 如何读取缓冲区中的两个浮点数。
  const vao = gl.createVertexArray();
  gl.bindVertexArray(vao);
  const buffer = gl.createBuffer();
  gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
  gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([
    -0.8, -0.75, 0.8, -0.75, 0.0, 0.8
  ]), gl.STATIC_DRAW);
  gl.enableVertexAttribArray(0);
  gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);

  gl.useProgram(program);
  gl.viewport(0, 0, canvas.width, canvas.height);
  gl.clearColor(0.96, 0.97, 0.99, 1.0);
  gl.clear(gl.COLOR_BUFFER_BIT);
  gl.drawArrays(gl.TRIANGLES, 0, 3);
  console.log('WebGL2: GLSL ES 3.00 编译、链接与绘制成功');
})();

预期输出:

text
WebGL2: GLSL ES 3.00 编译、链接与绘制成功

页面末尾同时出现浅灰背景的青蓝色三角形。日志表示编译和链接检查通过并已提交绘制命令;是否实际显示仍要观察画布。将 fragColor 的赋值改成 vec4(1.0, 0.3, 0.1, 1.0) 后重新执行,应新增一个橙红色三角形画布,证明颜色由自定义片元输出控制。

定位接口与编译错误

出现空白画布时,优先看控制台中 getShaderInfoLog() 或 getProgramInfoLog() 返回的信息,而不是仅凭画面猜测。具体错误文字取决于浏览器和显卡驱动。

现象或错误写法 原因与修正
在 precision 后才写 #version 300 es 版本指令顺序错误;移到对应着色器源码开头
片元 main 给 gl_FragColor 赋值 GLSL ES 3.00 已移除这一内置输出;声明 out vec4 fragColor 后为它赋值
在顶点输入写 attribute,或使用 varying 属于 GLSL ES 1.00 风格;改用阶段匹配的 in、out
片元着色器未指定浮点默认精度 增加 precision highp float;
编译链接成功但没有三角形 检查 layout(location = 0) 与 vertexAttribPointer(0, ...) 是否一致,以及 viewport、VAO 绑定和 drawArrays 是否执行

这套最小程序将“源码能编译”“两个阶段能链接”和“最终颜色能显示”分开检查。后续增加纹理采样、插值变量或多个渲染目标时,仍可以保留这套检查顺序。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置 GLSL ES 3.00 输出接口

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

登录哪都通