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;如果素材来自厘米制软件,应先弄清源文件的物理尺寸,再按实际米数修正几何体。

制作带朝向标记的测试盒

  1. 新建 Blender 场景,使用默认立方体,或通过 Shift+A → Mesh → Cube 添加。按 F2 重命名为 GaugeBody。
  2. 切到 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°。
  3. 选中 GaugeBody,按 Ctrl+A → Scale。重新查看 Scale,应为 (1, 1, 1);Dimensions 仍为 2 × 1 × 1 m,盒体最低点为 Z=0。
  4. 再加一个立方体,命名 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(模型正面)

Blender 与 glTF 的上轴、正面和地面基准转换

导出时在 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 目录。

bash
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;尺寸测量仅针对主盒,不受前端橙色标记影响。

js
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 应输出:

text
尺寸 XYZ (m): 2.000, 1.000, 1.000
底面 Y (m): 0.000
验收: PASS

启动开发服务器:

bash
npm run dev

预期输出(端口实际值可能不同):

text
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 一侧,这个资产的单位、上轴和前向基准就通过了首次交付验收。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

统一 Blender 场景单位与轴向

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通