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,不等于正确的半光照结果。

这条链路适合颜色贴图参与光照的标准动态范围渲染。要注意 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 加载页面。
<!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):
理论输出灰度: 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 声明兼容格式。