Web 图形与 3D / 系统课时
导入模型的单位与朝向如何校准
导入模型的单位与朝向如何校准
外部 glTF 模型进入 Three.js 后,常出现尺寸离谱、正面朝侧方或悬在地面上的情况。本课用世界空间包围盒测量实际范围,再按朝向、比例、位置的顺序校准,让不同来源的资产在展厅中使用统一的展示尺度与旋转中心。
学习目标
- 根据 glTF 的坐标约定与
Box3检查尺寸、方向和空间偏移。 - 将模型等比缩放到指定范围,完成水平居中与底部接地。
- 用包围盒数值验证结果,区分展示归一化与真实物理尺寸。
先确认单位和坐标基准
glTF 2.0 规范规定右手坐标系,+Y 向上、+Z 为正面,线性距离以米计;Three.js 默认也是 Y 轴朝上。但来源资产可能带有额外根节点旋转,或在导出时把厘米误当成米。先约定展厅使用 XZ 地面、Y 轴高度、正面朝 +Z、底面落在 y = 0。
Box3.setFromObject() 会根据当前层级和世界变换,计算包含子对象的世界轴对齐包围盒(AABB)。getSize() 得到宽、高、深,getCenter() 得到包围盒中心。节点原点不等于几何中心;即使 gltf.scene.position 是零,模型也可能整体偏到一边。应先修正朝向,再测量和缩放,因为旋转会改变 X/Z 方向的包围范围。
按朝向、比例、位置依次校准
使用两层容器:外层 turntable 的原点留在展示中心,供产品绕 Y 轴旋转;内层 fit 承担来源方向修正、缩放与位置补偿。不要直接覆盖 glTF 内每个网格的局部变换,否则可能破坏层级和动画。

以旋转后测得的包围盒 1.2 × 2.5 × 0.8 为例,若最长边目标为 2.0 个世界单位,则等比系数为 2.0 / 2.5 = 0.8,调整后尺寸变为 0.96 × 2.0 × 0.64。随后重新计算包围盒,用其 center.x、center.z 做水平位移,用 min.y 做落地位移。
在 Three.js 中完成校准
以下示例适用于使用 npm 安装 three 的 Vite 原生 JavaScript 工程。先运行 npm install three,将有效的 product.glb 放在工程的 public/models/ 下,再把代码写入项目的 src/main.js(或 index.html 实际引用的入口脚本)。示例假设源模型正面为 +X,若已经朝 +Z,将 yawDegrees 改为 0。运行 npm run dev 后打开页面。
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
async function main() {
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf7f9fa);
scene.add(new THREE.GridHelper(5, 10));
scene.add(new THREE.HemisphereLight(0xffffff, 0x667788, 2));
const camera = new THREE.PerspectiveCamera(
45, window.innerWidth / window.innerHeight, 0.1, 100
);
camera.position.set(3, 2.5, 4);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setSize(window.innerWidth, window.innerHeight);
document.body.style.margin = '0';
document.body.appendChild(renderer.domElement);
const controls = new OrbitControls(camera, renderer.domElement);
controls.target.set(0, 1, 0);
controls.update();
const turntable = new THREE.Group();
scene.add(turntable);
try {
const gltf = await new GLTFLoader().loadAsync('/models/product.glb');
const fit = new THREE.Group();
turntable.add(fit);
fit.add(gltf.scene);
const yawDegrees = -90; // 源资产面朝 +X;展厅要求面朝 +Z
fit.rotation.y = THREE.MathUtils.degToRad(yawDegrees);
fit.updateWorldMatrix(true, true);
const box = new THREE.Box3().setFromObject(fit);
if (box.isEmpty()) throw new Error('模型没有可测量的几何体');
const size = box.getSize(new THREE.Vector3());
const longest = Math.max(size.x, size.y, size.z);
if (longest < 1e-6) throw new Error('模型包围盒尺寸为零');
fit.scale.setScalar(2 / longest); // 三轴同倍率,防止模型变形
fit.updateWorldMatrix(true, true);
box.setFromObject(fit);
const center = box.getCenter(new THREE.Vector3());
// 让展示轴心处于水平中心,并使模型底部落在地面
fit.position.set(-center.x, -box.min.y, -center.z);
fit.updateWorldMatrix(true, true);
box.setFromObject(fit);
const actual = box.getSize(new THREE.Vector3());
const actualCenter = box.getCenter(new THREE.Vector3());
console.log('最长边:', Math.max(actual.x, actual.y, actual.z).toFixed(2));
console.log('底面归零:', Math.abs(box.min.y) < 1e-5);
console.log('XZ 居中:',
Math.abs(actualCenter.x) < 1e-5 && Math.abs(actualCenter.z) < 1e-5);
} catch (error) {
console.error('模型加载或校准失败:', error);
}
renderer.setAnimationLoop(() => renderer.render(scene, camera));
}
main();预期输出(浏览器控制台,资源加载成功且包含有效几何体):
最长边: 2.00
底面归零: true
XZ 居中: true页面上应看到模型立于网格地面,水平中心与网格原点重合。此后若需自动旋转,应修改外层 turntable.rotation.y,不要再次旋转已经校准过的 fit。
验证失败时检查什么
- 模型正面不对:先确认资产在源软件中的正面。若源正面已是 +Z,就把
yawDegrees设为0;不要重复做轴系转换。 - 模型大小异常:核对来源软件的单位、导出缩放以及根节点
scale。例如把厘米数据误作米会产生约 100 倍的尺寸差,应该修正资产单位,而不是靠任意缩放掩盖问题。 - 居中后仍然偏斜:检查是否把地板、隐藏辅助网格或远离主体的零件一起导出;这些子对象也可能计入包围盒。应移除无关对象后再测量。
- 动画时穿过地面:本例依据加载时的姿态计算 AABB,适合静态产品。若模型有大幅骨骼动作或形变,应根据动画范围另行计算安全边界。
Box3 给的是世界轴对齐范围,而非模型自身的有向包围盒;倾斜或旋转后重新测量属于正常现象。真正需要准确的尺寸展示时,保留源资产的物理单位,使用校准后的坐标进行相机取景,而不是统一最大边长。