Web 图形与 3D / 系统课时

从 sampler2D 获取纹理颜色

从 sampler2D 获取纹理颜色

本篇将一张本地 PNG 或 JPEG 图片上传为 WebGL2 纹理,并在片元着色器中通过 sampler2D 和 texture() 按 UV 坐标读取颜色。完成后,你可以把任意图片显示到画布上,并理解纹理单元绑定、采样坐标和图片上下翻转的作用。

学习目标

  • 理解纹理对象、纹理单元与 sampler2D 之间的关系。
  • 使用 texture() 根据归一化 UV 坐标读取纹理颜色。
  • 完成图片上传、纹理绑定和片元渲染,并排查常见采样问题。

纹理对象、纹理单元与采样器

WebGL2 不能直接让 GLSL 读取 JavaScript 中的图片对象。图片像素必须先通过 gl.texImage2D() 上传到 GPU 纹理对象,再绑定到纹理单元,最后由片元着色器中的 sampler2D 访问。

这三个对象承担不同职责:

  • 纹理对象:由 gl.createTexture() 创建,保存上传后的纹理图像和采样参数。
  • 纹理单元:由 gl.activeTexture(gl.TEXTURE0) 选择。TEXTURE0 代表编号为 0 的纹理单元。
  • 采样器 uniform:GLSL 中声明为 uniform sampler2D uTexture;,使用 gl.uniform1i(location, 0) 指向编号为 0 的纹理单元。

因此,sampler2D 不直接包含图片像素,也不接收 JavaScript 图片对象。它通过纹理单元间接访问当前绑定的二维纹理。

特别注意,gl.TEXTURE0 是传给 gl.activeTexture() 的枚举常量,而传给 gl.uniform1i() 的是纹理单元编号 0,不能混用。

本例使用 gl.RGBA 作为纹理格式、gl.UNSIGNED_BYTE 作为像素数据类型,并配置 gl.LINEAR 线性过滤和 gl.CLAMP_TO_EDGE 边缘钳制。这样既能采样普通彩色图片,也不要求图片宽高必须是 2 的整数次幂。

看懂 UV 坐标与图片方向

纹理采样使用归一化坐标 UV,其中 u 表示水平方向,v 表示垂直方向。对于一张完整铺满屏幕的纹理,常用的坐标范围是 0 到 1。

UV 坐标 对应位置
(0.0, 0.0) 纹理左下角
(1.0, 0.0) 纹理右下角
(0.0, 1.0) 纹理左上角
(1.0, 1.0) 纹理右上角
(0.5, 0.5) 纹理中心

在本例的顶点着色器中,裁剪空间位置 p 的范围覆盖屏幕的 [-1,1],通过 vUV = p * 0.5 + 0.5 转换为纹理坐标。光栅化阶段会对顶点输出的 UV 进行插值,让每个片元获得自己的采样位置。

片元着色器只需要调用 texture(uTexture, vUV),就能获得对应位置的 vec4 颜色,四个分量分别是 R、G、B、A,通常处于 0 到 1 范围。

图片像素上传到纹理单元并通过UV坐标采样的空间与数据关系

这里存在一个容易忽略的方向差异:浏览器图片数据通常以左上角为起点,而传统 OpenGL 纹理坐标以左下角为原点。对于本例的屏幕 UV,上传图片前设置 gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true),可以让原始图片保持正常的上下方向。

用一份 HTML 完成纹理采样

