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,而是让相邻纹理单元反向排列。

重复、镜像重复和边缘夹取的 UV 空间结果对比

在 WebGL2 中运行对比

新建 index.html,粘贴以下完整代码并用支持 WebGL2 的浏览器打开。代码直接生成 2×2 的不对称四色纹理,不依赖图片文件;拖动 U、V 平铺滑块,或切换下拉框即可重新绘制。

html
<!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 后,只有起始区域呈现完整四色纹理,其余部分被边缘颜色延展。页面上的状态文字会同步显示平铺次数与模式。

验证边界与处理异常

  1. 保持 U=3、V=2,依次切换三种模式;对比第二列图案朝向和最右侧是否发生边缘延展。
  2. 将 U=1、V=1:采样坐标不超界,三种模式的可见结果应基本相同。
  3. 在真实材质中如需 U 重复、V 夹取,分别把 TEXTURE_WRAP_S 设置成 gl.REPEAT,把 TEXTURE_WRAP_T 设置成 gl.CLAMP_TO_EDGE。

另一个常见误解是认为非 2 的幂尺寸无法平铺。WebGL2 已允许 300×180 等尺寸使用重复环绕与 mipmap;WebGL1 则对非 2 的幂纹理有额外限制,不能照搬本例设置。实际项目里,墙面、地面纹理多用重复,方向交替的纹样可用镜像,不应扩展到纹理外的图案则用夹取。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 UV 平铺与纹理环绕方式

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

登录哪都通