Web 图形与 3D / 系统课时

设置纹理寻址与过滤策略

设置纹理寻址与过滤策略

同一张纹理贴到模型后,UV 坐标越界可能出现平铺或边缘拉伸,放大时也可能呈现像素块或平滑过渡。通过配置 WebGPU 的 GPUSampler,你将用一张棋盘纹理直观看到 repeat、clamp-to-edge、nearest 和 linear 的差别,并能为材质选出合适的采样参数。

学习目标

  • 根据 UV 是否超出 0~1 范围选择纹理寻址模式。
  • 区分放大、缩小过滤与 mipmap 层级过滤的作用。
  • 运行四宫格示例,对照观察边缘和像素过渡效果。

用越界 UV 判断纹理寻址

UV 是纹理上的归一化坐标,U 沿横向、V 沿纵向。addressModeU 和 addressModeV 分别控制两个方向;纹理只覆盖一遍时通常使用 0~1,地面平铺则可能使用超出该范围的 UV。

输入 U repeat 对应位置 clamp-to-edge 对应位置
-0.25 0.75 左边缘
0.50 0.50 0.50
1.25 0.25 右边缘

repeat 周期性地重复图案;clamp-to-edge 将越界采样限制到边缘纹素,超出部分看起来像边缘颜色向外延伸。两种模式不会替你修复不连续的贴图边缘;无缝地面纹理应确保左右边界及上下边界在视觉上可衔接。

越界 UV 的循环寻址、边缘钳制与纹素过滤对比

选择放大和缩小过滤方式

magFilter 控制纹理被放大时的采样,minFilter 控制被缩小时的采样。两者都接受 nearest 和 linear;它们只影响纹素如何参与采样,不改变 UV 的循环或钳制规则。

过滤模式 放大后观察 常见用途
nearest 保留明显的方块边缘 像素画、离散标记图
linear 邻近纹素颜色混合 常规彩色材质、平滑渐变

mipmapFilter 另外决定如何在不同 mip 层级之间采样。下面只创建一层 8×8 纹理,因此不会展示 mipmap 差异。默认寻址方式是 clamp-to-edge,默认三项过滤都是 nearest;实际项目中建议显式写出需要的设置,避免误以为过滤会自动变成线性。

在同一画布运行四组采样

