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 约定,测试图往往上下颠倒。

DOM 图像原点、UV 方向与 sRGB 到线性光照的关系

可以选择上传前 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 绘图缓冲。

js
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 有 上、下两排及左、右两列。左列白色区域在上(倒置),右列灰色区域在上(正确);右上灰色较暗,右下灰色偏亮。正常情况下控制台输出:

text
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 方向约定”和“颜色贴图 / 数据贴图”两个参数,而不是仅凭文件扩展名猜测。这样同一个材质在更换贴图来源时,也能用灰白方向图和中灰光照算例迅速复验。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理纹理坐标翻转和色彩空间

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

登录哪都通