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 的桌面浏览器中打开一个空白网页,按 F12 进入开发者工具的 Console,粘贴下面的完整 JavaScript 并执行。代码创建 360×220 像素画布,编译两种着色器、链接程序,再从属性槽 0 读取三个顶点。源码模板字符串紧贴 #version 开始,避免首行位置产生歧义。
(() => {
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 编译、链接与绘制成功');
})();预期输出:
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 是否执行 |
这套最小程序将“源码能编译”“两个阶段能链接”和“最终颜色能显示”分开检查。后续增加纹理采样、插值变量或多个渲染目标时,仍可以保留这套检查顺序。