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,即可计算保守的相机距离:

d=rsin⁡(θ)×1.15d = \frac{r}{\sin(\theta)} \times 1.15

其中 θ\theta 表示较小的半视场角,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 并提供真实文件),再执行同一套测量与适配逻辑。

js
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 并打开终端给出的本地地址,页面中心可完整看到一个青绿色底座和灰蓝色上部,拖动鼠标可以绕中心旋转。开发者工具控制台应输出:

text
中心误差: 0.000000
最长边: 2.50

检查裁切与异常模型

将浏览器从宽屏缩至窄屏,模型应保持完整;如果只更新 renderer.setSize() 而不改 camera.aspect 和投影矩阵,窄屏容易裁切。上例在窗口变化时重算距离,且不对模型累计执行归一化缩放。

若包围盒为空或最长边为零,应停止适配并检查节点内是否有网格、几何位置数据是否有效。若目标是落地而非居中展示,应重新获取归一化后包围盒的 min.y,将父容器上移 -min.y,并相应调整镜头观察目标。含骨骼或位移动画的模型还要把运动范围纳入包围体,否则静止姿态构图正确,播放动画时仍可能出框。

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

目录与阅读设置

阅读设置

17

记录一个想法

按包围盒居中与适配视角

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

登录哪都通