Web 图形与 3D / 系统课时

处理 sRGB 格式与颜色空间

处理 sRGB 格式与颜色空间

同一张颜色贴图在 WebGPU 中可能比原图偏亮或偏暗,常见原因是把 sRGB 编码值直接用于光照,或在显示时重复编码。本篇用一块 128 灰度纹理完成采样、线性空间亮度计算和画布输出,并用具体数字核对结果。

学习目标

  • 判断基础色、法线与粗糙度等贴图该使用哪种纹理格式。
  • 解释 sRGB 采样解码、线性空间计算和输出编码的先后关系。
  • 配置可运行的 WebGPU 示例并根据灰度结果定位错误。

区分颜色与数值纹理

PNG、JPEG 等普通颜色图通常以 sRGB 编码存储 RGB;法线、粗糙度和金属度贴图存的是供着色器使用的数据,不能因为文件是 PNG 就统一采用 sRGB 格式。创建纹理时可先按用途分类:

贴图或缓冲内容 推荐格式示例 着色器读取方式
sRGB 基础色、漫反射颜色 rgba8unorm-srgb RGB 采样后自动解码为线性值
法线、粗糙度、金属度、AO rgba8unorm、r8unorm 直接得到归一化数据值
线性 HDR 中间颜色 rgba16float 直接存取线性浮点值

-srgb 只对 RGB 应用转换,Alpha 不做 sRGB 解码或编码。对于基础色中打包的透明度,这一点尤其重要:不能用颜色通道的转换规则处理透明度。法线贴图若错误使用 rgba8unorm-srgb,中性分量 128 会从约 0.502 变成 0.216,导致重建出的法线方向失真。

追踪颜色转换的数据流

以 sRGB 灰度字节 128 为例:128 / 255 ≈ 0.502 是编码值,使用 rgba8unorm-srgb 采样后,线性 RGB 约为 0.216。把亮度在线性空间乘以 0.5,得到 0.108;写入 sRGB 渲染附件时编码回约 92 / 255。直接将原始字节 128 除以 2 得到 64,不等于正确的半光照结果。

sRGB 纹理采样、线性光照与画布编码的数据流

这条链路适合颜色贴图参与光照的标准动态范围渲染。要注意 GPUCanvasContext.configure() 的 colorSpace: "srgb" 指定画布颜色的显示解释,并不意味着普通 bgra8unorm 渲染附件会替着色器自动执行线性到 sRGB 的编码;需要使用兼容的 -srgb 视图或显式编码,两者不能重复。

配置纹理与 sRGB 画布视图

下面示例不依赖外部图片,直接写入一个 1×1 的 sRGB 灰像素。保存为 srgb-demo.html,在该目录运行 python -m http.server 8000,再打开 http://localhost:8000/srgb-demo.html。请使用支持 WebGPU 的浏览器,并通过 localhost 或 HTTPS 加载页面。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGPU sRGB 校验</title>
<canvas id="canvas" width="320" height="180"></canvas>
<script type="module">
if (!navigator.gpu) throw Error("当前浏览器不支持 WebGPU");
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) throw Error("未找到 WebGPU 适配器");
const device = await adapter.requestDevice();
const context = document.querySelector("#canvas").getContext("webgpu");
const canvasFormat = navigator.gpu.getPreferredCanvasFormat();
const viewFormat = `${canvasFormat}-srgb`;

// Canvas 配置基础格式,通过兼容视图实现线性到 sRGB 的输出编码。
context.configure({
  device, format: canvasFormat, viewFormats: [viewFormat],
  colorSpace: "srgb", alphaMode: "opaque"
});
const texture = device.createTexture({
  size: [1, 1], format: "rgba8unorm-srgb",
  usage: GPUTextureUsage.COPY_DST | GPUTextureUsage.TEXTURE_BINDING
});
// 原始字节是 sRGB 编码的中灰,而不是线性亮度 0.5。
device.queue.writeTexture(
  { texture }, new Uint8Array([128, 128, 128, 255]),
  { bytesPerRow: 4 }, { width: 1, height: 1 }
);
const shader = device.createShaderModule({ code: `
@group(0) @binding(0) var tex: texture_2d<f32>;
@group(0) @binding(1) var samp: sampler;
@vertex fn vs(@builtin(vertex_index) i: u32) -> @builtin(position) vec4f {
  let p = array<vec2f, 3>(
    vec2f(-1.0, -1.0), vec2f(3.0, -1.0), vec2f(-1.0, 3.0)
  );
  return vec4f(p[i], 0.0, 1.0);
}
@fragment fn fs() -> @location(0) vec4f {
  let rgba = textureSample(tex, samp, vec2f(0.5, 0.5));
  // 采样已自动解码 RGB;光照系数必须作用在线性空间。
  return vec4f(rgba.rgb * 0.5, rgba.a);
}
` });
const pipeline = device.createRenderPipeline({
  layout: "auto",
  vertex: { module: shader, entryPoint: "vs" },
  fragment: { module: shader, entryPoint: "fs", targets: [{ format: viewFormat }] },
  primitive: { topology: "triangle-list" }
});
const bindGroup = device.createBindGroup({
  layout: pipeline.getBindGroupLayout(0),
  entries: [
    { binding: 0, resource: texture.createView() },
    { binding: 1, resource: device.createSampler({ magFilter: "nearest", minFilter: "nearest" }) }
  ]
});
const encoder = device.createCommandEncoder();
const pass = encoder.beginRenderPass({
  colorAttachments: [{
    view: context.getCurrentTexture().createView({ format: viewFormat }),
    clearValue: { r: 0, g: 0, b: 0, a: 1 },
    loadOp: "clear", storeOp: "store"
  }]
});
pass.setPipeline(pipeline);
pass.setBindGroup(0, bindGroup);
pass.draw(3);
pass.end();
device.queue.submit([encoder.finish()]);

// CPU 只计算理论参考值;页面颜色由 GPU 着色器实际绘制。
const toLinear = x => x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
const toSrgb = x => x <= 0.0031308 ? x * 12.92 : 1.055 * x ** (1 / 2.4) - 0.055;
console.log("理论输出灰度:", Math.round(toSrgb(toLinear(128 / 255) * 0.5) * 255));
</script>
</html>

预期输出(浏览器开发者工具 Console):

text
理论输出灰度: 92

页面上应出现均匀的深灰色画布,其理论 sRGB 灰度约为 (92, 92, 92),即 #5c5c5c;实际截图取色可能受显示色彩管理和取整影响。上面打印的是 CPU 公式算出的参考值,不是 GPU 像素回读。

排查偏亮与偏暗

若画面比预期亮,先检查基础色纹理是不是误用了 rgba8unorm:这会把 128 当成线性 0.502,乘 0.5 后再编码,理论上显示约 137,明显高于正确的 92。若画面偏暗,检查是否对已经通过 -srgb 采样解码的值又调用一次手写 srgbToLinear,或者把线性结果直接写入普通 unorm 画布视图。

排查时可按顺序核对 createTexture.format、着色器是否执行了手工转换、createRenderPipeline().fragment.targets[0].format 和 getCurrentTexture().createView({ format }) 是否一致。演示中的后两者都必须是 viewFormat。不要把 bgra8unorm-srgb 直接传给 context.configure({ format });Canvas 配置保留首选基础格式,仅在 viewFormats 声明兼容格式。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理 sRGB 格式与颜色空间

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

登录哪都通