当前位置: 首页 > 工具软件 > Infinity.js > 使用案例 >

Three.js OrbitControls.js让摄像机围绕目标旋转

吴欣然
2023-12-01

例子

...
var scene = new THREE.Scene();
var camera = new THREE.PerspectiveCamera( 45, window.innerWidth / window.innerHeight, 1, 10000 );
var controls = new THREE.OrbitControls( camera );
camera.position.set( 0, 20, 100 );
controls.update();
function animate() {
    requestAnimationFrame( animate );

    // required if controls.enableDamping or controls.autoRotate are set to true
    controls.update();
    renderer.render( scene, camera );
}

构造函数

  • OrbitControls(object: Camera,domElement: HTMLDOMElement) 
    object: 控制的相机 
    domElement: 可选的,指定在特定的元素(例如画布)上工作

特性

  • autoRotate: Boolean 默认false。设定为true时,相机自动围绕目标旋转但必须调用update()在你的animation循环中

  • autoRotateSpeed: Float 当前者为true时默认2.0,代表每轮60fps用时30s,值越小转动越慢

  • rotateSpeed: Float 旋转速度(ORBIT的旋转速度,鼠标左键),默认1

  • domElement: HTMLDOMElement 侦听鼠标/触摸事件,必须在构造函数中传递,用作特性值更改后不会重新设置事件侦听器 默认是整个文档

  • enableDamping: Boolean 默认false。设置为true则启用阻尼(惯性),用来给控制相机一个重量,必须调用update()在你的animation循环中

  • dampingFactor: Float 前者为true时使用阻尼惯性(可理解为阻止向一个方向移动)

  • enabled: Boolean 是否启用控件,默认true

  • enableKeys: Boolean 能否用键盘控制,默认true ←↑→↓四个键控制物体的移动

  • keys: Object 控制相机平移的四个键。默认四个箭头键{LEFT: 37,UP: 38,RIGHT: 39,DOWM:40} 所有的键值

  • enablePan: Boolean 相机平移,默认true

  • panSpeed: Float 移动的速度,默认1

  • keyPanSpeed: Float 相机平移的速度,默认每按一次控制方向键移动7.0像素

  • enableRotate: Boolean 水平垂直旋转相机,默认true。只想控制单轴,通过PolarAngle/AzimuthAngle的最小值和最大值设置为相同的值,这将导致垂直或水平旋转固定在该值

  • enableZoom: Boolean 相机的缩放

  • maxAzimuthAngle: Float 水平旋转,范围-Math.PI~Math.PI 或者Infinity 默认Infinity

  • minAzimuthAngle: Float 水平旋转,范围-Math.PI~Math.PI 或者-Infinity 默认-Infinity

  • maxPolarAngle: Float 垂直旋转,范围0~Math.PI 默认Math.PI

  • minPolarAngle: Float 垂直旋转,范围0~Math.PI 默认0

  • maxDistance: Float 拉远镜头(只能用在PerspectiveCamera),默认Infinity

  • minDistance: Float 拉近镜头,默认0

  • maxZoom: Float 拉远镜头(只能用在OthorgraphicCamera),默认Infinity

  • minZoom: Float拉近镜头,默认0

  • mouseButton: Object {ORBIT: THREE.MOUSE.LEFT,ZOOM: THREE.MOUSE.MIDDLE,PAN: THREE.MOUSE.RIGHT} 鼠标控制缩放移动和旋转

  • object: Camera 正在控制的相机

  • position0: Vector3 在reset()和saveState()内部使用

  • screenSpacePaning: Boolean 平移时摄像机位置的转换。true,相机的平移在屏幕空间;false,摄像机在与摄像机向上方向正交的平面上平移,默认false

  • target: Vector3在reset()和saveState()内部使用

  • zoom0: Vector3 在reset()和saveState()内部使用

  • zoomSpeed: Float zoom(变焦)的速度,默认1

方法

  • dispose(): null 移除所有的事件监听

  • getAzimuthalAngle(): radians 获得用弧度表示的当前水平旋转角度

  • getPolarAngle(): radians获得用弧度表示的当前垂直旋转角度

  • reset(): null 通过最近一次调用saveState()或者初始状态来重置为当前的状态

  • saveState(): null 保存当前控制的状态,可以稍后通过reset()来恢复

  • update(): false 更新控件,在手动改变了摄像机的钻换后必须调用。在设置了autoRotate或enableDamping时也要在循环中调用

 类似资料: