Web 图形与 3D / 系统课时
用遮罩控制贴图区域过渡
用遮罩控制贴图区域过渡
想让一张贴图只在画面中央出现,同时保留周围的底图,可以用灰度遮罩控制每个像素的混合比例。直接使用黑白阈值容易产生生硬边界。本课使用 WebGL2 和 GLSL ES 3.00,把遮罩灰度转换成平滑混合权重,制作可调节范围与柔和程度的局部显隐效果。
学习目标
- 理解灰度遮罩、纹理采样与
mix混合权重之间的关系。 - 使用
smoothstep控制局部显隐的阈值和边缘宽度。 - 完成可运行的 WebGL2 示例,并验证遮罩方向、纹理对齐和边缘过渡效果。
灰度遮罩如何控制两张贴图
遮罩通常是一张单通道灰度纹理,每个位置的数值在 0~1 之间。使用相同的 UV 坐标采样底图、覆盖图和遮罩,就能决定当前像素应该显示哪一张贴图。
- 遮罩值为 0:只显示底图 A。
- 遮罩值为 1:只显示覆盖图 B。
- 遮罩值为 0.5:两张贴图各占一半权重。
GLSL 的 mix(A, B, w) 按权重计算 A * (1.0 - w) + B * w。如果直接把灰度值作为 w,遮罩中所有灰度都会产生混合。为了控制覆盖区域的大小和边缘软硬程度,可以先用 smoothstep 重新映射灰度。
设阈值 t = 0.5、过渡半宽 f = 0.1,则 smoothstep(t - f, t + f, m) 在灰度 0.4~0.6 之间完成从 0 到 1 的平滑过渡。
| 遮罩灰度 m | 混合权重 w | 显示结果 |
|---|---|---|
| 0.3 | 0 | 完全显示底图 |
| 0.5 | 0.5 | 两张贴图各占一半 |
| 0.7 | 1 | 完全显示覆盖图 |

