1
0

MapControls.html 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. <!DOCTYPE html>
  2. <html lang="zh">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body>
  10. [page:OrbitControls] &rarr;
  11. <h1>地图控制器([name])</h1>
  12. <p class="desc">
  13. [name] 旨在从鸟瞰角度在地图上转换相机。该类与 [page:OrbitControls] 共享其实现,但使用特定的预设进行鼠标/触摸交互,并默认禁用屏幕空间平移。
  14. </p>
  15. <h2>导入</h2>
  16. <p>
  17. [name] 是一个附加组件,必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons].
  18. </p>
  19. <code>
  20. import { MapControls } from 'three/addons/controls/MapControls.js';
  21. </code>
  22. <h2>代码示例</h2>
  23. <code>
  24. const renderer = new THREE.WebGLRenderer();
  25. renderer.setSize( window.innerWidth, window.innerHeight );
  26. document.body.appendChild( renderer.domElement );
  27. const scene = new THREE.Scene();
  28. const camera = new THREE.PerspectiveCamera( 45, window.innerWidth / window.innerHeight, 1, 10000 );
  29. camera.position.set( 0, 20, 100 );
  30. const controls = new MapControls( camera, renderer.domElement );
  31. controls.enableDamping = true;
  32. function animate() {
  33. requestAnimationFrame( animate );
  34. // required if controls.enableDamping or controls.autoRotate are set to true
  35. controls.update();
  36. renderer.render( scene, camera );
  37. }
  38. </code>
  39. <h2>例子</h2>
  40. <p>[example:misc_controls_map misc / controls / map ]</p>
  41. <h2>构造函数</h2>
  42. <h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
  43. <p>
  44. [page:Camera object]:(必填)要控制的相机。相机不能是另一个对象的子对象,除非该对象是场景本身。<br><br>
  45. [page:HTMLDOMElement domElement]: 用于事件侦听器的 HTML 元素。
  46. </p>
  47. <h2>事件</h2>
  48. <p>有关常见事件,请参阅 [page:OrbitControls] 基类。</p>
  49. <h2>属性</h2>
  50. <p>有关常见属性,请参阅 [page:OrbitControls] 基类。</p>
  51. <h3>
  52. [property:Object mouseButtons]</h3>
  53. <p>
  54. 该对象包含对控件使用的鼠标操作的引用。
  55. <code>
  56. controls.mouseButtons = {
  57. LEFT: THREE.MOUSE.PAN,
  58. MIDDLE: THREE.MOUSE.DOLLY,
  59. RIGHT: THREE.MOUSE.ROTATE
  60. }
  61. </code>
  62. </p>
  63. <h3>[property:Boolean screenSpacePanning]</h3>
  64. <p>
  65. 定义平移时摄像机位置的平移方式。如果为 true,相机将在屏幕空间中平移。否则,摄像机将在与摄像机向上方向正交的平面中平移。默认为 `false`。
  66. </p>
  67. <h3>[property:Object touches]</h3>
  68. <p>
  69. 该对象包含对控件使用的触摸操作的引用。
  70. <code>
  71. controls.touches = {
  72. ONE: THREE.TOUCH.PAN,
  73. TWO: THREE.TOUCH.DOLLY_ROTATE
  74. }
  75. </code>
  76. </p>
  77. <h2>方法</h2>
  78. <p>有关常用方法,请参阅 [page:OrbitControls]。</p>
  79. <h2>源代码</h2>
  80. <p>
  81. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/MapControls.js examples/jsm/controls/MapControls.js]
  82. </p>
  83. </body>
  84. </html>