cameras.html 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528
  1. <!DOCTYPE html><html lang="ja"><head>
  2. <meta charset="utf-8">
  3. <title>のカメラ</title>
  4. <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
  5. <meta name="twitter:card" content="summary_large_image">
  6. <meta name="twitter:site" content="@threejs">
  7. <meta name="twitter:title" content="Three.js – のカメラ">
  8. <meta property="og:image" content="https://threejs.org/files/share.png">
  9. <link rel="shortcut icon" href="/files/favicon_white.ico" media="(prefers-color-scheme: dark)">
  10. <link rel="shortcut icon" href="/files/favicon.ico" media="(prefers-color-scheme: light)">
  11. <link rel="stylesheet" href="/manual/resources/lesson.css">
  12. <link rel="stylesheet" href="/manual/resources/lang.css">
  13. <!-- Import maps polyfill -->
  14. <!-- Remove this when import maps will be widely supported -->
  15. <script async src="https://unpkg.com/[email protected]/dist/es-module-shims.js"></script>
  16. <script type="importmap">
  17. {
  18. "imports": {
  19. "three": "../../build/three.module.js"
  20. }
  21. }
  22. </script>
  23. </head>
  24. <body>
  25. <div class="container">
  26. <div class="lesson-title">
  27. <h1>のカメラ</h1>
  28. </div>
  29. <div class="lesson">
  30. <div class="lesson-main">
  31. <p>この記事はThree.jsの連載記事の1つです。
  32. 最初の記事は<a href="fundamentals.html">Three.jsの基礎知識</a>です。
  33. まだ読んでいない場合、そこから始めると良いかもしれません。</p>
  34. <p>three.jsでのカメラの話をしましょう。
  35. <a href="fundamentals.html">最初の記事</a>でいくつか取り上げましたが、ここではもっと詳しく取り上げます。</p>
  36. <p><code class="notranslate" translate="no">PerspectiveCamera(透視投影カメラ)</code> はthree.jsで最も一般的なカメラで、今までの記事で使ってきました。
  37. 遠くのものが近くのものよりも小さく見える3Dビューを提供します。</p>
  38. <p><a href="/docs/#api/ja/cameras/PerspectiveCamera"><code class="notranslate" translate="no">PerspectiveCamera</code></a> は <em>錐台</em> を定義します。
  39. <a href="https://en.wikipedia.org/wiki/Frustum">錐台とは先端が切り取られたピラミッドのような3D形状の事です</a>。
  40. つまり、cube(立方体)、cone(円錐体)、sphere(球体)、cylinder(円柱)、frustum(錐台)は全て異なる種類の固体名です。</p>
  41. <div class="spread">
  42. <div><div data-diagram="shapeCube"></div><div>cube</div></div>
  43. <div><div data-diagram="shapeCone"></div><div>cone</div></div>
  44. <div><div data-diagram="shapeSphere"></div><div>sphere</div></div>
  45. <div><div data-diagram="shapeCylinder"></div><div>cylinder</div></div>
  46. <div><div data-diagram="shapeFrustum"></div><div>frustum</div></div>
  47. </div>
  48. <p>私はこの事を何年も知らなかったです。
  49. どこかの本やページで <em>錐台</em> について書かれていると目が点になります。
  50. 錐台が固体名と理解すると、それらの記述を急に理解できるようになりました 😅</p>
  51. <p><a href="/docs/#api/ja/cameras/PerspectiveCamera"><code class="notranslate" translate="no">PerspectiveCamera</code></a> には4つのプロパティをもとに錐台が定義されています。
  52. <code class="notranslate" translate="no">near</code> は錐台の正面がどこから始まるかを定義します。
  53. <code class="notranslate" translate="no">far</code> は錐台が終了する場所です。
  54. <code class="notranslate" translate="no">fov</code> は視野角で、カメラから <code class="notranslate" translate="no">near</code> 単位で指定された視野角を得るために正しい高さが計算され、錐台の前面と背面の高さを定義します。
  55. <code class="notranslate" translate="no">aspect</code> は錐台の前面と背面の幅です。
  56. 錐台の幅は高さにaspectを掛けたものです。</p>
  57. <p><img src="../resources/frustum-3d.svg" width="500" class="threejs_center"></p>
  58. <p><a href="lights.html">前回の記事</a>から地面となる平面、球体、立方体のあるシーンを利用し、カメラの設定を調整してみましょう。</p>
  59. <p><code class="notranslate" translate="no">near</code> と <code class="notranslate" translate="no">far</code> の設定用に <code class="notranslate" translate="no">MinMaxGUIHelper</code> を作成します。
  60. <code class="notranslate" translate="no">far</code> が常に <code class="notranslate" translate="no">near</code> よりも大きい値になるようにします。
  61. MinMaxGUIHelperは <code class="notranslate" translate="no">min</code> と <code class="notranslate" translate="no">max</code> のプロパティがあり、lil-guiで調整します。
  62. GUIで値を調整すると2つのプロパティに設定されます。</p>
  63. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">class MinMaxGUIHelper {
  64. constructor(obj, minProp, maxProp, minDif) {
  65. this.obj = obj;
  66. this.minProp = minProp;
  67. this.maxProp = maxProp;
  68. this.minDif = minDif;
  69. }
  70. get min() {
  71. return this.obj[this.minProp];
  72. }
  73. set min(v) {
  74. this.obj[this.minProp] = v;
  75. this.obj[this.maxProp] = Math.max(this.obj[this.maxProp], v + this.minDif);
  76. }
  77. get max() {
  78. return this.obj[this.maxProp];
  79. }
  80. set max(v) {
  81. this.obj[this.maxProp] = v;
  82. this.min = this.min; // this will call the min setter
  83. }
  84. }
  85. </pre>
  86. <p>これでGUIを以下のように設定できます。</p>
  87. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function updateCamera() {
  88. camera.updateProjectionMatrix();
  89. }
  90. const gui = new GUI();
  91. gui.add(camera, 'fov', 1, 180).onChange(updateCamera);
  92. const minMaxGUIHelper = new MinMaxGUIHelper(camera, 'near', 'far', 0.1);
  93. gui.add(minMaxGUIHelper, 'min', 0.1, 50, 0.1).name('near').onChange(updateCamera);
  94. gui.add(minMaxGUIHelper, 'max', 0.1, 50, 0.1).name('far').onChange(updateCamera);
  95. </pre>
  96. <p>カメラ設定の変更時、カメラの <a href="/docs/#api/ja/cameras/PerspectiveCamera#updateProjectionMatrix"><code class="notranslate" translate="no">updateProjectionMatrix</code></a> 関数を呼び出す必要があります。
  97. <code class="notranslate" translate="no">updateCamera</code> という関数を作り、それをlil-gui変更時に呼び出すようにします。</p>
  98. <p></p><div translate="no" class="threejs_example_container notranslate">
  99. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-perspective.html"></iframe></div>
  100. <a class="threejs_center" href="/manual/examples/cameras-perspective.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  101. </div>
  102. <p></p>
  103. <p>値を調整すると動作が確認できます。
  104. <code class="notranslate" translate="no">aspect</code> を調整したい場合は、新しいウィンドウでサンプルを開いてからウィンドウサイズを変更して下さい。</p>
  105. <p>それでもまだ少し見づらいので、2つのカメラを持つサンプルに変えます。
  106. 1つ目のカメラは上記で見たシーンを表示し、2つ目のカメラは1つ目のカメラが描画してるシーンを見ている別のカメラとし、そのカメラの錐台を表示します。</p>
  107. <p>そのためにthree.jsのシザー関数を利用します。
  108. シザー機能を使い、カメラを2台並べて2つのシーンを描画するように変更してみましょう。</p>
  109. <p>まず、HTMLとCSSを使って2つの並んでるDOM要素を定義してみましょう。
  110. 両方のカメラが簡単に独自の <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> を持てるようにします。</p>
  111. <pre class="prettyprint showlinemods notranslate lang-html" translate="no">&lt;body&gt;
  112. &lt;canvas id="c"&gt;&lt;/canvas&gt;
  113. + &lt;div class="split"&gt;
  114. + &lt;div id="view1" tabindex="1"&gt;&lt;/div&gt;
  115. + &lt;div id="view2" tabindex="2"&gt;&lt;/div&gt;
  116. + &lt;/div&gt;
  117. &lt;/body&gt;
  118. </pre>
  119. <p>このview1とview2をキャンバスの上に重ねて表示させます。</p>
  120. <pre class="prettyprint showlinemods notranslate lang-css" translate="no">.split {
  121. position: absolute;
  122. left: 0;
  123. top: 0;
  124. width: 100%;
  125. height: 100%;
  126. display: flex;
  127. }
  128. .split&gt;div {
  129. width: 100%;
  130. height: 100%;
  131. }
  132. </pre>
  133. <p>次に <a href="/docs/#api/ja/helpers/CameraHelper"><code class="notranslate" translate="no">CameraHelper</code></a> を追加します。
  134. <a href="/docs/#api/ja/helpers/CameraHelper"><code class="notranslate" translate="no">CameraHelper</code></a> は <a href="/docs/#api/ja/cameras/Camera"><code class="notranslate" translate="no">Camera</code></a> の錐台を描画します。</p>
  135. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const cameraHelper = new THREE.CameraHelper(camera);
  136. ...
  137. scene.add(cameraHelper);
  138. </pre>
  139. <p>view1とview2のDOM要素をquerySelectorしましょう。</p>
  140. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const view1Elem = document.querySelector('#view1');
  141. const view2Elem = document.querySelector('#view2');
  142. </pre>
  143. <p>既存の <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> をview1にのみ反応するようにします。</p>
  144. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-const controls = new OrbitControls(camera, canvas);
  145. +const controls = new OrbitControls(camera, view1Elem);
  146. </pre>
  147. <p>2つ目の <a href="/docs/#api/ja/cameras/PerspectiveCamera"><code class="notranslate" translate="no">PerspectiveCamera</code></a> と <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> を作ってみましょう。
  148. 2つ目の <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> は2つ目のカメラに関連付けし、view2から入力を取得します。</p>
  149. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const camera2 = new THREE.PerspectiveCamera(
  150. 60, // fov
  151. 2, // aspect
  152. 0.1, // near
  153. 500, // far
  154. );
  155. camera2.position.set(40, 10, 30);
  156. camera2.lookAt(0, 5, 0);
  157. const controls2 = new OrbitControls(camera2, view2Elem);
  158. controls2.target.set(0, 5, 0);
  159. controls2.update();
  160. </pre>
  161. <p>最後にキャンバスの一部だけをレンダリングするために、シザー機能を使い各カメラの視点からシーンをレンダリングします。</p>
  162. <p>ここにDOM要素を渡すと、キャンバスに重なる矩形を計算する関数があります。
  163. その矩形にシザーとビューポートを設定し、アスペクト比を返します。</p>
  164. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function setScissorForElement(elem) {
  165. const canvasRect = canvas.getBoundingClientRect();
  166. const elemRect = elem.getBoundingClientRect();
  167. // compute a canvas relative rectangle
  168. const right = Math.min(elemRect.right, canvasRect.right) - canvasRect.left;
  169. const left = Math.max(0, elemRect.left - canvasRect.left);
  170. const bottom = Math.min(elemRect.bottom, canvasRect.bottom) - canvasRect.top;
  171. const top = Math.max(0, elemRect.top - canvasRect.top);
  172. const width = Math.min(canvasRect.width, right - left);
  173. const height = Math.min(canvasRect.height, bottom - top);
  174. // setup the scissor to only render to that part of the canvas
  175. const positiveYUpBottom = canvasRect.height - bottom;
  176. renderer.setScissor(left, positiveYUpBottom, width, height);
  177. renderer.setViewport(left, positiveYUpBottom, width, height);
  178. // return the aspect
  179. return width / height;
  180. }
  181. </pre>
  182. <p>この関数を使って <code class="notranslate" translate="no">render</code> 関数でシーンを2回描画できます。</p>
  183. <pre class="prettyprint showlinemods notranslate lang-js" translate="no"> function render() {
  184. - if (resizeRendererToDisplaySize(renderer)) {
  185. - const canvas = renderer.domElement;
  186. - camera.aspect = canvas.clientWidth / canvas.clientHeight;
  187. - camera.updateProjectionMatrix();
  188. - }
  189. + resizeRendererToDisplaySize(renderer);
  190. +
  191. + // turn on the scissor
  192. + renderer.setScissorTest(true);
  193. +
  194. + // render the original view
  195. + {
  196. + const aspect = setScissorForElement(view1Elem);
  197. +
  198. + // adjust the camera for this aspect
  199. + camera.aspect = aspect;
  200. + camera.updateProjectionMatrix();
  201. + cameraHelper.update();
  202. +
  203. + // don't draw the camera helper in the original view
  204. + cameraHelper.visible = false;
  205. +
  206. + scene.background.set(0x000000);
  207. +
  208. + // render
  209. + renderer.render(scene, camera);
  210. + }
  211. +
  212. + // render from the 2nd camera
  213. + {
  214. + const aspect = setScissorForElement(view2Elem);
  215. +
  216. + // adjust the camera for this aspect
  217. + camera2.aspect = aspect;
  218. + camera2.updateProjectionMatrix();
  219. +
  220. + // draw the camera helper in the 2nd view
  221. + cameraHelper.visible = true;
  222. +
  223. + scene.background.set(0x000040);
  224. +
  225. + renderer.render(scene, camera2);
  226. + }
  227. - renderer.render(scene, camera);
  228. requestAnimationFrame(render);
  229. }
  230. requestAnimationFrame(render);
  231. }
  232. </pre>
  233. <p>上記のコードはview1とview2を区別するために、view2をレンダリング時のシーンの背景色を紺色にしています。</p>
  234. <p>また、<code class="notranslate" translate="no">render</code> 関数内で全て更新しているため、<code class="notranslate" translate="no">updateCamera</code> のコードを削除できます。</p>
  235. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-function updateCamera() {
  236. - camera.updateProjectionMatrix();
  237. -}
  238. const gui = new GUI();
  239. -gui.add(camera, 'fov', 1, 180).onChange(updateCamera);
  240. +gui.add(camera, 'fov', 1, 180);
  241. const minMaxGUIHelper = new MinMaxGUIHelper(camera, 'near', 'far', 0.1);
  242. -gui.add(minMaxGUIHelper, 'min', 0.1, 50, 0.1).name('near').onChange(updateCamera);
  243. -gui.add(minMaxGUIHelper, 'max', 0.1, 50, 0.1).name('far').onChange(updateCamera);
  244. +gui.add(minMaxGUIHelper, 'min', 0.1, 50, 0.1).name('near');
  245. +gui.add(minMaxGUIHelper, 'max', 0.1, 50, 0.1).name('far');
  246. </pre>
  247. <p>片方のviewを使い、もう片方の錐台を見るれるようになりました。</p>
  248. <p></p><div translate="no" class="threejs_example_container notranslate">
  249. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-perspective-2-scenes.html"></iframe></div>
  250. <a class="threejs_center" href="/manual/examples/cameras-perspective-2-scenes.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  251. </div>
  252. <p></p>
  253. <p>左側はオリジナルのビュー、右側はカメラの錐台を表示するビューがあります。
  254. マウスで <code class="notranslate" translate="no">near</code>、<code class="notranslate" translate="no">far</code>、<code class="notranslate" translate="no">fov</code> を調整してカメラを動かすと、右側に表示されている錐台の内側だけが左側のシーンに表示されています。</p>
  255. <p><code class="notranslate" translate="no">near</code> を20くらいに調整すると、錐台に入らずオブジェクトの正面が消えます。
  256. <code class="notranslate" translate="no">far</code> を35以下に調整すると、錐台に入らず地上の平面が消えていきます。</p>
  257. <p>ここで疑問が湧いてきました。
  258. <code class="notranslate" translate="no">near</code> を0.0000000001に <code class="notranslate" translate="no">far</code> を10000000000000に設定し、全てを見えるようにできないでしょうか?
  259. なぜなら、GPUは何かが前後にあるかを判断する精度が高いからです。
  260. その精度は <code class="notranslate" translate="no">near</code> と <code class="notranslate" translate="no">far</code> の間に分散しています。
  261. さらに悪い事にデフォルトではカメラの近くの精度は細かく、カメラから遠い精度は粗くなっています。
  262. 単位の値は <code class="notranslate" translate="no">near</code> から始まり、<code class="notranslate" translate="no">far</code> に近づくにつれて徐々に拡大していきます。</p>
  263. <p>上記のサンプルから始めて、20個の球体を1列に挿入するコードに変更してみましょう。</p>
  264. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  265. const sphereRadius = 3;
  266. const sphereWidthDivisions = 32;
  267. const sphereHeightDivisions = 16;
  268. const sphereGeo = new THREE.SphereGeometry(sphereRadius, sphereWidthDivisions, sphereHeightDivisions);
  269. const numSpheres = 20;
  270. for (let i = 0; i &lt; numSpheres; ++i) {
  271. const sphereMat = new THREE.MeshPhongMaterial();
  272. sphereMat.color.setHSL(i * .73, 1, 0.5);
  273. const mesh = new THREE.Mesh(sphereGeo, sphereMat);
  274. mesh.position.set(-sphereRadius - 1, sphereRadius + 2, i * sphereRadius * -2.2);
  275. scene.add(mesh);
  276. }
  277. }
  278. </pre>
  279. <p><code class="notranslate" translate="no">near</code> を0.00001に設定してみましょう。</p>
  280. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const fov = 45;
  281. const aspect = 2; // the canvas default
  282. -const near = 0.1;
  283. +const near = 0.00001;
  284. const far = 100;
  285. const camera = new THREE.PerspectiveCamera(fov, aspect, near, far);
  286. </pre>
  287. <p>値の編集時に0.00001を許容するようにGUIコードを微調整します。</p>
  288. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-gui.add(minMaxGUIHelper, 'min', 0.1, 50, 0.1).name('near').onChange(updateCamera);
  289. +gui.add(minMaxGUIHelper, 'min', 0.00001, 50, 0.00001).name('near').onChange(updateCamera);
  290. </pre>
  291. <p>何が起こると思いますか?</p>
  292. <p></p><div translate="no" class="threejs_example_container notranslate">
  293. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-z-fighting.html"></iframe></div>
  294. <a class="threejs_center" href="/manual/examples/cameras-z-fighting.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  295. </div>
  296. <p></p>
  297. <p>これはGPUがどのピクセルが前後にあるか判断する精度が不足してる時に <em>Zファイティング</em> が発生する例です。</p>
  298. <p>あなたのマシンでは問題が表示されない可能性がありますが、私のマシンでは以下のように表示されます。</p>
  299. <div class="threejs_center"><img src="../resources/images/z-fighting.png" style="width: 570px;"></div>
  300. <p>1つ目の解決策はどのピクセルが前後にあるかを計算するために、three.jsの別メソッドを使用します。
  301. これは <a href="/docs/#api/ja/renderers/WebGLRenderer"><code class="notranslate" translate="no">WebGLRenderer</code></a> の作成時に <code class="notranslate" translate="no">logarithmicDepthBuffer</code> を有効にします。</p>
  302. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-const renderer = new THREE.WebGLRenderer({canvas});
  303. +const renderer = new THREE.WebGLRenderer({
  304. + canvas,
  305. + logarithmicDepthBuffer: true,
  306. +});
  307. </pre>
  308. <p>これで上手く動くかもしれません。</p>
  309. <p></p><div translate="no" class="threejs_example_container notranslate">
  310. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-logarithmic-depth-buffer.html"></iframe></div>
  311. <a class="threejs_center" href="/manual/examples/cameras-logarithmic-depth-buffer.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  312. </div>
  313. <p></p>
  314. <p>これで問題が解決しない場合、この解決策が使えない理由の1つに遭遇した事になります。
  315. その理由は、特定のGPUのみをサポートしているためです。
  316. 2018年9月現在、ほとんどのデスクトップがこの解決策をサポートしていますが、モバイルデバイスはほとんどサポートしていません。</p>
  317. <p>この解決策を選択しないもう1つの理由は、標準的な解決策よりも大幅に遅くなる可能性があります。</p>
  318. <p>この解決策は解像度に制限があります。
  319. <code class="notranslate" translate="no">near</code> をさらに小さくしたり <code class="notranslate" translate="no">far</code> をさらに大きくしたりすると最終的に同じ問題にぶつかります。</p>
  320. <p><code class="notranslate" translate="no">near</code> と <code class="notranslate" translate="no">far</code> の設定は、常にユースケースに合った値を選択して下さい。
  321. <code class="notranslate" translate="no">near</code> はカメラからできるだけ離れた所に置き、オブジェクトが消えないようにしましょう。
  322. <code class="notranslate" translate="no">far</code> はカメラからできるだけ近い所に置き、オブジェクトが消えないようにしましょう。</p>
  323. <p>もしまつげを見れるぐらい誰かの顔をクローズアップし、背景には50キロ離れた山までの道のりを見る巨大なシーンを描画したい場合、他の創造的な解決策を見つける必要があるでしょう。
  324. この解決策は後にしましょう。
  325. とりあえず自分のニーズに合わせて <code class="notranslate" translate="no">near</code> と <code class="notranslate" translate="no">far</code> は適切な値を選択しましょう。</p>
  326. <p>2番目に一般的なカメラは <code class="notranslate" translate="no">OrthographicCamera(平行投影カメラ)</code> です。
  327. 錐台を指定するのではなく、<code class="notranslate" translate="no">left</code>、<code class="notranslate" translate="no">right</code>、<code class="notranslate" translate="no">top</code>、<code class="notranslate" translate="no">bottom</code>、<code class="notranslate" translate="no">near</code>、<code class="notranslate" translate="no">far</code> の設定でボックスを指定します。
  328. ボックスを投影しているので遠近感はありません。</p>
  329. <p>上記のview1とview2のサンプルを変更し、最初のビューで <a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> を使うようにしましょう。</p>
  330. <p>最初に <a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> を設定します。</p>
  331. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const left = -1;
  332. const right = 1;
  333. const top = 1;
  334. const bottom = -1;
  335. const near = 5;
  336. const far = 50;
  337. const camera = new THREE.OrthographicCamera(left, right, top, bottom, near, far);
  338. camera.zoom = 0.2;
  339. </pre>
  340. <p><code class="notranslate" translate="no">left</code> と <code class="notranslate" translate="no">bottom</code> を-1、<code class="notranslate" translate="no">right</code> と <code class="notranslate" translate="no">top</code> を1にしました。
  341. これで箱の幅が2、高さが2になりますが、描画している矩形のアスペクト比で <code class="notranslate" translate="no">left</code> と <code class="notranslate" translate="no">top</code> を調整します。
  342. <code class="notranslate" translate="no">zoom</code> プロパティでカメラで実際に表示される値を簡単に調整できます。</p>
  343. <p>GUIに <code class="notranslate" translate="no">zoom</code> の設定を追加してみましょう。</p>
  344. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const gui = new GUI();
  345. +gui.add(camera, 'zoom', 0.01, 1, 0.01).listen();
  346. </pre>
  347. <p><code class="notranslate" translate="no">listen</code> 呼び出しはlil-guiに変更を監視するようにします。
  348. これは <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> がズームも制御できるからです。
  349. 例えばマウスのスクロールホイールは <a href="/docs/#examples/controls/OrbitControls"><code class="notranslate" translate="no">OrbitControls</code></a> でズームします。</p>
  350. <p>最後に左側をレンダリングする部分を変更して <a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> を更新します。</p>
  351. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">{
  352. const aspect = setScissorForElement(view1Elem);
  353. // update the camera for this aspect
  354. - camera.aspect = aspect;
  355. + camera.left = -aspect;
  356. + camera.right = aspect;
  357. camera.updateProjectionMatrix();
  358. cameraHelper.update();
  359. // don't draw the camera helper in the original view
  360. cameraHelper.visible = false;
  361. scene.background.set(0x000000);
  362. renderer.render(scene, camera);
  363. }
  364. </pre>
  365. <p>これで <a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> が動作しているのが見れるようになりました。</p>
  366. <p></p><div translate="no" class="threejs_example_container notranslate">
  367. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-orthographic-2-scenes.html"></iframe></div>
  368. <a class="threejs_center" href="/manual/examples/cameras-orthographic-2-scenes.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  369. </div>
  370. <p></p>
  371. <p>three.jsで2次元のものを描画する場合には、<a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> が最もよく使われます。
  372. カメラの表示台数を決める必要があります。
  373. 例えば、1ピクセルのキャンバスをカメラの1単位と一致させたい場合、次のような事ができます。</p>
  374. <p>原点を中心に置き、1ピクセル = three.jsの1単位とするには次のようにします。</p>
  375. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">camera.left = -canvas.width / 2;
  376. camera.right = canvas.width / 2;
  377. camera.top = canvas.height / 2;
  378. camera.bottom = -canvas.height / 2;
  379. camera.near = -1;
  380. camera.far = 1;
  381. camera.zoom = 1;
  382. </pre>
  383. <p>原点を2Dキャンバスのように左上に配置したい場合は、次のようにします。</p>
  384. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">camera.left = 0;
  385. camera.right = canvas.width;
  386. camera.top = 0;
  387. camera.bottom = canvas.height;
  388. camera.near = -1;
  389. camera.far = 1;
  390. camera.zoom = 1;
  391. </pre>
  392. <p>この場合、左上の角は2Dキャンバスのように0, 0になります。</p>
  393. <p>やってみましょう!まずはカメラの設定をします。</p>
  394. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const left = 0;
  395. const right = 300; // default canvas size
  396. const top = 0;
  397. const bottom = 150; // default canvas size
  398. const near = -1;
  399. const far = 1;
  400. const camera = new THREE.OrthographicCamera(left, right, top, bottom, near, far);
  401. camera.zoom = 1;
  402. </pre>
  403. <p>続いて、6枚のテクスチャをロードし、6枚の平面を作ってみましょう。
  404. 各平面は <a href="/docs/#api/ja/core/Object3D"><code class="notranslate" translate="no">THREE.Object3D</code></a> を親にし、平面の中心を左上にして簡単にオフセットできるようにします。</p>
  405. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const loader = new THREE.TextureLoader();
  406. const textures = [
  407. loader.load('resources/images/flower-1.jpg'),
  408. loader.load('resources/images/flower-2.jpg'),
  409. loader.load('resources/images/flower-3.jpg'),
  410. loader.load('resources/images/flower-4.jpg'),
  411. loader.load('resources/images/flower-5.jpg'),
  412. loader.load('resources/images/flower-6.jpg'),
  413. ];
  414. const planeSize = 256;
  415. const planeGeo = new THREE.PlaneGeometry(planeSize, planeSize);
  416. const planes = textures.map((texture) =&gt; {
  417. const planePivot = new THREE.Object3D();
  418. scene.add(planePivot);
  419. texture.magFilter = THREE.NearestFilter;
  420. const planeMat = new THREE.MeshBasicMaterial({
  421. map: texture,
  422. side: THREE.DoubleSide,
  423. });
  424. const mesh = new THREE.Mesh(planeGeo, planeMat);
  425. planePivot.add(mesh);
  426. // move plane so top left corner is origin
  427. mesh.position.set(planeSize / 2, planeSize / 2, 0);
  428. return planePivot;
  429. });
  430. </pre>
  431. <p>キャンバスサイズの変更時、カメラを更新する必要があります。</p>
  432. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render() {
  433. if (resizeRendererToDisplaySize(renderer)) {
  434. camera.right = canvas.width;
  435. camera.bottom = canvas.height;
  436. camera.updateProjectionMatrix();
  437. }
  438. ...
  439. </pre>
  440. <p><code class="notranslate" translate="no">planes</code> は <a href="/docs/#api/ja/objects/Mesh"><code class="notranslate" translate="no">THREE.Mesh</code></a> の配列であり、各平面に1つずつあります。
  441. これらを時間に応じて移動させてみましょう。</p>
  442. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function render(time) {
  443. time *= 0.001; // convert to seconds;
  444. ...
  445. const distAcross = Math.max(20, canvas.width - planeSize);
  446. const distDown = Math.max(20, canvas.height - planeSize);
  447. // total distance to move across and back
  448. const xRange = distAcross * 2;
  449. const yRange = distDown * 2;
  450. const speed = 180;
  451. planes.forEach((plane, ndx) =&gt; {
  452. // compute a unique time for each plane
  453. const t = time * speed + ndx * 300;
  454. // get a value between 0 and range
  455. const xt = t % xRange;
  456. const yt = t % yRange;
  457. // set our position going forward if 0 to half of range
  458. // and backward if half of range to range
  459. const x = xt &lt; distAcross ? xt : xRange - xt;
  460. const y = yt &lt; distDown ? yt : yRange - yt;
  461. plane.position.set(x, y, 0);
  462. });
  463. renderer.render(scene, camera);
  464. </pre>
  465. <p>2Dキャンバスのようにピクセル計算を使い、画像がキャンバスの縁からピクセルのように跳ね返っているのが分かります。</p>
  466. <p></p><div translate="no" class="threejs_example_container notranslate">
  467. <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/cameras-orthographic-canvas-top-left-origin.html"></iframe></div>
  468. <a class="threejs_center" href="/manual/examples/cameras-orthographic-canvas-top-left-origin.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
  469. </div>
  470. <p></p>
  471. <p><a href="/docs/#api/ja/cameras/OrthographicCamera"><code class="notranslate" translate="no">OrthographicCamera</code></a> のもう1つの一般的な用途は3Dモデリングツールやゲームエンジンで、上、下、左、右、正面、背面のビューを描画する場合です。</p>
  472. <div class="threejs_center"><img src="../resources/images/quad-viewport.png" style="width: 574px;"></div>
  473. <p>上記のスクリーンショットでは右上のビューが透視投影図、左上のビューが平行投影図です。</p>
  474. <p>それがカメラの基本です。
  475. カメラを動かすための一般的な方法は別の記事で紹介します。
  476. とりあえず<a href="shadows.html">影</a>についてのページに移りましょう。</p>
  477. <p><canvas id="c"></canvas></p>
  478. <script type="module" src="../resources/threejs-cameras.js"></script>
  479. </div>
  480. </div>
  481. </div>
  482. <script src="/manual/resources/prettify.js"></script>
  483. <script src="/manual/resources/lesson.js"></script>
  484. </body></html>