Web 图形与 3D / 系统课时

用 SDF 绘制圆形和圆角矩形

用 SDF 绘制圆形和圆角矩形

本课用 WebGL2 的片元着色器直接计算圆形和圆角矩形的有符号距离,不依赖图片纹理或网格轮廓。完成后,页面会显示两个带平滑边缘的实心图形,并能用少量参数修改尺寸、圆角和描边厚度。

学习目标

  • 理解有符号距离的正负号,以及圆形和圆角矩形的距离公式。
  • 使用 GLSL ES 3.00 绘制填充区域、居中轮廓和抗锯齿边缘。
  • 按像素尺度调整半径、圆角与描边,并检查常见失真。

用有符号距离区分内外

SDF(Signed Distance Function)返回当前点到形状边界的带符号距离:d < 0.0 表示在内部,d == 0.0 表示在边界,d > 0.0 表示在外部。圆形只需计算点到圆心的长度再减半径;圆角矩形则要同时处理直边区域和四角区域。

将片元坐标写成 p = (gl_FragCoord.xy - 0.5 * uResolution) / min(uResolution.x, uResolution.y),以画布中心为原点,并按较短边归一化。对于 800×450 画布,距离 0.01 对应约 4.5 像素,圆半径 0.22 对应约 99 像素;这样圆不会随画布宽高比变成椭圆。

圆形与圆角矩形的有符号距离、半尺寸和描边区域

编写可运行的 WebGL2 示例

新建 sdf.html,复制以下完整代码,用支持 WebGL2 的浏览器打开。顶点着色器通过 gl_VertexID 生成覆盖全屏的三角形;片元着色器分别求两种形状的距离,再根据距离混合颜色。圆角矩形的 b 是外包矩形半尺寸,r 是圆角半径,必须满足 0 < r <= min(b.x, b.y)。

html
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>SDF 图形</title></head>
<body style="margin:0;background:#f6f8fc">
<canvas id="view" width="800" height="450"></canvas>
<script>
const canvas = document.querySelector("#view");
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("当前浏览器不支持 WebGL2");

const vertexSource = `#version 300 es
void main() {
  // 一个超大三角形覆盖整个裁剪空间。
  vec2 v[3] = vec2[3](vec2(-1.0, -1.0), vec2(3.0, -1.0), vec2(-1.0, 3.0));
  gl_Position = vec4(v[gl_VertexID], 0.0, 1.0);
}`;

const fragmentSource = `#version 300 es
precision highp float;
uniform vec2 uResolution;
out vec4 outColor;

float sdCircle(vec2 p, float r) {
  return length(p) - r;
}

float sdRoundBox(vec2 p, vec2 b, float r) {
  // 把圆角部分化为到内侧矩形的距离。
  vec2 q = abs(p) - b + vec2(r);
  return length(max(q, 0.0)) + min(max(q.x, q.y), 0.0) - r;
}

void main() {
  vec2 p = (gl_FragCoord.xy - 0.5 * uResolution)
         / min(uResolution.x, uResolution.y);
  float dc = sdCircle(p - vec2(-0.42, 0.0), 0.22);
  float db = sdRoundBox(p - vec2(0.37, 0.0), vec2(0.25, 0.18), 0.06);
  float d = min(dc, db); // 并集距离用于统一描边。
  float aa = max(fwidth(d), 0.0001);
  float circleFill = 1.0 - smoothstep(-aa, aa, dc);
  float boxFill = 1.0 - smoothstep(-aa, aa, db);

  vec3 color = vec3(0.965, 0.977, 0.99);
  color = mix(color, vec3(0.12, 0.70, 0.61), circleFill);
  color = mix(color, vec3(0.29, 0.48, 0.76), boxFill);
  // abs(d) 将轮廓限定在边界两侧;0.008 是半线宽。
  float halfStroke = 0.008;
  float edge = 1.0 - smoothstep(halfStroke - aa,
                               halfStroke + aa, abs(d));
  color = mix(color, vec3(0.10, 0.18, 0.28), edge);
  outColor = vec4(color, 1.0);
}`;

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());
gl.viewport(0, 0, canvas.width, canvas.height);
gl.uniform2f(gl.getUniformLocation(program, "uResolution"),
             canvas.width, canvas.height);
gl.drawArrays(gl.TRIANGLES, 0, 3);
</script>
</body>
</html>

预期结果:页面左侧出现直径约 198 像素的青绿色圆形,右侧出现约 225×162 像素、圆角半径约 27 像素的蓝色矩形;两者均带深蓝灰色轮廓,边缘平滑,没有明显锯齿。

控制填充、描边和圆角

填充表达式 1.0 - smoothstep(-aa, aa, d) 在内部接近 1.0,在外部接近 0.0;fwidth(d) 按相邻片元的距离变化估计过渡宽度,避免像素级硬边。描边使用 abs(d),因此线条以形状边界为中心,线宽约为 2 * halfStroke * min(width, height) 像素。

调整目标 修改位置 在 800×450 画布上的效果
放大圆形 sdCircle 半径 0.22 改为 0.28 半径从约 99 增至 126 像素
加厚轮廓 halfStroke 从 0.008 改为 0.015 名义线宽从约 7.2 增至 13.5 像素
加大圆角 sdRoundBox 的 r 从 0.06 改为 0.10 圆角半径从约 27 增至 45 像素
只保留空心轮廓 将两个填充混色语句移除 保留背景和边界着色,内部不填色

圆角半径大于矩形较短的半尺寸时,原公式的几何含义会改变;本例 b.y = 0.18,因此把 r 控制在 0.0 到 0.18 之间。若绘制多种重叠形状,min(dc, db) 得到并集外轮廓,但逐个填充混色的先后仍会影响重叠处颜色。

验证结果并排查变形

检查圆是否仍为正圆、轮廓是否围绕边界两侧均匀分布,再把 halfStroke 改为 0.015 对比线宽。若圆被拉成长椭圆,通常是把 x、y 分别除以宽和高,却直接把归一化坐标当作等比例距离;改为统一除以 min(uResolution.x, uResolution.y)。

若窗口或画布像素尺寸改变,必须同步更新 canvas.width、canvas.height、gl.viewport 和 uResolution;只调整 CSS 显示尺寸会缩放已有像素,导致形状和描边一起被拉伸。若出现黑屏,检查浏览器控制台中的着色器编译或程序链接错误,并确认确实获得了 webgl2 上下文。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 SDF 绘制圆形和圆角矩形

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

登录哪都通