Web 图形与 3D / 系统课时
顶点缓冲怎样创建自定义网格
顶点缓冲怎样创建自定义网格
内置几何体无法覆盖所有自定义展台与展示面。本篇用四个顶点拼出两个三角形,把位置、索引和法线写入 Three.js 的 BufferGeometry,再通过渲染和反转绕序检查网格朝向,得到一块可独立修改的面片。
学习目标
- 用
position、index和normal组织三角形顶点数据。 - 创建可渲染的自定义
Mesh,核对顶点数和三角形数。 - 区分顶点法线与三角形绕序,定位单面网格消失的问题。
四个顶点如何组成两个三角形
以 XY 平面上边长为 2 的正方形为例,四个顶点依次是 v0=(-1,-1,0)、v1=(1,-1,0)、v2=(1,1,0)、v3=(-1,1,0)。position 保存 12 个浮点数,每三个数是一个顶点的 x、y、z 坐标。
索引 [0,1,2, 0,2,3] 每三项定义一个三角形,两组三角形共用顶点 0 和 2。相较于不使用索引时重复提交六组位置,这里只存四组位置。顶点索引从 0 开始,且同时指向该顶点的全部属性,而不只是坐标。

从相机所在的 +Z 一侧看,两组三角形都是逆时针排列,其几何正面朝向 +Z。normal=(0,0,1) 则表示顶点参与光照计算时采用的表面法线;法线与绕序作用不同。
创建 BufferGeometry 并写入法线
使用 Node.js 22.12 或更新的受支持 LTS 版本,先建立原生 JavaScript 的 Vite 工程并安装 three:
npm create vite@latest custom-buffer-quad -- --template vanilla
cd custom-buffer-quad
npm install
npm install three预期结果:工程中存在 src/main.js,且 three 已安装到项目依赖中;安装日志中的版本和包数量可能不同。
将 src/main.js 完整替换为以下代码。BufferAttribute 的第二个参数 3 表示每个顶点属性占三个数;四组法线全部指向 +Z,与平面朝向一致。
import * as THREE from 'three';
// 四组位置,每组 x、y、z;两个三角形共享顶点。
const positions = new Float32Array([
-1, -1, 0, 1, -1, 0,
1, 1, 0, -1, 1, 0,
]);
// 平面所有顶点均朝 +Z,供光照着色使用。
const normals = new Float32Array([
0, 0, 1, 0, 0, 1,
0, 0, 1, 0, 0, 1,
]);
const geometry = new THREE.BufferGeometry();
geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
geometry.setAttribute('normal', new THREE.BufferAttribute(normals, 3));
// 每组三个索引定义一个正面朝 +Z 的三角形。
geometry.setIndex([0, 1, 2, 0, 2, 3]);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf4f7fa);
scene.add(new THREE.Mesh(
geometry,
new THREE.MeshStandardMaterial({ color: 0x14a99a, side: THREE.FrontSide })
));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(0, 1, 3);
scene.add(light);
// 相机位于 +Z,直接观察网格正面。
const camera = new THREE.PerspectiveCamera(50, 640 / 400, 0.1, 100);
camera.position.set(0, 0, 4);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(640, 400);
document.body.style.margin = '0';
document.querySelector('#app').appendChild(renderer.domElement);
renderer.render(scene, camera);
const normal = geometry.getAttribute('normal');
console.log('顶点数:', geometry.getAttribute('position').count);
console.log('三角形数:', geometry.index.count / 3);
console.log('首顶点法线:', [
normal.getX(0), normal.getY(0), normal.getZ(0)
].join(','));预期结果:打开页面后可见浅色背景上的青绿色正方形,两个三角形接缝不可见。浏览器开发者工具的控制台显示:
顶点数: 4
三角形数: 2
首顶点法线: 0,0,1运行并验证网格方向
在工程目录启动开发服务器:
npm run dev预期输出中会给出本地访问地址,常见形式如下,实际 <PORT> 可能不同:
Local: http://localhost:<PORT>/打开该地址,按 F12 查看控制台。随后只把 geometry.setIndex(...) 中第一组三个索引由 0,1,2 改为 0,2,1,保存并刷新。此时正方形的一半会消失:反转索引让这个三角形从 +Z 看变成顺时针,而材质仍设置为 THREE.FrontSide,因此它被背面剔除。恢复 0,1,2 后应重新显示完整面片。
检查自定义网格时,先确认索引都在 0~3 范围内、索引数是 3 的倍数、position 与 normal 的顶点数均为 4。对于这个平面,也可以去掉手写的 normal 属性,改在设置索引后调用 geometry.computeVertexNormals(),会得到相同的朝 +Z 法线。若模型需要立方体式的硬边,应在相邻面法线不同的地方拆分顶点,而不是让两面共用同一组法线。