Web 图形与 3D / 系统课时

把片元坐标映射为屏幕 UV

把片元坐标映射为屏幕 UV

在全屏片元着色器中,gl_FragCoord 给出当前片元的像素位置,但直接用它计算颜色会受到画布尺寸影响。把坐标除以实际绘制缓冲区的宽高,就能得到接近 0~1 的屏幕 UV,并用红、绿通道绘制可验证的位置渐变。

学习目标

  • 理解 gl_FragCoord.xy 的原点、单位与像素中心位置。
  • 用 WebGL2 和 GLSL ES 3.00 将像素位置归一化为屏幕 UV。
  • 通过四角颜色检查方向,并避开分辨率不匹配问题。

从像素位置换算为 UV

gl_FragCoord.xy 是当前片元在绘制缓冲区中的窗口坐标。在默认全画布视口中,原点位于左下,X 向右、Y 向上;像素中心落在半整数位置,因此左下角首个像素的中心是 (0.5, 0.5),不是 (0, 0)。

若缓冲区宽为 W、高为 H,归一化规则就是 u=x/Wu=x/W、v=y/Hv=y/H。例如在 640×360 的缓冲区中,连续坐标 (160, 90) 对应 (0.25, 0.25),几何中心 (320, 180) 对应 (0.5, 0.5)。由于实际采样发生在像素中心,最边缘片元的 UV 通常接近、但不等于 0 或 1。

片元像素坐标到屏幕 UV 及位置色的对应关系

运行全屏位置色着色器

将以下代码保存为 uv.html,直接用支持 WebGL2 的浏览器打开。顶点着色器利用 gl_VertexID 生成一个覆盖画布的全屏三角形,不需要额外创建顶点缓冲区;片元着色器把 UV 的两个分量分别写入红色和绿色通道。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>屏幕 UV 位置色</title>
</head>
<body>
<canvas id="screen" width="640" height="360" style="display:block;max-width:100%;height:auto"></canvas>
<script>
const canvas = document.getElementById("screen");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前环境不支持 WebGL2");

// 编译失败时保留驱动返回的错误日志,便于定位 GLSL 问题。
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 vertex = compile(gl.VERTEX_SHADER, `#version 300 es
void main() {
  vec2 p[3] = vec2[3](
    vec2(-1.0, -1.0), vec2(3.0, -1.0), vec2(-1.0, 3.0)
  );
  gl_Position = vec4(p[gl_VertexID], 0.0, 1.0);
}`);

const fragment = compile(gl.FRAGMENT_SHADER, `#version 300 es
precision highp float;
uniform vec2 uResolution;
out vec4 outColor;
void main() {
  // gl_FragCoord 使用绘制缓冲区像素坐标,而不是 CSS 像素。
  vec2 uv = gl_FragCoord.xy / uResolution;
  outColor = vec4(uv, 0.0, 1.0);
}`);

const program = gl.createProgram();
gl.attachShader(program, vertex);
gl.attachShader(program, fragment);
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
  throw new Error(gl.getProgramInfoLog(program) || "程序链接失败");
}
gl.deleteShader(vertex);
gl.deleteShader(fragment);
gl.useProgram(program);

// 视口和分辨率 uniform 使用同一组实际绘制尺寸。
const W = gl.drawingBufferWidth;
const H = gl.drawingBufferHeight;
gl.viewport(0, 0, W, H);
gl.uniform2f(gl.getUniformLocation(program, "uResolution"), W, H);
gl.drawArrays(gl.TRIANGLES, 0, 3);
</script>
</body>
</html>

预期结果:页面出现一个 640×360 的渐变画布,左下角近黑、右下角近红、左上角近绿、右上角近黄;颜色在水平与垂直方向连续变化,没有接缝,也不需要贴图。窄屏下画布可按 CSS 缩小显示,但内部绘制缓冲区仍是 640×360。

用数值检查颜色方向

颜色的计算式为 outColor = vec4(u, v, 0.0, 1.0):红通道表示水平位置,绿通道表示垂直位置,蓝通道始终为 0。检查以下采样点可以判断是否把 X、Y 或原点弄反。

  • 左下首像素:(x, y) = (0.5, 0.5),UV 约为 (0.00078, 0.00139),几乎是黑色。
  • 靠近中心的像素:(320.5, 180.5),UV 约为 (0.50078, 0.50139),呈暗黄色。
  • 右上末像素:(639.5, 359.5),UV 约为 (0.99922, 0.99861),几乎是黄色。

如果红色从右往左增强,说明 X 坐标处理错误;如果绿色从上往下增强,说明 Y 已被翻转。默认 gl_FragCoord 的 Y 轴朝上;需要以左上为原点的屏幕 UV 时,才把 V 改成 1.0 - uv.y。

避免分辨率与视口错配

gl_FragCoord 的单位是绘制缓冲区像素,不能无条件拿 window.innerWidth、canvas.clientWidth 这类 CSS 尺寸当分母。上例使用 gl.drawingBufferWidth 和 gl.drawingBufferHeight,保证 UV 与 gl.viewport(0, 0, W, H) 使用同一坐标尺度;这在设备像素比大于 1 时尤其重要。

如需改变清晰度,可先根据 canvas.clientWidth × devicePixelRatio 和 canvas.clientHeight × devicePixelRatio 设置 canvas.width、canvas.height,再重新设置视口、uResolution 并绘制。只修改 CSS 宽高不会自动改变绘制缓冲区像素数。

当前公式还假设视口左下角是 (0, 0) 且覆盖整个缓冲区。若只在子视口绘制,应先从 gl_FragCoord.xy 减去子视口的左下角像素坐标,再除以子视口宽高;否则颜色渐变会相对整张画布偏移。

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

目录与阅读设置

阅读设置

17

记录一个想法

把片元坐标映射为屏幕 UV

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

登录哪都通