Web 图形与 3D / 系统课时
统一 Blender 场景单位与轴向
统一 Blender 场景单位与轴向
把 Blender 模型交给 Three.js 后,最常见的验收问题是尺寸相差百倍、模型横躺或底部穿过地面。这里以 Blender 4.5 LTS 的界面为例,制作一个带正面标记的测试盒,导出 GLB,并在浏览器中核对米制尺寸、朝向和贴地高度。
学习目标
- 将 Blender 场景统一为米制,并检查对象尺寸、旋转及缩放。
- 解释 Blender 的 Z 向上如何转换为 glTF 与 Three.js 的 Y 向上。
- 使用 GLTFLoader 和包围盒验证导出模型的尺寸、正面与地面位置。
设定米制与贴地基准
打开右侧属性编辑器的 Scene Properties(场景属性)→ Units(单位),按下表设置。下面采用“1 Blender 单位代表 1 米”的资产约定,而不是把厘米数值直接当作模型坐标。
| 设置 | 推荐值 | 用途 |
|---|---|---|
| Unit System | Metric | 用公制显示距离 |
| Unit Scale | 1.0 | 统一内部单位与米的换算 |
| Length | Meters | 在界面中直接查看米数 |
项目约定物体底部贴在 Blender 世界坐标的 Z=0,原点周围留给 Three.js 的地面。不要为修正导出尺寸临时把 Unit Scale 改为 0.01;如果素材来自厘米制软件,应先弄清源文件的物理尺寸,再按实际米数修正几何体。
制作带朝向标记的测试盒
- 新建 Blender 场景,使用默认立方体,或通过 Shift+A → Mesh → Cube 添加。按 F2 重命名为
GaugeBody。 - 切到 Object Mode,按 N 打开侧栏,在 Item → Transform 中输入 Dimensions:X=2 m、Y=1 m、Z=1 m,Location:X=0、Y=0、Z=0.5 m,Rotation:0°。
- 选中
GaugeBody,按 Ctrl+A → Scale。重新查看 Scale,应为(1, 1, 1);Dimensions 仍为2 × 1 × 1 m,盒体最低点为 Z=0。 - 再加一个立方体,命名
FrontMark,Dimensions 设为(0.3, 0.12, 0.2) m,Location 设为(0, -0.56, 0.5) m。给它设一个橙色材质,让它从主盒的 -Y 面向前凸出。
本项目约定模型正面朝 Blender 的 -Y,而不是根据建模视角随意调整朝向。测试盒宽 2 米、高 1 米、深 1 米;凸出的 FrontMark 只用于确认正面,不参加主盒尺寸验收。这里对静态物体应用缩放;已有骨骼、约束或动画的资产不要直接批量应用变换。
理解轴向转换并导出 GLB
Blender 使用 +Z 向上;glTF 2.0 定义 +Y 向上、+Z 为模型正面、长度单位为米。Blender 的 glTF 导出器在启用 Y Up 时完成坐标换算,Three.js 的 GLTFLoader 直接读取转换后的数据,无须再给模型根节点补一层旋转。
| Blender 方向 | glTF / Three.js 方向 |
|---|---|
| +X(水平) | +X |
| +Z(向上) | +Y(向上) |
| -Y(模型正面) | +Z(模型正面) |

导出时在 Outliner 中选中 GaugeBody 和 FrontMark,执行 File → Export → glTF 2.0 (.glb/.gltf),将 Format 设为 glTF Binary (.glb),在 Include 中勾选 Selected Objects,在 Transform 中保持 Y Up 勾选,保存为 axis-check.glb。Blender 4.2—4.5 的面板分组可能略有差异,字段名以所用版本为准。
在 Three.js 中运行验收
使用已安装 Node.js 的终端创建 Vite 原生 JavaScript 项目。以下命令适用于 Bash;使用 Windows PowerShell 时可在文件管理器中创建 public/models 目录。
npm create vite@latest axis-check -- --template vanilla
cd axis-check
npm install
npm install three
mkdir -p public/models预期结果:生成 axis-check 项目并安装 Three.js,目录中存在 public/models。将导出的 axis-check.glb 复制到 public/models/axis-check.glb。
把项目的 src/main.js 替换为下面的完整代码。浏览器从正面略偏右的位置观察盒体,地面网格位于 Y=0;尺寸测量仅针对主盒,不受前端橙色标记影响。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
async function main() {
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf2f5f7);
const camera = new THREE.PerspectiveCamera(50, innerWidth / innerHeight, 0.1, 100);
camera.position.set(3, 2, 4);
camera.lookAt(0, 0.5, 0);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(innerWidth, innerHeight);
document.body.style.margin = '0';
document.querySelector('#app').appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x808080, 2));
scene.add(new THREE.GridHelper(6, 12));
// 导出器已经换轴,加载后不再旋转或缩放模型根节点。
const gltf = await new GLTFLoader().loadAsync('/models/axis-check.glb');
scene.add(gltf.scene);
const body = gltf.scene.getObjectByName('GaugeBody');
if (!body) throw new Error('找不到 GaugeBody,请检查导出对象');
// 前向标记凸出盒体,因此只测量主盒的世界空间包围盒。
gltf.scene.updateWorldMatrix(true, true);
const box = new THREE.Box3().setFromObject(body, true);
const size = box.getSize(new THREE.Vector3());
const fmt = (v) => (Math.abs(v) < 0.0005 ? 0 : v).toFixed(3);
console.log('尺寸 XYZ (m):', [size.x, size.y, size.z].map(fmt).join(', '));
console.log('底面 Y (m):', fmt(box.min.y));
const pass = Math.abs(size.x - 2) < 0.01
&& Math.abs(size.y - 1) < 0.01
&& Math.abs(size.z - 1) < 0.01
&& Math.abs(box.min.y) < 0.01;
console.log('验收:', pass ? 'PASS' : 'FAIL');
renderer.render(scene, camera);
}
main().catch(console.error);预期结果:在下一步启动服务器并打开页面后,能看到直立的长方盒、朝向镜头的橙色前向标记和位于盒底的网格线。浏览器开发者工具 Console 应输出:
尺寸 XYZ (m): 2.000, 1.000, 1.000
底面 Y (m): 0.000
验收: PASS启动开发服务器:
npm run dev预期输出(端口实际值可能不同):
Local: http://localhost:<PORT>/在浏览器打开终端给出的本地地址。验收容差采用 0.01 m(1 厘米),可容纳微小的浮点误差,但不会放过米与厘米混淆造成的百倍偏差。
按现象修正导出问题
- 尺寸变成
200 × 100 × 100:先核对源模型物理尺寸、Scene Units 和对象 Scale;不要直接在 Three.js 中统一乘0.01。 - 盒体横躺或前向标记位于侧面:检查
Y Up是否勾选、Blender 正面是否朝-Y,并移除网页端人为添加的 90° 旋转。 - 尺寸正确但盒底低于或高于地面:检查 Blender 中盒体中心是否位于 Z=0.5、是否导出了额外父节点位移,随后重新查看
box.min.y。
只要主盒尺寸为 (2, 1, 1) 米、底面 Y 接近 0,且橙色前向标记在 Three.js 的 +Z 一侧,这个资产的单位、上轴和前向基准就通过了首次交付验收。