创建 texture.html,将下面完整代码保存进去,使用支持 WebGL2 的现代浏览器打开。页面提供图片文件选择控件,选择本地 PNG 或 JPEG 后,将图片上传为 GPU 纹理,并使用一个覆盖整个画布的全屏三角形进行采样。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>WebGL2 纹理采样</title>
</head>
<body>
  <label>选择图片:<input id="pick" type="file" accept="image/png,image/jpeg"></label>
  <canvas id="view" width="640" height="360"></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;
      const vec2 positions[3] = vec2[3](
        vec2(-1.0, -1.0),
        vec2( 3.0, -1.0),
        vec2(-1.0,  3.0)
      );
      void main() {
        // 利用全屏三角形生成每个片元的插值 UV
        vec2 p = positions[gl_VertexID];
        vUV = p * 0.5 + 0.5;
        gl_Position = vec4(p, 0.0, 1.0);
      }
    `;

    const fragmentSource = `#version 300 es
      precision highp float;
      in vec2 vUV;
      uniform sampler2D uTexture;
      out vec4 outColor;
      void main() {
        // 按当前片元的 UV 读取纹理颜色
        outColor = texture(uTexture, vUV);
      }
    `;

    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 tex = gl.createTexture();
    gl.activeTexture(gl.TEXTURE0);
    gl.bindTexture(gl.TEXTURE_2D, tex);

    // 不依赖 mipmap,允许任意常见图片尺寸
    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);

    gl.uniform1i(gl.getUniformLocation(program, 'uTexture'), 0);
    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
    gl.viewport(0, 0, canvas.width, canvas.height);

    document.querySelector('#pick').addEventListener('change', (event) => {
      const file = event.target.files[0];
      if (!file) return;

      const url = URL.createObjectURL(file);
      const image = new Image();
      image.onload = () => {
        // 图片解码完成后才上传,避免使用未加载的像素
        gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA,
                      gl.RGBA, gl.UNSIGNED_BYTE, image);
        gl.clearColor(0, 0, 0, 1);
        gl.clear(gl.COLOR_BUFFER_BIT);
        gl.drawArrays(gl.TRIANGLES, 0, 3);
        URL.revokeObjectURL(url);
      };
      image.onerror = () => {
        URL.revokeObjectURL(url);
        alert('图片读取失败,请选择 PNG 或 JPEG 文件');
      };
      image.src = url;
    });
  </script>
</body>
</html>

预期结果:打开页面后,首先看到图片选择控件和一个尚未绘制图片的画布。选择有效的 PNG 或 JPEG 文件后,图片会显示在 640×360 画布内,四角位置和上下方向与原图一致。选择另一张图片会替换原来的纹理内容并重新绘制。

代码里的全屏三角形使用 gl_VertexID 生成顶点,因此不需要额外准备顶点缓冲区。三个顶点的位置超出部分裁剪空间,但组合起来恰好覆盖整个画布。GPU 对 vUV 插值后,片元着色器可以连续地读取整张图片。

本例会把图片拉伸到画布的宽高比。如果输入图片是正方形,输出仍然铺满 640×360 的矩形,这是 UV 全范围映射产生的预期现象,不是纹理上传错误。

检查采样结果与处理常见问题

可以选一张左上角有明显标记、四角颜色不同的图片验证采样方向。打开浏览器开发者工具的 Console 面板,确认没有着色器编译错误,再检查四角内容和颜色是否对应。

现象 可能原因 处理方式
选择图片后仍然黑屏 图片未成功解码、上传失败或着色器编译失败 检查 Console、图片加载回调及编译链接日志
图片上下颠倒 图片行方向与 UV 原点不一致 在 texImage2D() 之前启用 UNPACK_FLIP_Y_WEBGL
采样结果为黑色 采样器编号与纹理单元不匹配,或纹理不完整 确保 TEXTURE0 与 uniform1i(..., 0) 一致,并配置不依赖 mipmap 的过滤方式
放大后边缘模糊 gl.LINEAR 对相邻纹素执行线性插值 像素风图片可将放大过滤改为 gl.NEAREST
图片比例变形 图片宽高比不同于画布宽高比 调整画布比例,或在 Shader 中加入等比例 UV 映射

做一个直接可见的验证:将代码中的 TEXTURE_MAG_FILTER 对应参数从 gl.LINEAR 改为 gl.NEAREST,保存并刷新页面,选择一张分辨率较低的图片。放大后的纹素边界应当更加清晰,呈现块状效果;恢复 gl.LINEAR 后,相邻纹素之间会出现平滑过渡。

实际制作动态材质时,只要保留纹理单元与 sampler2D 的正确绑定,就可以把 vUV 换成经过缩放、旋转或时间偏移的坐标。无论 UV 怎样变化,最终读取颜色的接口仍然是 texture(uTexture, uv)。

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

目录与阅读设置

阅读设置

17

记录一个想法

从 sampler2D 获取纹理颜色

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

登录哪都通