Three Vue3Three Vue3
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
指南
在线演示
AI 智能体
  • English
  • 简体中文
GitHub
    • 快速开始
    • 场景
    • 参数总线
    • 天空盒
    • 模型加载器

      • 组件加载器
      • 函数加载器
    • 弹出窗口
    • 标注
    • 动态元素
    • 动画
    • 模型旋转器
    • 拾取
    • 相机自适应
      • 默认用法
      • 函数
      • 选项
      • 方法
    • 网格模型

      • 波动圆
      • 流动线网格
    • 效果

      • 自然

        • 雨
        • 雪
        • 海洋水面
        • 互动水池
        • 沙滩漫步
      • 天空与大气

        • 天空穹顶
        • 高度雾
        • 星云星系
      • 光照

        • 泛光
        • 扫光
        • 灯光渐变
        • 光柱
        • 雷达扫描
        • 信号波
        • 力场护盾
      • 粒子与精灵

        • 烟花
        • 文字烟花
        • 光晕精灵
    • 地理

      • 地理参考系
      • GeoObject 地理对象
      • GeoJsonLayer 图层
      • 瓦片图层

类型

类 / 函数

FitCamera 是一个带有自适应取景方法的 THREE.PerspectiveCamera,同样的能力也以普通函数形式导出。它们会根据内容的包围盒计算相机距离,因此无需为特定模型尺寸硬编码视点或远裁剪面。

默认用法

点击我查看代码
<template>
  <tv-scene class="scene" :camera="camera" @created="created"></tv-scene>
</template>

<script lang="ts" setup>
import * as THREE from 'three'
import { FitCamera } from 'three-vue3'

const camera = new FitCamera(45, 1, 0.1, 2000)

const created = (scene, { controls }) => {
  const group = new THREE.Group()
  const geometry = new THREE.SphereGeometry(0.4, 16, 16)
  const material = new THREE.MeshLambertMaterial({ color: 0xff7a45 })

  for (let i = 0; i < 12; i++) {
    const sphere = new THREE.Mesh(geometry, material)
    sphere.position.set(Math.cos(i) * 6, (i % 3) - 1, Math.sin(i) * 6)
    group.add(sphere)
  }

  scene.add(group)

  // 一次调用即可让全部对象进入视野。
  if (controls) camera.bind(controls).fitToObject(group)
}
</script>

<style>
.scene {
  margin-top: 10px;
  width: 100%;
  height: 300px;
}
</style>

函数

类的各个方法都委托给以下函数,它们接受任意 THREE.PerspectiveCamera。

import { fitCameraToBox, fitCameraToObject, fitCameraToPoints } from 'three-vue3'

fitCameraToObject(camera, model, { elevation: Math.PI / 6, padding: 1.6 })

选项

名称类型默认值描述
elevationnumberPI / 4可选 相对水平面的俯仰角(弧度)。
azimuthnumberPI / 4可选 围绕目标点的水平方位角,从 -Z 轴顺时针计算。
paddingnumber1.4可选 距离倍数,> 1 会向外拉远以留出边距。
distancenumber可选 直接指定距离(世界单位),覆盖计算结果。
adjustClipbooleantrue可选 根据内容尺寸自动推导 near / far。
controlsOrbitControls | nullnull可选 传入后会把它的 target 同步到包围盒中心。

方法

名称参数描述
bind(controls?: OrbitControls | null) => this绑定后续取景使用的控制器。
fitToPoints(points: LocalPoint[], options?: CameraFitOptions) => this让一组局部坐标点进入视野。
fitToObject(object: Object3D | Object3D[], options?: CameraFitOptions) => this让对象的世界包围盒进入视野。
fitToBox(box: THREE.Box3, options?: CameraFitOptions) => this让指定的世界包围盒进入视野。
在 GitHub 上编辑此页
Last Updated:
Contributors: Shing Rui
Prev
拾取