[name] 旨在从鸟瞰角度在地图上转换相机。该类与 [page:OrbitControls] 共享其实现,但使用特定的预设进行鼠标/触摸交互,并默认禁用屏幕空间平移。
[name] 是一个附加组件,必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons].
import { MapControls } from 'three/addons/controls/MapControls.js';
const renderer = new THREE.WebGLRenderer();
renderer.setSize( window.innerWidth, window.innerHeight );
document.body.appendChild( renderer.domElement );
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera( 45, window.innerWidth / window.innerHeight, 1, 10000 );
camera.position.set( 0, 20, 100 );
const controls = new MapControls( camera, renderer.domElement );
controls.enableDamping = true;
function animate() {
requestAnimationFrame( animate );
// required if controls.enableDamping or controls.autoRotate are set to true
controls.update();
renderer.render( scene, camera );
}
[example:misc_controls_map misc / controls / map ]
[page:Camera object]:(必填)要控制的相机。相机不能是另一个对象的子对象,除非该对象是场景本身。
[page:HTMLDOMElement domElement]: 用于事件侦听器的 HTML 元素。
有关常见事件,请参阅 [page:OrbitControls] 基类。
有关常见属性,请参阅 [page:OrbitControls] 基类。
该对象包含对控件使用的鼠标操作的引用。
controls.mouseButtons = {
LEFT: THREE.MOUSE.PAN,
MIDDLE: THREE.MOUSE.DOLLY,
RIGHT: THREE.MOUSE.ROTATE
}
定义平移时摄像机位置的平移方式。如果为 true,相机将在屏幕空间中平移。否则,摄像机将在与摄像机向上方向正交的平面中平移。默认为 `false`。
该对象包含对控件使用的触摸操作的引用。
controls.touches = {
ONE: THREE.TOUCH.PAN,
TWO: THREE.TOUCH.DOLLY_ROTATE
}
有关常用方法,请参阅 [page:OrbitControls]。
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/MapControls.js examples/jsm/controls/MapControls.js]