本教程详细介绍了如何在webgl画布上通过鼠标事件绘制单个像素。文章深入探讨了`vertexattrib2f`与`vertexattribpointer`的区别及适用场景，纠正了常见的`drawarrays`调用错误和缓冲区管理误区，并提供了完整的代码示例，帮助开发者理解webgl中javascript与gpu之间的数据通信机制。
引言：在WebGL中响应鼠标事件绘制像素
在WebGL中实现交互式绘图，例如根据鼠标位置绘制像素，是理解JavaScript与GPU之间数据通信的关键一步。本教程将指导您如何在WebGL画布上，通过鼠标移动事件，在指定位置绘制单个像素。我们将重点讨论顶点属性的设置方式、drawArrays调用的正确使用，以及如何避免常见的缓冲区管理错误。
理解顶点属性的两种设置方式
在WebGL中，顶点着色器通过attribute变量接收顶点数据。将数据传递给这些属性有两种主要方式：通过缓冲区（Buffer）或直接设置静态值。
1. 使用缓冲区 (gl.vertexAttribPointer)
当您需要绘制多个顶点，且这些顶点的数据（如位置、颜色、法线等）存储在一个数组中时，通常会使用缓冲区。
- 创建和绑定缓冲区： gl.createBuffer() 和 gl.bindBuffer(gl.ARRAY_BUFFER, buffer)。
- 填充数据： gl.bufferData(gl.ARRAY_BUFFER, data, usage)。
- 启用顶点属性数组： gl.enableVertexAttribArray(location)，这告诉WebGL此属性将从缓冲区中获取数据。
- 指定数据布局： gl.vertexAttribPointer(location, size, type, normalize, stride, offset)，它定义了数据在缓冲区中的结构（每个顶点有多少分量、数据类型、是否归一化、步长和偏移量）。
这种方法适用于绘制几何体或大量顶点数据。
2. 直接设置静态值 (gl.vertexAttrib2f 等)
当您只需要为一个属性设置一个固定的值，并且这个值在每次绘制调用中对所有顶点都相同，或者您只需要绘制一个点时，可以直接使用gl.vertexAttrib*f系列函数。
- 禁用顶点属性数组： gl.disableVertexAttribArray(location)。这是关键一步，它告诉WebGL此属性的值将通过gl.vertexAttrib*f设置，而不是从缓冲区中读取。
- 设置属性值： gl.vertexAttrib2f(location, x, y) (对于vec2类型属性)。
这种方法对于绘制单个点或为所有顶点设置一个统一的属性值非常高效，因为它避免了创建和管理缓冲区的开销。
常见的错误与解决方案
在实现鼠标事件绘制像素时，开发者常遇到以下问题：
-
drawArrays调用参数错误：
- 问题： 错误地将gl.drawArrays(gl.POINTS, 0, 3)用于只包含一个点的缓冲区或静态属性。
- 解释： drawArrays的第三个参数是要绘制的顶点数量。如果只绘制一个点，这个值必须是1。
- 解决方案： 将gl.drawArrays(gl.POINTS, 0, 1)。
-
vertexAttrib2f与vertexAttribPointer的混用：
- 问题： 在启用gl.enableVertexAttribArray后，又尝试使用gl.vertexAttrib2f来设置属性值。
- 解释： 当gl.enableVertexAttribArray被调用时，WebGL期望属性数据来自当前绑定的ARRAY_BUFFER。如果同时使用gl.vertexAttrib2f，可能会导致冲突或意外行为。
- 解决方案： 如果您决定使用gl.vertexAttrib2f来绘制单个像素，则必须禁用该属性的顶点属性数组：gl.disableVertexAttribArray(positionAttributeLocation)。
-
冗余的缓冲区设置：
- 问题： 在每次鼠标事件中创建新的缓冲区，即使只绘制一个点。
- 解释： 对于绘制单个像素，使用gl.vertexAttrib2f直接设置属性值是更简洁和高效的方法，无需任何缓冲区。如果确实需要使用缓冲区（例如，累积多个点），也应该复用同一个缓冲区，并通过gl.bufferSubData或重新调用gl.bufferData来更新其内容，而不是反复创建新缓冲区。
- 解决方案： 对于本教程的单像素绘制场景，完全可以省略缓冲区创建和管理的代码，直接使用gl.vertexAttrib2f。
实现鼠标事件绘制像素
我们将使用gl.vertexAttrib2f这种简洁高效的方法来绘制单个像素。
1. HTML 结构
我们需要一个canvas元素和两个script标签来存放顶点着色器和片段着色器代码。
WebGL Mouse Draw Pixel
2. JavaScript 代码 (main.js)
// 辅助函数：编译和链接着色器
function setup(ctx, vertSource, fragSource) {
const vs = ctx.createShader(ctx.VERTEX_SHADER);
ctx.shaderSource(vs, vertSource);
ctx.compileShader(vs);
if (!ctx.getShaderParameter(vs, ctx.COMPILE_STATUS)) {
console.error('Vertex shader compile error:', ctx.getShaderInfoLog(vs));
ctx.deleteShader(vs);
return null;
}
const fs = ctx.createShader(ctx.FRAGMENT_SHADER);
ctx.shaderSource(fs, fragSource);
ctx.compileShader(fs);
if (!ctx.getShaderParameter(fs, ctx.COMPILE_STATUS)) {
console.error('Fragment shader compile error:', ctx.getShaderInfoLog(fs));
ctx.deleteShader(fs);
return null;
}
const program = ctx.createProgram();
ctx.attachShader(program, vs);
ctx.attachShader(program, fs);
ctx.linkProgram(program);
if (!ctx.getProgramParameter(program, ctx.LINK_STATUS)) {
console.error('Program link error:', ctx.getProgramInfoLog(program));
ctx.deleteProgram(program);
return null;
}
return program;
}
const canvas = document.getElementById('canvas');
// 获取WebGL上下文，preserveDrawingBuffer: true 确保绘制内容在帧之间保留
const gl = canvas.getContext('webgl', { preserveDrawingBuffer: true });
if (!gl) {
alert('您的浏览器不支持WebGL！');
}
// 获取着色器源码
const vertShaderSource = document.getElementById('vert1').textContent;
const fragShaderSource = document.getElementById('frag1').textContent;
// 编译并链接着色器程序
const program = setup(gl, vertShaderSource, fragShaderSource);
if (!program) {
console.error("Failed to initialize WebGL program.");
}
gl.useProgram(program);
// 获取a_position属性的位置
const positionAttributeLocation = gl.getAttribLocation(program, 'a_position');
// **关键：禁用此属性的顶点属性数组，因为我们将使用gl.vertexAttrib2f设置静态值**
gl.disableVertexAttribArray(positionAttributeLocation);
// 获取u_resolution uniform的位置并设置画布分辨率
const resolutionUniformLocation = gl.getUniformLocation(program, 'u_resolution');
gl.uniform2f(resolutionUniformLocation, gl.canvas.width, gl.canvas.height);
// 监听鼠标移动事件
canvas.addEventListener('mousemove', (e) => {
// 获取canvas在视口中的位置和大小
const rect = canvas.getBoundingClientRect();
// 计算相对于canvas的X坐标
const x = e.clientX - rect.left;
// 计算相对于canvas的Y坐标，并进行翻转，因为WebGL的Y轴向上为正，而浏览器Y轴向下为正
const y = rect.height - (e.clientY - rect.top);
// 使用gl.vertexAttrib2f直接设置a_position属性的值
gl.vertexAttrib2f(positionAttributeLocation, x, y);
// 绘制一个点。第三个参数必须是1，因为我们只绘制一个顶点。
gl.drawArrays(gl.POINTS, 0, 1);
});
// 初始清空画布
gl.clearColor(0.0, 0.0, 0.0, 0.0); // 透明背景
gl.clear(gl.COLOR_BUFFER_BIT);3. 顶点着色器 (vert1)
顶点着色器负责将输入的像素坐标转换为WebGL的裁剪空间坐标（-1.0到+1.0）。
attribute vec2 a_position; // 接收像素坐标 (x, y)
uniform vec2 u_resolution; // 接收画布分辨率 (width, height)
void main() {
// 将像素坐标从 [0, resolution] 范围转换为 [0.0, 1.0]
vec2 zeroToOne = a_position / u_resolution;
// 转换为 [0.0, 2.0]
vec2 zeroToTwo = zeroToOne * 2.0;
// 转换为裁剪空间坐标 [-1.0, +1.0]
vec2 clipSpace = zeroToTwo - 1.0;
// 设置最终的顶点位置
gl_Position = vec4(clipSpace, 0.0, 1.0);
}4. 片段着色器 (frag1)
片段着色器负责为每个被光栅化的像素（片段）设置颜色。
precision mediump float; // 声明浮点数精度
uniform vec4 u_color; // 尽管本例中未直接使用，但保留作为通用实践
void main() {
gl_FragColor = vec4(1,0,1,1); // 设置固定颜色为品红色 (RGBA)
}运行效果与注意事项
运行上述代码，当您将鼠标移动到WebGL画布上时，会在鼠标位置绘制出品红色的像素点。
注意事项：
- preserveDrawingBuffer: true： 在获取WebGL上下文时设置此选项至关重要。它指示浏览器在每次绘制调用后保留画布的内容。如果为false（默认值），每次绘制后画布内容可能会被清除，导致之前的像素消失。
- 坐标系转换： 确保正确处理鼠标事件的坐标。e.clientX和e.clientY是相对于视口（viewport）的坐标。canvas.getBoundingClientRect()可以帮助您获取画布相对于视口的位置。此外，WebGL的Y轴通常向上为正，而浏览器通常向下为正，因此需要进行rect.height - (e.clientY - rect.top)这样的翻转。
- 性能考量： 尽管gl.vertexAttrib2f对于绘制单个像素非常高效，但如果您需要绘制大量点或复杂的图形，并且这些图形的顶点数据会频繁更新，那么更推荐使用缓冲区并结合gl.bufferSubData来更新数据，以减少GPU和CPU之间的通信开销。
总结
本教程通过一个在WebGL画布上响应鼠标事件绘制单个像素的实例，详细阐述了WebGL中顶点属性的两种主要设置方式：gl.vertexAttribPointer（用于缓冲区数据）和gl.vertexAttrib2f（用于静态属性值）。我们强调了正确使用drawArrays调用以及在不同场景下选择合适的属性设置方法的重要性。通过理解这些核心概念，您将能够更有效地在WebGL中进行交互式图形编程。
