FirstPersonControls.html 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  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. <h1>第一人称控制器([name])</h1>
  11. <p class="desc">
  12. 该类是 [page:FlyControls] 的另一个实现。
  13. </p>
  14. <h2>例子</h2>
  15. <p>[example:webgl_geometry_terrain webgl / geometry / terrain ]</p>
  16. <h2>构造函数</h2>
  17. <h3>[name]( [param:Camera object], [param:HTMLDOMElement domElement] )</h3>
  18. <p>
  19. <p>
  20. [page:Camera object]: 被控制的摄像机。
  21. </p>
  22. <p>
  23. [page:HTMLDOMElement domElement]: 用于事件监听的HTML元素。
  24. </p>
  25. <p>
  26. 创建一个新的 [name] 实例。
  27. </p>
  28. </p>
  29. <h2>属性</h2>
  30. <h3>[property:Boolean activeLook]</h3>
  31. <p>
  32. 是否能够环视四周。默认为*true*。
  33. </p>
  34. <h3>[property:Boolean autoForward]</h3>
  35. <p>
  36. 摄像机是否自动向前移动。默认为*false*。
  37. </p>
  38. <h3>[property:Boolean constrainVertical]</h3>
  39. <p>
  40. 垂直环视是否约束在[[page:.verticalMin], [page:.verticalMax]]之间。默认值为*false*。
  41. </p>
  42. <h3>[property:HTMLDOMElement domElement]</h3>
  43. <p>
  44. 该 HTMLDOMElement 用于监听鼠标/触摸事件,该属性必须在构造函数中传入。在此处改变它将不会设置新的事件监听。
  45. </p>
  46. <h3>[property:Boolean enabled]</h3>
  47. <p>
  48. 是否启用控制器。默认为*true*。
  49. </p>
  50. <h3>[property:Number heightCoef]</h3>
  51. <p>
  52. Determines how much faster the camera moves when it's y-component is near [page:.heightMax]. Default is *1*.
  53. </p>
  54. <h3>[property:Number heightMax]</h3>
  55. <p>
  56. Upper camera height limit used for movement speed adjusment. Default is *1*.
  57. </p>
  58. <h3>[property:Number heightMin]</h3>
  59. <p>
  60. Lower camera height limit used for movement speed adjusment. Default is *0*.
  61. </p>
  62. <h3>[property:Boolean heightSpeed]</h3>
  63. <p>
  64. 摄像机的高度是否影响向前移动的速度。默认值为*false*。
  65. 使用属性 [page:.heightCoef]、 [page:.heightMin] 和 [page:.heightMax] 来进行配置。
  66. </p>
  67. <h3>[property:Boolean lookVertical]</h3>
  68. <p>
  69. 是否能够垂直环视。默认为*true*。
  70. </p>
  71. <h3>[property:Number lookSpeed]</h3>
  72. <p>
  73. 环视速度。默认为*0.005*。
  74. </p>
  75. <h3>[property:Boolean mouseDragOn]</h3>
  76. <p>
  77. 鼠标是否被按下。只读属性。
  78. </p>
  79. <h3>[property:Number movementSpeed]</h3>
  80. <p>
  81. 移动速度。默认为*1*。
  82. </p>
  83. <h3>[property:Camera object]</h3>
  84. <p>
  85. 被控制的摄像机。
  86. </p>
  87. <h3>[property:Number verticalMax]</h3>
  88. <p>
  89. 你能够垂直环视角度的上限。范围在 0 到 Math.PI 弧度之间。默认为*Math.PI*。
  90. </p>
  91. <h3>[property:Number verticalMin]</h3>
  92. <p>
  93. 你能够垂直环视角度的下限。范围在 0 到 Math.PI 弧度之间。默认为*0*。
  94. </p>
  95. <h2>方法</h2>
  96. <h3>[method:null dispose] ()</h3>
  97. <p>
  98. 若不再需要该控制器,则应当调用此函数。
  99. </p>
  100. <h3>[method:null handleResize] ()</h3>
  101. <p>
  102. 若应用程序窗口大小发生改变,则应当调用此函数。
  103. </p>
  104. <h3>[method:FirstPersonControls lookAt]( [param:Vector3 vector] )<br />
  105. [method:FirstPersonControls lookAt]( [param:Float x], [param:Float y], [param:Float z] )</h3>
  106. <p>
  107. <p>
  108. <p>
  109. vector - 一个表示目标位置的向量。
  110. </p>
  111. <p>
  112. 或者,世界空间位置的x、y、z分量。
  113. </p>
  114. </p>
  115. <p>
  116. 确保控制器将相机方向朝向到所传入的目标的位置。
  117. </p>
  118. </p>
  119. <h3>[method:null update] ( [param:Number delta] )</h3>
  120. <p>
  121. <p>
  122. [page:Number delta]: Time delta value.
  123. </p>
  124. <p>
  125. 更新控制器,常被用在动画循环中。
  126. </p>
  127. </p>
  128. <h2>源代码</h2>
  129. <p>
  130. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/FirstPersonControls.js examples/jsm/controls/FirstPersonControls.js]
  131. </p>
  132. </body>
  133. </html>