实现可调节的 WebGL2 遮罩
下面的示例不依赖外部图片或第三方库,可以直接保存为 mask.html,使用支持 WebGL2 的桌面浏览器打开。程序在内存中生成三张 256×256 的 RGBA 纹理:蓝色棋盘作为底图、橙色斜条纹作为覆盖图、中心亮而四周暗的径向灰度图作为遮罩。
顶点着色器使用全屏三角形生成 UV,片元着色器在同一个 UV 位置采样三张纹理。页面提供两个滑块,分别改变显示区域的阈值和过渡半宽。
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='UTF-8'>
<title>WebGL2 灰度遮罩混合</title>
</head>
<body>
<p>显示阈值 <input id='threshold' type='range' min='0' max='1' step='0.01' value='0.5'> <output id='thresholdValue'></output></p>
<p>过渡半宽 <input id='feather' type='range' min='0.01' max='0.3' step='0.01' value='0.1'> <output id='featherValue'></output></p>
<canvas id='view' width='512' height='512'></canvas>
<script>
const gl = document.querySelector('#view').getContext('webgl2');
if (!gl) throw new Error('当前浏览器未提供 WebGL2');
const vertexSource = `#version 300 es
layout(location = 0) in vec2 aPosition;
out vec2 vUV;
void main() {
vUV = aPosition * 0.5 + 0.5;
gl_Position = vec4(aPosition, 0.0, 1.0);
}`;
const fragmentSource = `#version 300 es
precision highp float;
in vec2 vUV;
uniform sampler2D uBase;
uniform sampler2D uOverlay;
uniform sampler2D uMask;
uniform float uThreshold;
uniform float uFeather;
out vec4 outColor;
void main() {
vec4 base = texture(uBase, vUV);
vec4 overlay = texture(uOverlay, vUV);
float maskValue = texture(uMask, vUV).r;
// 灰度阈值附近形成连续过渡,而非直接二值化。
float weight = smoothstep(
uThreshold - uFeather,
uThreshold + uFeather,
maskValue
);
outColor = mix(base, overlay, weight);
}`;
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.bindBuffer(gl.ARRAY_BUFFER, gl.createBuffer());
gl.bufferData(gl.ARRAY_BUFFER,
new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);
gl.enableVertexAttribArray(0);
gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
function createTexture(layer) {
const size = 256;
const pixels = new Uint8Array(size * size * 4);
for (let y = 0; y < size; y++) {
for (let x = 0; x < size; x++) {
let color;
if (layer === 0) {
const tile = (Math.floor(x / 32) + Math.floor(y / 32)) % 2;
color = tile ? [32, 95, 147, 255] : [79, 158, 195, 255];
} else if (layer === 1) {
const stripe = Math.floor((x + y) / 24) % 2;
color = stripe ? [255, 190, 65, 255] : [235, 101, 63, 255];
} else {
// 白色中心逐渐衰减为黑色,决定覆盖图的可见区域。
const dx = (x - 127.5) / 127.5;
const dy = (y - 127.5) / 127.5;
const gray = Math.round(255 * Math.max(0, 1 - Math.hypot(dx, dy)));
color = [gray, gray, gray, 255];
}
pixels.set(color, (y * size + x) * 4);
}
}
const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
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.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA8,
size, size, 0, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
}
// 三个采样器分别绑定到纹理单元0、1、2。
[0, 1, 2].forEach(i => {
gl.activeTexture(gl.TEXTURE0 + i);
createTexture(i);
});
['uBase', 'uOverlay', 'uMask'].forEach((name, i) => {
gl.uniform1i(gl.getUniformLocation(program, name), i);
});
const threshold = document.querySelector('#threshold');
const feather = document.querySelector('#feather');
function render() {
const t = Number(threshold.value);
const f = Number(feather.value);
document.querySelector('#thresholdValue').textContent = t.toFixed(2);
document.querySelector('#featherValue').textContent = f.toFixed(2);
gl.uniform1f(gl.getUniformLocation(program, 'uThreshold'), t);
gl.uniform1f(gl.getUniformLocation(program, 'uFeather'), f);
gl.viewport(0, 0, gl.canvas.width, gl.canvas.height);
gl.drawArrays(gl.TRIANGLES, 0, 3);
}
threshold.addEventListener('input', render);
feather.addEventListener('input', render);
render();
</script>
</body>
</html>预期结果:页面显示一块正方形画布,蓝色棋盘底图覆盖全屏,橙色斜条纹集中出现在中央圆形区域,圆形边缘柔和地融入底图。拖动显示阈值滑块,中央覆盖区域的大小发生变化;拖动过渡半宽滑块,边缘从接近硬切换逐渐变为宽范围混合。两个滑块旁的数值随操作更新。
调整阈值与边缘宽度
uThreshold 控制遮罩需要达到多高的灰度才显示覆盖图。由于示例遮罩中心最亮、外侧逐渐变暗,提高阈值会缩小覆盖图区域;降低阈值会扩大覆盖图区域。
uFeather 控制灰度权重变化的半宽,而不是直接指定多少个屏幕像素。改变遮罩灰度梯度或图片尺寸后,相同半宽对应的视觉过渡宽度也可能不同。
| 阈值 | 过渡半宽 | 可观察的效果 |
|---|---|---|
| 0.50 | 0.10 | 默认圆形区域,边缘柔和 |
| 0.80 | 0.10 | 覆盖区域明显缩小 |
| 0.20 | 0.10 | 覆盖区域明显扩大 |
| 0.50 | 0.02 | 过渡带较窄,接近硬边 |
| 0.50 | 0.20 | 过渡带较宽,混合更柔和 |
例如把阈值设为 0.5、过渡半宽设为 0.2,混合权重就在遮罩灰度 0.3~0.7 之间平滑变化。如果改成直接比较 maskValue > 0.5,权重只能是 0 或 1,边缘就会出现硬切换。
如果需要反转显隐区域,可以将片元着色器中的采样值改成 1.0 - texture(uMask, vUV).r。此时黑色区域对应较高的覆盖权重,白色区域对应较低的覆盖权重。修改 GLSL 源码后需要重新编译并链接程序。
验证纹理对齐与处理常见问题
完成示例后,可以按下面的顺序检查结果,而不是只判断画面是否出现颜色。
- 把阈值调到 0.5、半宽调到 0.01。检查圆形边界是否接近清晰硬边,中央是否只显示橙色条纹。
- 保持阈值为 0.5,把半宽调到 0.3。检查边界是否扩展为较宽的渐变环,同时中央仍主要显示覆盖图。
- 把阈值调到 0.8。检查圆形区域是否明显缩小,确认遮罩亮部对应覆盖图。
- 把阈值恢复到 0.5,并检查橙色条纹和蓝色棋盘是否在画布所有位置正常显示,没有重复平铺或意外黑块。
如果边缘出现锯齿,先确认遮罩纹理的 TEXTURE_MIN_FILTER 和 TEXTURE_MAG_FILTER 均为 LINEAR,再检查半宽是否过小。smoothstep 能生成连续的权重变化,但无法弥补分辨率严重不足的遮罩,复杂边界还需要更高分辨率或适当的纹理预过滤。
如果遮罩区域与贴图内容错位,检查三张纹理使用的 UV 是否处于同一坐标约定。特别是从 HTML 图片上传纹理时,应确认 UNPACK_FLIP_Y_WEBGL 的处理方式是否一致;本示例使用内存中的像素数组,三个输入天然采用一致的坐标布局。
如果出现整张图都被覆盖或完全没有覆盖,先检查 uMask 是否正确绑定到纹理单元 2,以及 uThreshold 是否处于 0~1 范围。半宽必须大于 0,否则 smoothstep 的两个边界可能相等,结果不再有可靠定义。
对于大多数局部材质过渡,先确保三张纹理使用同一套 UV,再通过遮罩灰度、阈值和过渡半宽这三个因素控制结果,就可以得到位置可控且边缘连续的纹理混合效果。