three.js TrackballControls

2023-02-16 17:49 更新

TrackballControls 与 OrbitControls 相类似。然而,它不能恒定保持摄像机的up向量。 这意味着,如果摄像机绕过“北极”和“南极”,则不会翻转以保持“右侧朝上”。

例子

misc / controls / trackball

构造函数

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

该数组包含用于控制交互的按键代码。

  • 当定义的第一个按键按下后,所有的鼠标交互(左/中/右键)表现为环绕。
  • 当定义的第二个按键按下后,所有的鼠标交互(左/中/右键)表现为缩放。
  • 当定义的第三个按键按下后,所有的鼠标交互(左/中/右键)表现为平移。

默认为KeyA, KeyS, KeyD,分别表示A, S, D。

.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 () : undefined

确保控制器位于 [minDistance, maxDistance] 范围内。由update()调用。

.dispose () : undefined

若不再需要该控制器,则应当调用此函数。

.handleResize () : undefined

若应用程序窗口大小发生改变,则应当调用此函数。

.panCamera () : undefined

如有必要,执行平移。由update()调用。

.reset () : undefined

重置控制器到初始状态。

.rotateCamera () : undefined

如有必要,旋转相机。由update()调用。

.update () : undefined

更新控制器,常被用在动画循环中。

.zoomCamera () : undefined

如有必要,执行缩放。由update()调用。

源代码

examples/jsm/controls/TrackballControls.js


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号