[page:OrbitControls] →

# 地图控制器([name])

[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 ]

## 构造函数

### [name]( [param:Camera object], [param:HTMLDOMElement domElement] )

[page:Camera object]：（必填）要控制的相机。相机不能是另一个对象的子对象，除非该对象是场景本身。
[page:HTMLDOMElement domElement]： 用于事件侦听器的 HTML 元素。

## 事件

有关常见事件，请参阅 [page:OrbitControls] 基类。

## 属性

有关常见属性，请参阅 [page:OrbitControls] 基类。

### [property:Object mouseButtons]

该对象包含对控件使用的鼠标操作的引用。 `controls.mouseButtons = { LEFT: THREE.MOUSE.PAN, MIDDLE: THREE.MOUSE.DOLLY, RIGHT: THREE.MOUSE.ROTATE }`

### [property:Boolean screenSpacePanning]

定义平移时摄像机位置的平移方式。如果为 true，相机将在屏幕空间中平移。否则，摄像机将在与摄像机向上方向正交的平面中平移。默认为 `false`。

### [property:Object touches]

该对象包含对控件使用的触摸操作的引用。 `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]