1
0

PointerLockControls.html 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169
  1. <!DOCTYPE html>
  2. <html lang="ko">
  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:EventDispatcher] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. 해당 클래스의 구현은 [link:https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API Pointer Lock API] 를 기반으로 합니다. [name] 은 1 인칭 3D 게임을 위한 완벽한 선택입니다.
  14. </p>
  15. <h2>수입</h2>
  16. <p>
  17. [name] 는 애드온이며 명시적으로 가져와야 합니다.
  18. See [link:#manual/introduction/Installation Installation / Addons].
  19. </p>
  20. <code>
  21. import { PointerLockControls } from 'three/addons/controls/PointerLockControls.js';
  22. </code>
  23. <h2>Code Example</h2>
  24. <code>
  25. const controls = new PointerLockControls( camera, document.body );
  26. // UI를 표시하거나 숨기기 위해 이벤트 리스너를 추가합니다. (예시: 게임 메뉴)
  27. controls.addEventListener( 'lock', function () {
  28. menu.style.display = 'none';
  29. } );
  30. controls.addEventListener( 'unlock', function () {
  31. menu.style.display = 'block';
  32. } );
  33. </code>
  34. <h2>예시</h2>
  35. <p>[example:misc_controls_pointerlock misc / controls / pointerlock ]</p>
  36. <h2>생성자</h2>
  37. <h3>[name]( [param:Camera camera], [param:HTMLDOMElement domElement] )</h3>
  38. <p>
  39. <p>
  40. [page:Camera camera]: 렌더링 된 장면의 카메라입니다.
  41. </p>
  42. <p>
  43. [page:HTMLDOMElement domElement]: 이벤트 리스너에 사용되는 HTML 엘리먼트입니다.
  44. </p>
  45. <p>
  46. 새로운 [name] 객체를 생성합니다.
  47. </p>
  48. </p>
  49. <h2>이벤트</h2>
  50. <h3>change</h3>
  51. <p>
  52. 사용자 마우스가 움직일 떄 호출됩니다.
  53. </p>
  54. <h3>lock</h3>
  55. <p>
  56. 포인터의 잠금 상태가 "잠김" 일 때 호출됩니다 (in other words: the mouse is captured).
  57. </p>
  58. <h3>unlock</h3>
  59. <p>
  60. 포인터의 잠금 상태가 "잠금 해제" 일 때 호출됩니다. (in other words: the mouse is not captured anymore)
  61. </p>
  62. <h2>특성</h2>
  63. <h3>[property:HTMLDOMElement domElement]</h3>
  64. <p>
  65. 마우스 / 터치 이벤트를 수신하는 데 사용되는 HTMLDOMElement입니다. 이것은 생성자에 의해 설정되어야 합니다;
  66. 생성자를 통해 설정되지 않을 경우 새 이벤트 리스너에 설정되지 않습니다.
  67. </p>
  68. <h3>[property:Boolean isLocked]</h3>
  69. <p>
  70. 컨트롤의 잠김 여부를 설정합니다.
  71. </p>
  72. <h3>[property:Float maxPolarAngle]</h3>
  73. <p>
  74. 카메라 피치(pitch)의 상한값을 설정합니다. 0 부터 Math.PI 라디안까지 범위를 가질 수 있습니다. 기본값은 Math.PI 입니다.
  75. </p>
  76. <h3>[property:Float minPolarAngle]</h3>
  77. <p>
  78. 카메라 피치(pitch)의 하한값을 설정합니다. 0 부터 Math.PI 라디안까지 범위를 가질 수 있습니다. 기본값은 0 입니다.
  79. </p>
  80. <h2>메소드</h2>
  81. <p>일반적인 메소드는 [page:EventDispatcher] 클래스를 참조하세요.</p>
  82. <h3>[method:undefined connect] ()</h3>
  83. <p>
  84. 컨트롤의 이벤트 리스너를 추가합니다.
  85. </p>
  86. <h3>[method:undefined disconnect] ()</h3>
  87. <p>
  88. 컨트롤의 이벤트 리스너를 제거합니다.
  89. </p>
  90. <h3>[method:Vector3 getDirection] ( [param:Vector3 target] )</h3>
  91. <p>
  92. <p>
  93. [page:Vector3 target]: 타겟 벡터를 의미합니다.
  94. </p>
  95. <p>
  96. 카메라가 보고있는 방향을 반환합니다.
  97. </p>
  98. </p>
  99. <h3>[method:undefined lock] ()</h3>
  100. <p>
  101. 포인터 잠금을 활성화합니다.
  102. </p>
  103. <h3>[method:undefined moveForward] ( [param:Number distance] )</h3>
  104. <p>
  105. <p>
  106. [page:Number distance]: 앞으로 이동할 거리를 설정합니다.
  107. </p>
  108. <p>
  109. 카메라를 xz-평면에 평행하게 앞으로 이동합니다. camera.up을 y-up이라고 가정합니다.
  110. </p>
  111. </p>
  112. <h3>[method:undefined moveRight] ( [param:Number distance] )</h3>
  113. <p>
  114. <p>
  115. [page:Number distance]: 오른쪽으로 이동할 거리를 설정합니다.
  116. </p>
  117. <p>
  118. 카메라를 xz 평면에 평행하게 옆으로 이동합니다.
  119. </p>
  120. </p>
  121. <h3>[method:undefined unlock] ()</h3>
  122. <p>
  123. 포인터 잠금을 종료합니다.
  124. </p>
  125. <h2>Source</h2>
  126. <p>
  127. [link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/controls/PointerLockControls.js examples/jsm/controls/PointerLockControls.js]
  128. </p>
  129. </body>
  130. </html>