Three.js学习笔记-OrbitControls.js让摄像机围绕目标旋转

例子##

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
target0: Vector3在reset()和saveState()内部使用
target 空间围绕旋转的点
zoom0: Vector3 在reset()和saveState()内部使用
zoomSpeed: Float zoom(变焦)的速度，默认1
方法

dispose(): null 移除所有的事件监听
getAzimuthAngle(): radians 获得用弧度表示的当前水平旋转角度
getPolarAngle(): radians获得用弧度表示的当前垂直旋转角度
reset(): null 通过最近一次调用saveState()或者初始状态来重置为当前的状态
saveState(): null 保存当前控制的状态，可以稍后通过reset()来恢复
update(): false 更新控件，在手动改变了摄像机的转换后必须调用。在设置了autoRotate或enableDamping时也要在循环中调用