Web 图形与 3D / 系统课时
配置 UV 平铺与纹理环绕方式
配置 UV 平铺与纹理环绕方式
本课用一张不对称的四色纹理演示 UV 平铺:把原本只显示一次的图案扩展为横向 3 次、纵向 2 次,再切换重复、镜像重复和边缘夹取。你会得到一个可直接在浏览器运行的 WebGL2 对比页面,并能判断每种环绕模式适合什么材质。
学习目标
- 理解 UV 缩放怎样决定纹理重复次数。
- 使用
TEXTURE_WRAP_S、TEXTURE_WRAP_T配置三种环绕方式。 - 运行 WebGL2 示例并验证不同模式的视觉结果。
UV 缩放决定采样范围
UV 是二维纹理坐标,通常用 (0, 0) 到 (1, 1) 覆盖一张纹理。片元着色器先计算 uv = vUV * vec2(3.0, 2.0),再把这个坐标传给 texture(),就会在 U 方向走过 3 个单位、在 V 方向走过 2 个单位。
需要区分两件事:UV 缩放负责采样坐标走多远,环绕方式负责坐标超出 0~1 时取哪里。 如果只修改平铺倍数,却保留边缘夹取,超出的部分并不会自动重复原图。
三种环绕方式的区别
WebGL2 使用 gl.texParameteri() 修改当前绑定的二维纹理。gl.TEXTURE_WRAP_S 对应 U(水平方向),gl.TEXTURE_WRAP_T 对应 V(垂直方向),两个方向允许使用不同模式。
| 模式 | UV 超出 0~1 时的行为 | 适合的场景 |
|---|---|---|
gl.REPEAT |
每隔 1 个 UV 单位重新采样纹理 | 砖墙、地面、连续条纹 |
gl.MIRRORED_REPEAT |
相邻单元交替翻转 | 对称花纹、减少方向性断层 |
gl.CLAMP_TO_EDGE |
取最靠近边界的纹素颜色并向外延伸 | 不希望图案重复的遮罩、单张贴图 |
例如,U=1.25 时,重复模式相当于采样 0.25;镜像重复相当于采样 0.75;夹取模式采样右侧边缘。镜像模式并不是把 UV 限制回 0~1,而是让相邻纹理单元反向排列。

在 WebGL2 中运行对比
新建 index.html,粘贴以下完整代码并用支持 WebGL2 的浏览器打开。代码直接生成 2×2 的不对称四色纹理,不依赖图片文件;拖动 U、V 平铺滑块,或切换下拉框即可重新绘制。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>UV 平铺和环绕方式</title>
</head>
<body>
<label>环绕方式
<select id="wrap">
<option value="REPEAT">重复</option>
<option value="MIRRORED_REPEAT">镜像重复</option>
<option value="CLAMP_TO_EDGE">边缘夹取</option>
</select>
</label>
<label>U 次数 <input id="u" type="range" min="1" max="4" value="3"></label>
<label>V 次数 <input id="v" type="range" min="1" max="4" value="2"></label>
<output id="status"></output>
<canvas id="view" width="600" height="400"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("此浏览器无法创建 WebGL2 上下文");
const vertexSource = `#version 300 es
out vec2 vUV;
void main() {
// 无顶点缓冲:由顶点编号生成覆盖屏幕的大三角形。
vec2 p = vec2(float((gl_VertexID << 1) & 2),
float(gl_VertexID & 2));
vUV = p;
gl_Position = vec4(p * 2.0 - 1.0, 0.0, 1.0);
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec2 vUV;
uniform sampler2D uTexture;
uniform vec2 uTiles;
out vec4 outColor;
void main() {
// 平铺先缩放 UV;越界后由纹理环绕参数决定采样位置。
outColor = texture(uTexture, vUV * uTiles);
}`;
function compile(type, source) {
const shader = gl.createShader(type);
gl.shaderSource(shader, source);
gl.compileShader(shader);
if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
throw new Error(gl.getShaderInfoLog(shader));
}
return shader;
}
const program = gl.createProgram();
gl.attachShader(program, compile(gl.VERTEX_SHADER, vertexSource));
gl.attachShader(program, compile(gl.FRAGMENT_SHADER, fragmentSource));
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(gl.getProgramInfoLog(program));
}
gl.useProgram(program);
gl.bindVertexArray(gl.createVertexArray());
const texture = gl.createTexture();
gl.activeTexture(gl.TEXTURE0);
gl.bindTexture(gl.TEXTURE_2D, texture);
// 四种象限颜色不对称,便于观察镜像时的方向变化。
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, 2, 2, 0,
gl.RGBA, gl.UNSIGNED_BYTE, new Uint8Array([
26, 160, 170, 255, 247, 169, 87, 255,
66, 99, 141, 255, 245, 221, 119, 255
]));
// 只上传基础层,因此禁用依赖 mipmap 的默认缩小过滤。
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
gl.uniform1i(gl.getUniformLocation(program, "uTexture"), 0);
const tilesLocation = gl.getUniformLocation(program, "uTiles");
const wrapInput = document.querySelector("#wrap");
const uInput = document.querySelector("#u");
const vInput = document.querySelector("#v");
function draw() {
const mode = gl[wrapInput.value];
// 修改的是当前绑定纹理的 S、T 环绕参数。
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, mode);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, mode);
const u = Number(uInput.value);
const v = Number(vInput.value);
gl.uniform2f(tilesLocation, u, v);
gl.viewport(0, 0, canvas.width, canvas.height);
gl.drawArrays(gl.TRIANGLES, 0, 3);
document.querySelector("#status").textContent =
` UV:${u} × ${v};模式:${wrapInput.value}`;
}
[wrapInput, uInput, vInput].forEach(el =>
el.addEventListener("input", draw));
draw();
</script>
</body>
</html>预期结果:页面出现一张 600×400 的彩色图案。默认 REPEAT、U=3、V=2 时,能看到横向 3 列、纵向 2 行共 6 个方向一致的四色单元;切换 MIRRORED_REPEAT 后,相邻单元翻转;切换 CLAMP_TO_EDGE 后,只有起始区域呈现完整四色纹理,其余部分被边缘颜色延展。页面上的状态文字会同步显示平铺次数与模式。
验证边界与处理异常
- 保持 U=3、V=2,依次切换三种模式;对比第二列图案朝向和最右侧是否发生边缘延展。
- 将 U=1、V=1:采样坐标不超界,三种模式的可见结果应基本相同。
- 在真实材质中如需 U 重复、V 夹取,分别把
TEXTURE_WRAP_S设置成gl.REPEAT,把TEXTURE_WRAP_T设置成gl.CLAMP_TO_EDGE。
另一个常见误解是认为非 2 的幂尺寸无法平铺。WebGL2 已允许 300×180 等尺寸使用重复环绕与 mipmap;WebGL1 则对非 2 的幂纹理有额外限制,不能照搬本例设置。实际项目里,墙面、地面纹理多用重复,方向交替的纹样可用镜像,不应扩展到纹理外的图案则用夹取。