Web 图形与 3D / 系统课时
通过 in 和 out 连接着色阶段
通过 in 和 out 连接着色阶段
一个三角形只有三个顶点,但屏幕上有许多片元。这里用 WebGL2 把顶点位置、颜色和 UV 绑定到 in 输入,再通过顶点阶段的 out 与片元阶段的 in 传值,最终绘制渐变三角形并读取中心像素验证插值。
学习目标
- 把顶点缓冲中的位置、颜色、UV 绑定到指定属性位置。
- 用匹配的
out和in连接两个着色阶段,辨认片元颜色输出。 - 计算三角形内部的插值结果,并用
readPixels验证。
区分顶点输入与跨阶段变量
WebGL2 使用 GLSL ES 3.00,声明变量时要看它处在哪个阶段:
| 位置 | 声明示例 | 职责 |
|---|---|---|
| 顶点着色器 | layout(location = 0) in vec2 aPosition; |
从位置为 0 的顶点属性读取数据 |
| 顶点着色器 | out vec3 vColor; |
向光栅化阶段输出每个顶点的颜色 |
| 片元着色器 | in vec3 vColor; |
接收插值后的颜色 |
| 片元着色器 | out vec4 fragColor; |
写出当前片元的最终颜色 |
顶点 out 与片元 in 要匹配名称、类型和相关插值限定符。vColor、vUv 是跨阶段变量,不是 JavaScript 直接传给每个片元的属性;片元阶段看到的是光栅化后的值。顶点着色器还必须写出 gl_Position。
绑定属性并画出渐变
在支持 WebGL2 的浏览器中打开开发者工具的 Console,粘贴以下完整 JavaScript。代码会向页面追加一个 480×360 的画布,绘制三个顶点分别为红、绿、蓝的三角形;每个顶点同时带有二维 UV。
(() => {
const canvas = document.createElement("canvas");
canvas.width = 480;
canvas.height = 360;
document.body.appendChild(canvas);
const gl = canvas.getContext("webgl2", {
antialias: false,
preserveDrawingBuffer: true
});
if (!gl) throw new Error("当前浏览器不支持 WebGL2");
const vertexSource = `#version 300 es
layout(location = 0) in vec2 aPosition;
layout(location = 1) in vec3 aColor;
layout(location = 2) in vec2 aUv;
out vec3 vColor;
out vec2 vUv;
void main() {
gl_Position = vec4(aPosition, 0.0, 1.0);
vColor = aColor;
vUv = aUv;
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec3 vColor;
in vec2 vUv;
out vec4 fragColor;
void main() {
fragColor = vec4(0.8 * vColor + vec3(0.2 * vUv, 0.0), 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)) {
throw new Error(gl.getShaderInfoLog(shader) || "编译失败");
}
return shader;
}
const program = gl.createProgram();
gl.attachShader(program, compile(gl.VERTEX_SHADER, vertexSource));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragmentSource));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program) || "链接失败");
}
// 每个顶点交错存储:位置 2 项、颜色 3 项、UV 2 项。
const vertices = new Float32Array([
-0.8, -0.8, 1, 0, 0, 0, 0,
0.8, -0.8, 0, 1, 0, 1, 0,
0.0, 0.8, 0, 0, 1, 0.5, 1
]);
const vao = gl.createVertexArray();
gl.bindVertexArray(vao);
const vbo = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
gl.bufferData(gl.ARRAY_BUFFER, vertices, gl.STATIC_DRAW);
// stride 和 offset 都按字节计:每顶点 7 × 4 = 28 字节。
const stride = 7 * Float32Array.BYTES_PER_ELEMENT;
[[0, 2, 0], [1, 3, 2], [2, 2, 5]].forEach(([loc, size, start]) => {
gl.vertexAttribPointer(loc, size, gl.FLOAT, false, stride, start * 4);
gl.enableVertexAttribArray(loc);
});
gl.viewport(0, 0, canvas.width, canvas.height);
gl.clearColor(0.08, 0.10, 0.14, 1);
gl.clear(gl.COLOR_BUFFER_BIT);
gl.useProgram(program);
gl.drawArrays(gl.TRIANGLES, 0, 3);
// 读取画布中心的片元,而不是任何一个顶点的原始值。
const rgba = new Uint8Array(4);
gl.readPixels(240, 180, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, rgba);
const near = (actual, expected) => Math.abs(actual - expected) <= 3;
const ok = near(rgba[0], 77) && near(rgba[1], 77)
&& near(rgba[2], 102) && rgba[3] === 255;
console.log("中心插值校验:" + (ok ? "通过" : "失败"));
})();预期输出(Console):
中心插值校验:通过页面同时出现深蓝灰背景上的连续渐变三角形,而不是三个互不相连的纯色点。不同设备的单通道像素值可能差约 1~3;示例使用容差判断。layout(location = 0/1/2) 分别对应位置、颜色、UV;缓冲步长为 28 字节,三项偏移为 0、8、20 字节。
理解光栅化怎样插值
顶点着色器每处理一个顶点,就把该顶点的 aColor 和 aUv 赋给 vColor、vUv。光栅化时,三角形内部的片元根据三个顶点的贡献权重获得各自的值;这一步发生在顶点 out 与片元 in 之间。

本例三个顶点的 gl_Position.w 都是 1,画布中心对应 NDC 坐标 (0, 0),其重心权重为 A=0.25、B=0.25、C=0.50。因此中心片元收到 vColor=(0.25,0.25,0.50)、vUv=(0.5,0.5);片元公式算得 RGB 约为 (0.30,0.30,0.40),换算成 8 位通道约为 (77,77,102)。
浮点跨阶段变量默认使用 smooth,一般会执行透视校正插值;本例由于三个顶点的齐次 w 相同,插值表现为屏幕空间线性变化。若需要整块三角形保持同一个值,可在顶点输出与片元输入两侧使用 flat,而不是依赖默认插值。
检查接口与属性错位
- 如果程序链接失败,先检查
vColor、vUv在顶点out和片元in中是否同名同类型,并读取gl.getProgramInfoLog(program)。 - 如果颜色错乱或 UV 梯度方向不对,核对
vertexAttribPointer的 28 字节步长和 0、8、20 字节偏移;偏移写成浮点数项数2、5是错误的。 - 如果画面只有背景色,核对三角形顶点、
gl.bindVertexArray(vao)、gl.useProgram(program)和gl.drawArrays(gl.TRIANGLES, 0, 3)是否执行。 - 如果只想观察 UV,可把片元着色器里的颜色赋值改为
fragColor = vec4(vUv, 0.0, 1.0);,重新编译运行。预期画面红色分量向右增大、绿色分量向上增大。
跨阶段传值时不要把 in/out 理解成逐片元复制顶点值:顶点缓冲决定各顶点的属性,光栅化决定片元的插值结果,片元着色器才把这些结果组合成可见颜色。