89 lines
1.8 KiB
Markdown
89 lines
1.8 KiB
Markdown
# jumpToCamera 方法使用指南
|
||
|
||
## 概述
|
||
|
||
`jumpToCamera` 是 BIM 引擎提供的一个视角跳转方法，允许开发者通过传入相机配置 JSON 数据，将 3D 视图快速定位到指定构件或特定视角。
|
||
|
||
## 方法签名
|
||
|
||
```javascript
|
||
engine.engine.jumpToCamera(cameraData)
|
||
```
|
||
|
||
### 参数
|
||
|
||
- `cameraData` - 相机配置 JSON 对象
|
||
|
||
### 返回值
|
||
|
||
- `true` - 跳转成功
|
||
- `false` - 跳转失败
|
||
|
||
## 基本使用
|
||
|
||
```javascript
|
||
// 跳转到指定视角
|
||
engine.engine.jumpToCamera({
|
||
type: "orthographic",
|
||
position: { x: 229.68, y: 247.98, z: 233.79 },
|
||
target: { x: -4.58, y: 13.72, z: -0.47 },
|
||
orthographicHeight: 140.56
|
||
});
|
||
```
|
||
|
||
## 配合 getModelPosition 使用
|
||
|
||
```javascript
|
||
// 1. 获取构件位置数据（返回的 modelJson 中包含 cameraRestorePose）
|
||
const data = engine.engine.getModelPosition({
|
||
url: "模型URL",
|
||
ids: [465979]
|
||
});
|
||
|
||
// 2. 使用返回的 cameraRestorePose 跳转视角
|
||
if (data?.modelJson?.cameraRestorePose) {
|
||
engine.engine.jumpToCamera(data.modelJson.cameraRestorePose);
|
||
}
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. 调用前确保引擎已初始化
|
||
2. 参数为 JSON 对象格式
|
||
3. 数据可通过 `getModelPosition` 方法获取
|
||
|
||
## 完整示例
|
||
|
||
```javascript
|
||
const engine = new BimEngine(container, { theme: 'dark' });
|
||
|
||
// 初始化引擎
|
||
engine.engine.initialize({
|
||
version: 'v2',
|
||
showStats: false,
|
||
showViewCube: true
|
||
});
|
||
|
||
// 加载模型
|
||
engine.engine.loadModel(['模型URL'], {
|
||
position: [0, 0, 0],
|
||
rotation: [0, 0, 0],
|
||
scale: [1, 1, 1]
|
||
});
|
||
|
||
// 获取构件位置并跳转
|
||
const componentData = engine.engine.getModelPosition({
|
||
url: "模型URL",
|
||
ids: [465979]
|
||
});
|
||
|
||
if (componentData?.modelJson?.cameraRestorePose) {
|
||
const success = engine.engine.jumpToCamera(
|
||
componentData.modelJson.cameraRestorePose
|
||
);
|
||
|
||
if (success) {
|
||
console.log('跳转成功');
|
||
}
|
||
}
|
||
``` |