Web 图形与 3D / 系统课时
用 UV 坐标映射二维纹理
用 UV 坐标映射二维纹理
本课把一张二维方格图贴到能旋转的立方体六个面上。你将为位置顶点补充 UV 属性,用 texImage2D 上传图像,通过 GLSL ES 3.00 的 sampler2D 在片元着色器中采样,并能检查贴图倒置、接缝与纹理单元绑定问题。
学习目标
- 理解 UV 四角坐标以及立方体各面不能直接共用全部 UV 的原因。
- 完成
TEXTURE_2D纹理上传、过滤设置和sampler2D绑定。 - 运行 WebGL 2 示例,验证六面贴图与深度遮挡。
UV 与立方体表面的对应
二维纹理用 U(水平)、V(竖直)定位,常见范围为 0~1:四角依次为 (0,0)、(1,0)、(1,1)、(0,1)。UV 是顶点属性;顶点着色器把 a_uv 传给 v_uv,光栅化器在三角形内部插值,片元着色器再调用 texture(u_tex, v_uv) 取得颜色。
立方体只有 8 个不同的空间角点,但一个角点属于多个面,各面的 UV 可以不同。本例保留每面 4 个逻辑顶点,共 24 个;为简化 drawArrays,把每面两个三角形展开为 6 条记录,总共 36 条。若强行让各面共用 8 组位置和 UV,纹理就可能被拉伸或错误跨面连接。

