本文深入探讨了在webgl中异步加载并拼接多张图像到单个画布上的技术。文章首先提供了一个简单的解决方案，通过配置webgl上下文的`preservedrawingbuffer`属性来避免图像渲染后被清除的问题。随后，文章详细阐述了如何利用帧缓冲（framebuffer）实现更高级的图像合成，包括帧缓冲的正确设置、目标纹理的初始化以及双通道渲染策略，以实现图像的累积和整体处理。
在Web图形编程中，我们经常会遇到需要将多张图像异步加载并组合到同一个WebGL画布上的场景。例如，构建一个瓦片地图、图像编辑器或是进行复杂的图像合成。一个常见的挑战是，当新图像加载并渲染时，之前已经渲染的图像可能会消失。本文将详细介绍两种解决此问题的方法：一种是快速简便的上下文配置，另一种是利用帧缓冲（Framebuffer）实现更灵活和专业的图像合成。
一、快速修复：保留绘图缓冲区
最直接且简单的解决方案是调整WebGL上下文的创建参数。WebGL默认行为是在每次绘制操作后清除画布内容，这导致了图像的“闪烁”或“消失”现象。通过设置preserveDrawingBuffer为true，可以指示WebGL保留画布的绘图缓冲区内容，从而使后续绘制操作可以在现有内容上叠加。
代码示例：
const canvas = document.getElementById('myWebGLCanvas');
const gl = canvas.getContext('webgl', { preserveDrawingBuffer: true });
if (!gl) {
console.error('无法初始化WebGL。您的浏览器或机器可能不支持。');
// 处理错误
}
// ... 你的WebGL初始化和渲染逻辑 ...注意事项：
- 优点： 实现简单，无需改动现有渲染逻辑即可解决图像消失的问题。
- 缺点： preserveDrawingBuffer: true 可能会对性能产生轻微影响，因为它要求浏览器在每次渲染后保留缓冲区内容，而不是立即释放。对于需要高帧率或大量渲染的复杂应用，这可能不是最佳选择。
- 适用场景： 当你只需要简单地将图像叠加到画布上，并且不需要在每次渲染后对“整个画布”进行统一的着色器处理时，此方法非常有效。
二、高级方案：利用帧缓冲实现图像合成
当我们需要在每次新图像加载后，将“整个画布”视为一个整体纹理，并对其应用着色器处理时，帧缓冲（Framebuffer）是更专业且强大的解决方案。帧缓冲允许我们将渲染结果输出到屏幕外的纹理，而不是直接输出到屏幕。
2.1 帧缓冲工作原理概述
帧缓冲的核心思想是“离屏渲染”。它将渲染管线的输出目标从默认的画布缓冲区重定向到一个或多个纹理附件。通过这种方式，我们可以：
- 将多张图像逐步渲染到同一个帧缓冲的纹理附件上，实现累积效果。
- 将帧缓冲的纹理附件作为输入纹理，再次渲染到画布上，并在此过程中应用全局的图像处理着色器。
2.2 帧缓冲及目标纹理的初始化
首先，我们需要创建一个帧缓冲，并为其附加一个目标纹理（targetTexture）。这个targetTexture将作为所有异步加载图像的“合成画布”，所有绘制到帧缓冲的操作都会写入到这个纹理中。
// 全局或在初始化阶段创建
let gl: WebGLRenderingContext; // 假设gl已经初始化
let program: WebGLProgram; // 假设着色器程序已编译链接
// ... 其他初始化代码 ...
const fb = gl.createFramebuffer(); // 创建帧缓冲
gl.bindFramebuffer(gl.FRAMEBUFFER, fb); // 绑定帧缓冲
const targetTexture = gl.createTexture(); // 创建目标纹理
gl.bindTexture(gl.TEXTURE_2D, targetTexture);
// 定义目标纹理的尺寸和格式。这里使用canvas的尺寸作为示例。
// 注意：传入null作为数据源，表示我们只是创建纹理的存储空间。
gl.texImage2D(
gl.TEXTURE_2D, 0, gl.RGBA,
gl.canvas.width, gl.canvas.height, // 使用画布尺寸，或自定义合成尺寸
0, gl.RGBA, gl.UNSIGNED_BYTE, null
);
// 设置纹理参数，确保可以正常使用
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.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
// 将目标纹理附加到帧缓冲的颜色附件0
gl.framebufferTexture2D(
gl.FRAMEBUFFER,
gl.COLOR_ATTACHMENT0,
gl.TEXTURE_2D,
targetTexture,
0
);
// 检查帧缓冲是否完整
const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
if (status !== gl.FRAMEBUFFER_COMPLETE) {
console.error('帧缓冲不完整:', status);
}
gl.bindFramebuffer(gl.FRAMEBUFFER, null); // 解绑帧缓冲，回到默认画布关键点：
- gl.texImage2D的null参数：表示我们只是预分配纹理的内存空间，而不是立即上传像素数据。
- gl.framebufferTexture2D：将创建好的targetTexture绑定到帧缓冲的颜色附件点。这意味着所有绘制到该帧缓冲的像素数据都将写入到targetTexture中。
2.3 双通道渲染策略
在每次加载新图像后，我们需要执行两个渲染通道（或称两次drawArrays调用）：
- 通道一：渲染新图像到帧缓冲。 这会将当前加载的图像绘制到targetTexture上，与之前已绘制的图像合成。
- 通道二：渲染帧缓冲的内容到画布。 这会将targetTexture（包含所有已合成图像）作为源纹理，绘制到最终的屏幕画布上。在此通道中，你可以对整个合成图像应用全局着色器效果。
为了实现这一策略，我们需要一个positionBuffer来定义绘制矩形的顶点，以及一个texcoordBuffer来定义纹理坐标。setRectangle函数（如问题附录所示）用于更新positionBuffer以匹配所需的绘制区域。
辅助函数 setRectangle：
// 定义一个辅助函数来设置矩形顶点数据
export function setRectangle(
gl: WebGLRenderingContext,
x: number,
y: number,
width: number,
height: number
) {
const x1 = x,
x2 = x + width,
y1 = y,
y2 = y + height;
gl.bufferData(
gl.ARRAY_BUFFER,
new Float32Array([
x1, y1,
x2, y1,
x1, y2,
x1, y2,
x2, y1,
x2, y2
]),
gl.STATIC_DRAW
);
}渲染函数 render 示例：
// 假设这些变量在外部已初始化并查找
let positionLocation: number;
let texcoordLocation: number;
let resolutionLocation: WebGLUniformLocation | null;
let textureSizeLocation: WebGLUniformLocation | null;
let positionBuffer: WebGLBuffer | null;
let texcoordBuffer: WebGLBuffer | null;
// 理想情况下，这些在程序初始化时完成一次
function initRenderAssets() {
positionLocation = gl.getAttribLocation(program, 'a_position');
texcoordLocation = gl.getAttribLocation(program, 'a_texCoord');
resolutionLocation = gl.getUniformLocation(program, 'u_resolution');
textureSizeLocation = gl.getUniformLocation(program, 'u_textureSize');
positionBuffer = gl.createBuffer();
texcoordBuffer = gl.createBuffer();
gl.bindBuffer(gl.ARRAY_BUFFER, texcoordBuffer);
gl.bufferData(
gl.ARRAY_BUFFER,
new Float32Array([
0.0, 0.0,
1.0, 0.0,
0.0, 1.0,
0.0, 1.0,
1.0, 0.0,
1.0, 1.0,
]),
gl.STATIC_DRAW
);
}
// 在图像加载完成后调用此函数
function render(tileImage: HTMLImageElement, tile: Tile) {
gl.useProgram(program); // 激活着色器程序
// 启用顶点属性
gl.enableVertexAttribArray(positionLocation);
gl.enableVertexAttribArray(texcoordLocation);
// 设置纹理坐标（通常是0-1范围，可以只设置一次）
gl.bindBuffer(gl.ARRAY_BUFFER, texcoordBuffer);
gl.vertexAttribPointer(texcoordLocation, 2, gl.FLOAT, false, 0, 0);
// 创建并绑定当前瓦片图像的纹理
const currentTileTexture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, currentTileTexture);
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.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, tileImage);
// --- 通道一：将新瓦片图像渲染到帧缓冲 ---
gl.bindFramebuffer(gl.FRAMEBUFFER, fb); // 绑定自定义帧缓冲
gl.viewport(0, 0, gl.canvas.width, gl.canvas.height); // 视口应与帧缓冲尺寸匹配
// 设置瓦片在帧缓冲中的位置和大小
gl.bindBuffer(gl.ARRAY_BUFFER, positionBuffer);
setRectangle(gl, tile.position.x, tile.position.y, tileImage.width, tileImage.height);
gl.vertexAttribPointer(positionLocation, 2, gl.FLOAT, false, 0, 0);
// 设置统一变量，告知着色器当前渲染瓦片的分辨率
gl.uniform2f(resolutionLocation, gl.canvas.width, gl.canvas.height);
gl.uniform2f(textureSizeLocation, tileImage.width, tileImage.height);
gl.drawArrays(gl.TRIANGLES, 0, 6); // 绘制瓦片到帧缓冲
gl.deleteTexture(currentTileTexture); // 释放瓦片纹理资源，因为它已经绘制到targetTexture中
// --- 通道二：将帧缓冲的内容渲染到画布 ---
gl.bindFramebuffer(gl.FRAMEBUFFER, null); // 绑定默认帧缓冲（画布）
gl.viewport(0, 0, gl.canvas.width, gl.canvas.height); // 视口应与画布尺寸匹配
gl.bindTexture(gl.TEXTURE_2D, targetTexture); // 绑定帧缓冲的目标纹理作为源纹理
// 设置矩形以覆盖整个画布
gl.bindBuffer(gl.ARRAY_BUFFER, positionBuffer);
setRectangle(gl, 0, 0, gl.canvas.width, gl.canvas.height);
gl.vertexAttribPointer(positionLocation, 2, gl.FLOAT, false, 0, 0);
// 设置统一变量 
