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

选择放大和缩小过滤方式
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,因此能同时看到越界和放大。
<!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 缩放显示,但四组相对效果仍可比较。
检查差异并排除误判
- 对照左右两列:把着色器中的
0.85改为0.5,UV 恰好落在 0~1;重新加载后寻址模式差异应主要退化到边界采样细节,而不再出现大块越界区域。 - 验证缩小:将
0.85改为40.0后重新加载,左列会在每个视口内重复更多棋盘格,细节密集到可能出现混叠;这时minFilter才是相关的纹素过滤设置。 - 恢复
0.85,把side从8改成32;每个纹素变小,放大时的方块感会减弱,linear的过渡仍更平滑。 - 如页面报“不支持 WebGPU”,先确认浏览器支持 WebGPU,且页面运行在 HTTPS 或
localhost安全上下文中,再查看开发者工具控制台。
平铺地面优先尝试 repeat,UI 图标和不该平铺的贴图常用 clamp-to-edge;像素风选 nearest,常规彩色纹理多用 linear。先确认 UV 是否越界,再判断纹素过滤,能避免将两类问题混为一谈。