使用支持 WebGPU 的浏览器,并通过 HTTPS 或 localhost 的本地开发服务器访问页面。将下面内容保存为 sampler.html,再用本地开发服务器打开它。示例生成 8×8 的双色棋盘纹理,四个视口共享同一纹理和绘制管线,只切换 GPUSampler。UV 横纵范围都是 -0.35~1.35,因此能同时看到越界和放大。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>WebGPU 纹理采样对比</title>
<h2>纹理寻址与过滤:四宫格</h2>
<canvas id="view" width="800" height="480" style="max-width:100%"></canvas>
<p>左上:repeat + nearest;右上:clamp-to-edge + nearest</p>
<p>左下:repeat + linear;右下:clamp-to-edge + linear</p>
<p id="status"></p>
<script type="module">
async function main() {
  if (!navigator.gpu) throw new Error("当前浏览器或页面环境不支持 WebGPU");
  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) throw new Error("未找到可用的 GPU 适配器");
  const device = await adapter.requestDevice();
  const canvas = document.querySelector("#view");
  const context = canvas.getContext("webgpu");
  const format = navigator.gpu.getPreferredCanvasFormat();
  context.configure({ device, format, alphaMode: "opaque" });

  const side = 8;
  const pixels = new Uint8Array(side * side * 4);
  for (let y = 0; y < side; y++) {
    for (let x = 0; x < side; x++) {
      // 两个纹素为一格,便于比较 nearest 与 linear。
      const a = (Math.floor(x / 2) + Math.floor(y / 2)) % 2 === 0;
      pixels.set(a ? [30, 170, 160, 255] : [250, 180, 80, 255],
                 (y * side + x) * 4);
    }
  }
  const texture = device.createTexture({
    size: [side, side], format: "rgba8unorm",
    usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST
  });
  device.queue.writeTexture(
    { texture }, pixels, { bytesPerRow: side * 4 },
    { width: side, height: side }
  );

  const module = device.createShaderModule({ code: `
struct VertexOut {
  @builtin(position) position: vec4f,
  @location(0) uv: vec2f,
};
@vertex fn vs(@builtin(vertex_index) i: u32) -> VertexOut {
  let corners = array<vec2f, 6>(
    vec2f(-1.0,-1.0), vec2f(1.0,-1.0), vec2f(-1.0,1.0),
    vec2f(-1.0,1.0), vec2f(1.0,-1.0), vec2f(1.0,1.0)
  );
  let p = corners[i];
  var out: VertexOut;
  out.position = vec4f(p, 0.0, 1.0);
  out.uv = p * vec2f(0.85,-0.85) + vec2f(0.5,0.5);
  return out;
}
@group(0) @binding(0) var tex: texture_2d<f32>;
@group(0) @binding(1) var smp: sampler;
@fragment fn fs(input: VertexOut) -> @location(0) vec4f {
  return textureSample(tex, smp, input.uv);
}` });
  const pipeline = device.createRenderPipeline({
    layout: "auto",
    vertex: { module, entryPoint: "vs" },
    fragment: { module, entryPoint: "fs", targets: [{ format }] },
    primitive: { topology: "triangle-list" }
  });

  // 每个面板仅在寻址方式、纹素过滤上有所不同。
  const cases = [
    ["repeat", "nearest"], ["clamp-to-edge", "nearest"],
    ["repeat", "linear"], ["clamp-to-edge", "linear"]
  ];
  const view = texture.createView();
  const bindGroups = cases.map(([address, filter]) => {
    const sampler = device.createSampler({
      addressModeU: address, addressModeV: address,
      magFilter: filter, minFilter: filter,
      mipmapFilter: "nearest"
    });
    return device.createBindGroup({
      layout: pipeline.getBindGroupLayout(0),
      entries: [
        { binding: 0, resource: view },
        { binding: 1, resource: sampler }
      ]
    });
  });
  const encoder = device.createCommandEncoder();
  const pass = encoder.beginRenderPass({
    colorAttachments: [{
      view: context.getCurrentTexture().createView(),
      clearValue: { r: 1, g: 1, b: 1, a: 1 },
      loadOp: "clear", storeOp: "store"
    }]
  });
  pass.setPipeline(pipeline);
  for (let i = 0; i < 4; i++) {
    pass.setViewport((i % 2) * 400, Math.floor(i / 2) * 240,
                     400, 240, 0, 1);
    pass.setBindGroup(0, bindGroups[i]);
    pass.draw(6);
  }
  pass.end();
  device.queue.submit([encoder.finish()]);
  document.querySelector("#status").textContent = "四个面板已提交绘制";
}
main().catch(error => {
  document.querySelector("#status").textContent = error.message;
  console.error(error);
});
</script>
</html>

预期结果:页面出现一块 800×480 的四宫格棋盘图,状态文本显示“四个面板已提交绘制”。左列越界区域仍周期性出现棋盘;右列越界部分保持边缘颜色。上排纹素边界清晰,下排边界出现颜色混合。画面尺寸固定,浏览器窗口较窄时可能按 CSS 缩放显示,但四组相对效果仍可比较。

检查差异并排除误判

  1. 对照左右两列:把着色器中的 0.85 改为 0.5,UV 恰好落在 0~1;重新加载后寻址模式差异应主要退化到边界采样细节,而不再出现大块越界区域。
  2. 验证缩小:将 0.85 改为 40.0 后重新加载,左列会在每个视口内重复更多棋盘格,细节密集到可能出现混叠;这时 minFilter 才是相关的纹素过滤设置。
  3. 恢复 0.85,把 side 从 8 改成 32;每个纹素变小,放大时的方块感会减弱,linear 的过渡仍更平滑。
  4. 如页面报“不支持 WebGPU”,先确认浏览器支持 WebGPU,且页面运行在 HTTPS 或 localhost 安全上下文中,再查看开发者工具控制台。

平铺地面优先尝试 repeat,UI 图标和不该平铺的贴图常用 clamp-to-edge;像素风选 nearest,常规彩色纹理多用 linear。先确认 UV 是否越界,再判断纹素过滤,能避免将两类问题混为一谈。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置纹理寻址与过滤策略

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

登录哪都通