该类被用于提供一个拖放交互。
[name] 是一个附加组件,必须显式导入。 See [link:#manual/introduction/Installation Installation / Addons].
import { DragControls } from 'three/addons/controls/DragControls.js';
const controls = new DragControls( objects, camera, renderer.domElement );
// add event listener to highlight dragged objects
controls.addEventListener( 'dragstart', function ( event ) {
event.object.material.emissive.set( 0xaaaaaa );
} );
controls.addEventListener( 'dragend', function ( event ) {
event.object.material.emissive.set( 0x000000 );
} );
[example:misc_controls_drag misc / controls / drag ]
[page:Array objects]: 一组可被拖拽的3D Objects。
[page:Camera camera]: 渲染场景的摄像机。
[page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。(可选)
创建一个新的 [name] 实例。
当用户开始拖拽3D Objects时触发。
当用户拖拽3D Objects时触发。
当用户开始完成3D Objects时触发。
当指针移动到一个3D Object或者其某个子级上时触发。
当指针移出一个3D Object时触发。
共有属性请参见其基类[page:Controls]。
可拖放对象的数组。
内部用于检测拾取对象的光线投射器。
可拖放对象的子对象是否可以独立于其父对象进行拖放。 默认值为 `true`。
执行 `rotate` 时的旋转速度。该值越大旋转速度越快。 默认值为 `1`。
当 [page:DragControls.objects] 数组包含一个单个可拖拽的组对象时该选项生效。 如果设置为`true`,[name]会转换整个组对象,而不对单个对象做转换。默认值为`false`。
共有方法请参见其基类[page:Controls]。
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/DragControls.js examples/jsm/controls/DragControls.js]