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时也要在循环中调用

你可能感兴趣的:(threejs)