Web 图形与 3D / 系统课时
按包围盒居中与适配视角
按包围盒居中与适配视角
模型导入后可能偏离原点,尺寸也可能相差数十倍;固定的相机距离容易导致模型被裁切或显得过小。这里用 Box3 提取静态模型的中心与尺寸,把最长边统一为 2.5 个场景单位,再根据视场角适配镜头,并处理容器缩放。
学习目标
- 使用
Box3.setFromObject()获取包含子网格的世界轴对齐包围盒。 - 通过父级
Group完成居中和统一缩放,不破坏模型内部层级。 - 计算透视相机距离、更新裁剪面,并在窗口变化后重新构图。
先测量模型的真实范围
Box3.setFromObject(object) 会综合对象及子节点的世界变换求出轴对齐范围。读取前先调用 object.updateWorldMatrix(true, true);加载 GLB 时必须等 GLTFLoader 成功返回 gltf.scene 后再测量,不能在异步请求发起时就计算。
getCenter() 得到包围盒中心,getSize() 得到 X、Y、Z 三轴长度。例如中心为 (8, 1, -3)、尺寸为 (4, 2, 1),表示模型虽然宽 4 个单位,却不在展示原点。包围盒不等同于模型枢轴点,旋转网格的轴对齐盒也可能留有空白。
用父级容器居中和缩放
设目标最长边为 2.5,比例 k = 2.5 / max(size.x, size.y, size.z)。把原模型放进初始无变换的父级 Group,令父级缩放为 k、位置为 -center * k。对于上面的例子,k = 0.625,父级平移量为 (-5, -0.625, 1.875);归一化后包围盒中心在 (0, 0, 0)。
不要先对模型做位移、再直接修改同一个模型的缩放却不重新计算中心:缩放会改变子节点相对枢轴的偏移,模型可能再次跑偏。通过单独的父级容器同时表达缩放与位移,更容易保留 GLB 内部的节点、材质和动画引用。
根据视场角确定相机距离
透视相机的 fov 是竖直视场角;横向半视场角为 atan(tan(fov / 2) * aspect)。取横向与竖直半视场角中较小的一个,使用能包住归一化模型包围盒的球半径 r,即可计算保守的相机距离:
其中 表示较小的半视场角,1.15 为距离留白系数。例如 r = 1、竖直视场角 45° 且横向更宽时,距离约为 3.01。包围球方案适合自动验收不同外形的静态资产,细长模型可能留白较多。

在浏览器中完整实现
使用 Vite 的 Vanilla JavaScript 模板:执行 npm create vite@latest box-fit-demo -- --template vanilla,进入目录后执行 npm install 和 npm install three。预期结果是出现 src/main.js、index.html,并安装 Three.js;需要本机已安装与当前 Vite 版本兼容的 Node.js。
将 src/main.js 完整替换为下面代码。为保证例子无需下载模型,这里用两个网格模拟位置偏移的静态资产;接入真实 GLB 时,应在 await loader.loadAsync('/models/item.glb') 完成后,用 gltf.scene 替换模拟模型创建部分(需导入 GLTFLoader 并提供真实文件),再执行同一套测量与适配逻辑。
import * as THREE from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
const host = document.querySelector('#app');
Object.assign(host.style, { position: 'fixed', inset: '0' });
const scene = new THREE.Scene();
scene.background = new THREE.Color(0xf5f8fa);
const camera = new THREE.PerspectiveCamera(45, 1, 0.1, 100);
camera.position.set(0, 0, 1);
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
host.appendChild(renderer.domElement);
scene.add(new THREE.HemisphereLight(0xffffff, 0x64748b, 2));
const light = new THREE.DirectionalLight(0xffffff, 2);
light.position.set(3, 5, 6);
scene.add(light);
// 用组合网格模拟带有位置偏移的导入模型。
const model = new THREE.Group();
model.add(new THREE.Mesh(
new THREE.BoxGeometry(3.2, 1.3, 1.6),
new THREE.MeshStandardMaterial({ color: 0x25a69a })
));
const upper = new THREE.Mesh(
new THREE.BoxGeometry(1.4, 0.5, 1.1),
new THREE.MeshStandardMaterial({ color: 0x7595b0 })
);
upper.position.set(0.35, 0.95, 0);
model.add(upper);
model.position.set(4, 1.5, -2);
const pivot = new THREE.Group();
pivot.add(model);
scene.add(pivot);
model.updateWorldMatrix(true, true);
// 在未缩放的父级容器中先测量源模型。
const box = new THREE.Box3().setFromObject(model);
if (box.isEmpty()) throw new Error('模型没有可计算的包围盒');
const center = box.getCenter(new THREE.Vector3());
const size = box.getSize(new THREE.Vector3());
const longest = Math.max(size.x, size.y, size.z);
if (longest <= 0) throw new Error('模型尺寸为零');
const scale = 2.5 / longest;
pivot.scale.setScalar(scale);
pivot.position.copy(center).multiplyScalar(-scale);
const radius = box.getBoundingSphere(new THREE.Sphere()).radius * scale;
const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = true;
function fitCamera() {
const width = Math.max(1, host.clientWidth);
const height = Math.max(1, host.clientHeight);
renderer.setSize(width, height);
camera.aspect = width / height;
const halfV = THREE.MathUtils.degToRad(camera.fov) / 2;
const halfH = Math.atan(Math.tan(halfV) * camera.aspect);
// 按包围球及更窄的半视场角留出安全距离。
const distance = radius / Math.sin(Math.min(halfV, halfH)) * 1.15;
// 缩放画布时保留当前观察方向,不重复缩放模型。
const direction = camera.position.clone().sub(controls.target).normalize();
controls.target.set(0, 0, 0);
camera.position.copy(direction.multiplyScalar(distance));
camera.near = Math.max(0.01, distance - radius * 1.1);
camera.far = distance + radius * 1.1;
camera.updateProjectionMatrix();
controls.update();
}
fitCamera();
window.addEventListener('resize', fitCamera);
const check = new THREE.Box3().setFromObject(pivot);
console.log('中心误差:', check.getCenter(new THREE.Vector3()).length().toFixed(6));
console.log('最长边:', Math.max(...check.getSize(new THREE.Vector3()).toArray()).toFixed(2));
renderer.setAnimationLoop(() => {
controls.update();
renderer.render(scene, camera);
});预期结果:运行 npm run dev 并打开终端给出的本地地址,页面中心可完整看到一个青绿色底座和灰蓝色上部,拖动鼠标可以绕中心旋转。开发者工具控制台应输出:
中心误差: 0.000000
最长边: 2.50检查裁切与异常模型
将浏览器从宽屏缩至窄屏,模型应保持完整;如果只更新 renderer.setSize() 而不改 camera.aspect 和投影矩阵,窄屏容易裁切。上例在窗口变化时重算距离,且不对模型累计执行归一化缩放。
若包围盒为空或最长边为零,应停止适配并检查节点内是否有网格、几何位置数据是否有效。若目标是落地而非居中展示,应重新获取归一化后包围盒的 min.y,将父容器上移 -min.y,并相应调整镜头观察目标。含骨骼或位移动画的模型还要把运动范围纳入包围体,否则静止姿态构图正确,播放动画时仍可能出框。