轨迹球控制器（TrackballControls）
优质
小牛编辑
199浏览
2023-12-01
TrackballControls 与 OrbitControls 相类似。然而，它不能恒定保持摄像机的up向量。 这意味着，如果摄像机绕过“北极”和“南极”，则不会翻转以保持“右侧朝上”。
例子
构造函数
TrackballControls( camera : Camera, domElement : HTMLDOMElement )
camera: 渲染场景的摄像机。
domElement: 用于事件监听的HTML元素。
创建一个新的 TrackballControls 实例。
事件
change
当摄像机被控制器变换后触发。
start
当交互（例如触摸）被初始化后触发。
end
当交互完成后触发。
属性
.domElement : HTMLDOMElement
该 HTMLDOMElement 用于监听鼠标/触摸事件，该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
.dynamicDampingFactor : Number
设置阻尼的强度。仅在staticMoving设为false时考虑。默认为0.2。
.enabled : Boolean
是否启用控制器。
.keys : Array
该数组包含用于控制交互的按键代码。
- 当定义的第一个按键按下后，所有的鼠标交互（左/中/右键）表现为环绕。
- 当定义的第二个按键按下后，所有的鼠标交互（左/中/右键）表现为缩放。
- 当定义的第三个按键按下后，所有的鼠标交互（左/中/右键）表现为平移。
.maxDistance : Number
你能够将相机向外移动多少，其默认值为Infinity。
.minDistance : Number
你能够将相机向内移动多少，其默认值为0。
.mouseButtons : Object
该对象包含由控件所使用的鼠标操作的引用。
- .LEFT 指定给 THREE.MOUSE.ROTATE
- .MIDDLE 指定给 THREE.MOUSE.ZOOM
- .RIGHT 指定给 THREE.MOUSE.PAN
.noPan : Boolean
是否禁用平移，默认为false。
.noRotate : Boolean
是否禁用旋转，默认为false。
.noZoom : Boolean
是否禁用缩放，默认为false。
.object : Camera
正被控制的摄像机。
.panSpeed : Number
平移的速度，其默认值为0.3。
.rotateSpeed : Number
旋转的速度，其默认值为1.0。
.screen : Object
表示屏幕的属性。在handleResize()被调用时会自动设置。
- left: 表示到屏幕左侧边界的偏移量（单位为像素）。
- top: 表示到屏幕顶部边界的偏移量（单位为像素）。
- width: 表示屏幕的宽度（单位为像素）。
- height: 表示屏幕的高度（单位为像素）。
.staticMoving : Boolean
阻尼是否被禁用。默认为false。
.zoomSpeed : Number
缩放的速度，其默认值为1.2。
方法
.checkDistances () : null
确保控制器位于 [minDistance, maxDistance] 范围内。由update()调用。
.dispose () : null
若不再需要该控制器，则应当调用此函数。
.handleResize () : null
若应用程序窗口大小发生改变，则应当调用此函数。
.panCamera () : null
如有必要，执行平移。由update()调用。
.reset () : null
重置控制器到初始状态。
.rotateCamera () : null
如有必要，旋转相机。由update()调用。
.update () : null
更新控制器，常被用在动画循环中。
.zoomCamera () : null
如有必要，执行缩放。由update()调用。