该类被用于提供一个拖放交互。
[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:DragControls.objects]数组包含一个单个可拖拽的组对象时该选项生效。如果设置为`true`,[name]会转换整个组对象,而不对单个对象做转换。默认值为`false`。
共有方法请参见其基类[page:EventDispatcher]。
添加控制器的事件监听。
移除控制器的事件监听。
若不再需要该控制器,则应当调用此函数。
返回可拖拽的对象数组。
返回用于相交测试的内部[page:Raycaster]实例。
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/DragControls.js examples/jsm/controls/DragControls.js]