Web 图形与 3D / 系统课时
处理纹理坐标翻转和色彩空间
处理纹理坐标翻转和色彩空间
贴图在 WebGL 2 中出现上下倒置或受光后颜色偏亮,通常是像素方向与颜色编码被混用。本课用一张上灰下白的测试图,分别验证上传翻转、sRGB 采样和线性光照,最后形成可复用的纹理导入规则。
学习目标
- 判断图片行方向与模型 UV 的 V 方向是否一致,并只在一个位置执行翻转。
- 使用
UNPACK_FLIP_Y_WEBGL、SRGB8_ALPHA8和RGBA8配置颜色纹理。 - 依据 8 位灰度算例检验颜色空间转换,避免贴图过亮或重复编码。
判断图片像素与 UV 的方向
浏览器图片及 Canvas 的像素起点在左上角,而常见三维模型 UV 约定 (u=0,v=0) 对应纹理左下角,v=1 对应上边缘。WebGL 从 DOM 图像上传纹理时,UNPACK_FLIP_Y_WEBGL 默认是 false;若模型采用上述 UV 约定,测试图往往上下颠倒。

可以选择上传前 gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true),也可以统一调整模型 UV 为 v'=1-v,但不要两处都翻。该像素存储状态会影响后续上传,应在每张贴图上传前明确设置。若源是 ImageBitmap,应通过 createImageBitmap(source, { imageOrientation: 'flipY' }) 控制方向,不能依赖这一上传开关。
运行四格对比实验
在浏览器新建 about:blank 页面,打开开发者工具的 Console,粘贴以下完整 JavaScript。示例不依赖外部图片:上排采用能自动解码的 SRGB8_ALPHA8,下排采用不解码的 RGBA8;左列不翻转,右列翻转。四格均以线性光强 0.5 渲染,并将结果编码为 sRGB 后写入默认 Canvas 绘图缓冲。
const canvas = document.createElement('canvas');
canvas.width = 640;
canvas.height = 480;
document.body.append(canvas);
const gl = canvas.getContext('webgl2', { alpha: false });
if (!gl) throw new Error('当前浏览器不支持 WebGL 2');
const source = document.createElement('canvas');
source.width = source.height = 64;
const ctx = source.getContext('2d');
ctx.fillStyle = '#808080';
ctx.fillRect(0, 0, 64, 32);
ctx.fillStyle = '#ffffff';
ctx.fillRect(0, 32, 64, 32);
function compile(type, code) {
const s = gl.createShader(type);
gl.shaderSource(s, code);
gl.compileShader(s);
if (!gl.getShaderParameter(s, gl.COMPILE_STATUS)) {
throw new Error(gl.getShaderInfoLog(s));
}
return s;
}
const vs = `#version 300 es
out vec2 uv;
const vec2 p[6] = vec2[6](
vec2(-1.,-1.), vec2(1.,-1.), vec2(-1.,1.),
vec2(-1.,1.), vec2(1.,-1.), vec2(1.,1.)
);
void main() {
vec2 v = p[gl_VertexID];
uv = v * 0.5 + 0.5;
gl_Position = vec4(v, 0., 1.);
}`;
const fs = `#version 300 es
precision highp float;
in vec2 uv;
uniform sampler2D imageTex;
out vec4 color;
vec3 toSRGB(vec3 c) {
c = clamp(c, 0.0, 1.0);
return mix(12.92 * c, 1.055 * pow(c, vec3(1.0/2.4)) - 0.055,
step(vec3(0.0031308), c));
}
void main() {
// 纹理采样结果作为线性光强参与乘法。
vec3 lit = texture(imageTex, uv).rgb * 0.5;
color = vec4(toSRGB(lit), 1.0);
}`;
const program = gl.createProgram();
gl.attachShader(program, compile(gl.VERTEX_SHADER, vs));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fs));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
gl.uniform1i(gl.getUniformLocation(program, 'imageTex'), 0);
gl.bindVertexArray(gl.createVertexArray());
gl.activeTexture(gl.TEXTURE0);
gl.pixelStorei(gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, gl.BROWSER_DEFAULT_WEBGL);
function drawTile(x, y, flipY, internalFormat) {
const tex = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, tex);
// 翻转是上传状态;内部格式决定采样时是否解码 sRGB。
gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, flipY);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
gl.texImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, source);
gl.viewport(x, y, 320, 240);
gl.drawArrays(gl.TRIANGLES, 0, 6);
}
drawTile(0, 240, false, gl.SRGB8_ALPHA8);
drawTile(320, 240, true, gl.SRGB8_ALPHA8);
drawTile(0, 0, false, gl.RGBA8);
drawTile(320, 0, true, gl.RGBA8);
gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
console.log('WebGL error:', gl.getError());预期结果:Canvas 有 上、下两排及左、右两列。左列白色区域在上(倒置),右列灰色区域在上(正确);右上灰色较暗,右下灰色偏亮。正常情况下控制台输出:
WebGL error: 0理解 sRGB 解码与光照计算
颜色贴图通常记录 sRGB 编码值,不能直接拿这些数值当作线性光强。以灰度字节 128 为例:归一化得到约 0.502,经 sRGB 解码为约 0.216,乘上 0.5 光照后得到 0.108,再编码回 sRGB 约为 92/255。若误用 RGBA8 把 0.502 当线性值,乘光照再编码将得到约 137/255,画面偏亮。
| 贴图用途 | WebGL 2 内部格式 | 采样行为 |
|---|---|---|
| Base Color / Albedo(sRGB) | SRGB8_ALPHA8 |
RGB 自动转线性;Alpha 保持线性 |
| 法线、粗糙度、金属度、遮罩等数据 | RGBA8 或合适的单/双通道格式 |
保留数值,不做 sRGB 解码 |
| 已经是线性编码的颜色数据 | RGBA8 或适合精度的浮点格式 |
按线性值使用,避免重复解码 |
本示例向默认的 RGBA8 Canvas 缓冲写入前手动进行线性到 sRGB 编码;若改为有自动 sRGB 编码的渲染附件,必须移除重复编码。UNPACK_COLORSPACE_CONVERSION_WEBGL 控制导入阶段的浏览器颜色配置文件转换,不等于 SRGB8_ALPHA8 的采样解码。导入法线等非颜色数据时,可针对 DOM 来源考虑设置为 gl.NONE;颜色图片则应确认其源色彩空间及导入目标。
按现象排查导入问题
- 整幅上下倒置:先检查顶点 UV 的
v=0指向,再查看上传时的UNPACK_FLIP_Y_WEBGL;两种修正只留一种。 - 只有部分网格倒置:优先核对模型导出时的 UV 约定,而不是全局修改纹理上传状态。
- 漫反射颜色过亮:查看颜色纹理是否误用
RGBA8,以及是否做了两次线性到 sRGB 编码;用灰度128和光强0.5比对约92的目标编码值。 - 法线图或遮罩结果异常:检查是否误用了
SRGB8_ALPHA8或图片导入时发生了颜色空间转换,并核对采样通道。
在实际项目中,纹理加载器至少应显式接收“UV 方向约定”和“颜色贴图 / 数据贴图”两个参数,而不是仅凭文件扩展名猜测。这样同一个材质在更换贴图来源时,也能用灰白方向图和中灰光照算例迅速复验。