可直接运行的六面贴图
将以下内容保存为 index.html,用支持 WebGL 2 的浏览器打开。代码在离屏 Canvas 中画出 256×256 的四色图并将其作为 texImage2D 的图像源,因此不依赖外部图片地址;加载完成的 HTMLImageElement 也可通过相同的上传重载使用。
<!doctype html>
<html lang='zh-CN'>
<head><meta charset='utf-8'><title>WebGL 2 UV 贴图</title></head>
<body>
<canvas id='view' width='640' height='360'></canvas>
<script>
const canvas = document.querySelector('#view');
const gl = canvas.getContext('webgl2');
if (!gl) throw new Error('当前浏览器不支持 WebGL 2');
const vertexSource = `#version 300 es
layout(location = 0) in vec3 a_position;
layout(location = 1) in vec2 a_uv;
uniform mat4 u_projection;
uniform float u_angle;
out vec2 v_uv;
void main() {
float c = cos(u_angle), s = sin(u_angle);
mat3 rotateY = mat3(c, 0.0, -s, 0.0, 1.0, 0.0, s, 0.0, c);
float x = 0.48;
mat3 rotateX = mat3(1.0, 0.0, 0.0,
0.0, cos(x), sin(x),
0.0, -sin(x), cos(x));
vec3 p = rotateY * rotateX * a_position + vec3(0.0, 0.0, -4.5);
gl_Position = u_projection * vec4(p, 1.0);
v_uv = a_uv; // 由光栅化器在三角形内插值
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec2 v_uv;
uniform sampler2D u_tex;
out vec4 outColor;
void main() {
outColor = texture(u_tex, v_uv);
}`;
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));
}
// 六个面的四角均按朝外的逆时针绕序排列
const faces = [
[[-1,-1, 1], [ 1,-1, 1], [ 1, 1, 1], [-1, 1, 1]],
[[ 1,-1,-1], [-1,-1,-1], [-1, 1,-1], [ 1, 1,-1]],
[[ 1,-1, 1], [ 1,-1,-1], [ 1, 1,-1], [ 1, 1, 1]],
[[-1,-1,-1], [-1,-1, 1], [-1, 1, 1], [-1, 1,-1]],
[[-1, 1, 1], [ 1, 1, 1], [ 1, 1,-1], [-1, 1,-1]],
[[-1,-1,-1], [ 1,-1,-1], [ 1,-1, 1], [-1,-1, 1]]
];
const uvs = [[0,0], [1,0], [1,1], [0,1]];
const order = [0,1,2,0,2,3];
const data = [];
for (const face of faces) {
for (const i of order) data.push(...face[i], ...uvs[i]);
}
const vao = gl.createVertexArray();
gl.bindVertexArray(vao);
const vbo = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(data), gl.STATIC_DRAW);
// 每条记录:位置 3×4 字节 + UV 2×4 字节
gl.enableVertexAttribArray(0);
gl.vertexAttribPointer(0, 3, gl.FLOAT, false, 20, 0);
gl.enableVertexAttribArray(1);
gl.vertexAttribPointer(1, 2, gl.FLOAT, false, 20, 12);
gl.bindVertexArray(null);
// 用 Canvas 绘制带方向标记的原始图像
const source = document.createElement('canvas');
source.width = source.height = 256;
const ctx = source.getContext('2d');
const colors = ['#D8E9FA', '#F6C177', '#7FA8D6', '#CED9E6'];
for (let row = 0; row < 2; row++) {
for (let col = 0; col < 2; col++) {
ctx.fillStyle = colors[row * 2 + col];
ctx.fillRect(col * 128, row * 128, 128, 128);
}
}
ctx.fillStyle = '#15324B';
ctx.font = 'bold 30px sans-serif';
ctx.fillText('TOP', 90, 40);
const texture = gl.createTexture();
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, texture);
// Canvas 像素原点在左上角,上传时翻转 Y
gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA,
gl.UNSIGNED_BYTE, source);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
gl.generateMipmap(gl.TEXTURE_2D);
gl.useProgram(program);
gl.uniform1i(gl.getUniformLocation(program, 'u_tex'), 0);
const near = 0.1, far = 100, f = 1 / Math.tan(Math.PI / 6);
const aspect = canvas.width / canvas.height;
const projection = new Float32Array([
f/aspect, 0, 0, 0,
0, f, 0, 0,
0, 0, (far + near) / (near - far), -1,
0, 0, 2 * far * near / (near - far), 0
]);
gl.uniformMatrix4fv(gl.getUniformLocation(program, 'u_projection'),
false, projection);
const angleLoc = gl.getUniformLocation(program, 'u_angle');
gl.viewport(0, 0, canvas.width, canvas.height);
gl.enable(gl.DEPTH_TEST);
gl.enable(gl.CULL_FACE);
gl.bindVertexArray(vao);
function render(timeMs) {
gl.clearColor(0.96, 0.98, 1.0, 1.0);
gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT);
gl.uniform1f(angleLoc, timeMs * 0.00045);
gl.drawArrays(gl.TRIANGLES, 0, 36);
requestAnimationFrame(render);
}
requestAnimationFrame(render);
</script>
</body>
</html>预期结果:画布显示浅色背景和缓慢绕 Y 轴旋转的立方体;各面均显示相同的四色方格,TOP 字样位于纹理的上边缘,背面的三角形不会透过正面。浏览器控制台不应有着色器编译或程序链接错误。
从纹理单元到片元颜色
gl.activeTexture(gl.TEXTURE0) 选择纹理单元 0,gl.bindTexture(gl.TEXTURE_2D, texture) 将纹理对象绑定到该单元的二维纹理目标。uniform1i(..., 0) 告诉 u_tex 采样单元编号 0,不能传入 gl.TEXTURE0 这个枚举值。光栅化后每个片元都有插值后的 v_uv,texture 根据纹理参数采样并返回 RGBA。
本例的 CLAMP_TO_EDGE 防止 UV 在边缘采样时绕到另一侧;LINEAR 用于放大过滤;LINEAR_MIPMAP_LINEAR 用于缩小时跨 mip 级别过滤,所以上传后执行 generateMipmap。换成外部图片时,需要等图片加载完成后再上传,还要满足跨域访问限制。
排查倒置、黑面和贴图拉伸
- 上下倒置:确认
gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true)在texImage2D之前;也可统一反转 V 坐标,但不要同时进行两次翻转。 - 纹理被拉伸或跨面:检查每条记录有 5 个 float、步长 20 字节、UV 起始偏移 12 字节;立方体棱边的相同位置允许使用不同 UV。
- 纹理呈黑色:检查
u_tex对应的单元是否绑定了已经上传数据的纹理,以及缩小过滤需要的 mipmap 是否完整。可暂时改为gl.LINEAR缩小过滤以排除 mipmap 配置。 - 面消失或遮挡颠倒:本例启用了
DEPTH_TEST和CULL_FACE,应检查三角形顶点绕序;贴图上传不能修复错误的几何索引。
把纹理四角替换为不同颜色,再旋转查看:如果每一面都完整显示四格、方向可辨、没有意外串色或背面穿透,就表明 UV 属性、图像上传、纹理单元绑定和片元采样已经连通。