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)。
<!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 上下文。