صفحهٔ اصلی گشت‌و‌گذار راهنما
ورود
javascript
/
three.js
mirrorاز https://github.com/tazdij/three.js.git
2
0
انشعاب 0
پرونده‌ها مشکلات 0 ویکی
درخت: r152
شاخه‌ها تگ‌ها
three.js
/
manual
/
ja
/
custom-buffergeometry.html

custom-buffergeometry.html 25 KB
لینک دائمی تاريخچه خام

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392 
  1. <!DOCTYPE html><html lang="ja"><head>
    2. 

  2.     <meta charset="utf-8">
    3. 

  3.     <title>のカスタムバッファジオメトリ</title>
    4. 

  4.     <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    5. 

  5.     <meta name="twitter:card" content="summary_large_image">
    6. 

  6.     <meta name="twitter:site" content="@threejs">
    7. 

  7.     <meta name="twitter:title" content="Three.js – のカスタムバッファジオメトリ">
    8. 

  8.     <meta property="og:image" content="https://threejs.org/files/share.png">
    9. 

  9.     <link rel="shortcut icon" href="../../files/favicon_white.ico" media="(prefers-color-scheme: dark)">
    10. 

  10.     <link rel="shortcut icon" href="../../files/favicon.ico" media="(prefers-color-scheme: light)">
    11. 

  11. 

  12.     <link rel="stylesheet" href="../resources/lesson.css">
    13. 

  13.     <link rel="stylesheet" href="../resources/lang.css">
    14. 

  14. <!-- Import maps polyfill -->
    15. 

  15. <!-- Remove this when import maps will be widely supported -->
    16. 

  16. <script async src="https://unpkg.com/[email protected]/dist/es-module-shims.js"></script>
    17. 

  17. 

  18. <script type="importmap">
    19. 

  19. {
    20. 

  20.   "imports": {
    21. 

  21.     "three": "../../build/three.module.js"
    22. 

  22.   }
    23. 

  23. }
    24. 

  24. </script>
    25. 

  25.   </head>
    26. 

  26.   <body>
    27. 

  27.     <div class="container">
    28. 

  28.       <div class="lesson-title">
    29. 

  29.         <h1>のカスタムバッファジオメトリ</h1>
    30. 

  30.       </div>
    31. 

  31.       <div class="lesson">
    32. 

  32.         <div class="lesson-main">
    33. 

  33.           <p><a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>は全てのジオメトリを表現する方法です。
    34. 

  34. BufferGeometryは<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>を使います。１つの<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>はジオメトリを作るための１種類のデータに対応しています。vertexの位置情報を格納するための<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>、color情報を格納するための<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>、normal情報を格納するための<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>がそれぞれあります。</p>
    35. 

  35. <div class="threejs_center"><img src="../resources/threejs-attributes.svg" style="width: 700px"></div>
    36. 

  36. 

  37. <p>上の図では<code class="notranslate" translate="no">position</code>, <code class="notranslate" translate="no">normal</code>, <code class="notranslate" translate="no">color</code>, <code class="notranslate" translate="no">uv</code>それぞれのattribute情報を格納した<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>を表しています。これらは<em>並列な配列</em>です。<em>並列な配列</em>というのはN番目にあるデータはN番目のvertexに対応しており、それがattributeの数だけあるという意味です。図ではindex=4のattributeがハイライトされています。</p>
    38. 

  38. <div class="threejs_center"><img src="../resources/cube-faces-vertex.svg" style="width: 500px"></div>
    39. 

  39. 

  40. <p>上の図のハイライトされたvertexには、このvertexに接する全ての面に異なるnormalが必要です。normalとはどの方向を向いているかの情報です。
    41. 

  41. この図ではnormalは角の頂点の周りの矢印で示されており、その頂点に接する全ての面には異なる方向を指すnormalが必要です。</p>
    42. 

  42. <p>同様に面ごとに違うUVも必要です。
    43. 

  43. UVはテクスチャのどの部分に頂点位置が対応しているか指定するテクスチャ座標です。
    44. 

  44. 緑の面はFテクスチャの右上に対応するUV、青い面は左上に対応するUV、赤の面は左下に対応したUVが必要な事が分かります。</p>
    45. 

  45. <p>単一のvertexはこれらの情報の合成として表現されます。
    46. 

  46. 頂点が異なる部分を必要とする場合、それは異なる頂点でなければなりません。</p>
    47. 

  47. <p>簡単な例として<a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>を使って立方体を作ってみましょう。立方体を例にするのはvertexがfaceによって共有されているように見えて実は共有されていないからです。この例ではまずすべてのvertexの情報をリストアップして並列の配列に変換して<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>を作り、最後に<a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>を作ります。</p>
    48. 

  48. <p>立方体に必要な情報をすべてリストアップします。<code class="notranslate" translate="no">Geometry</code>では１つのvertexを複数のfaceで共有できましたが今回は共有できないことに注意してください。つまり１つの立方体を作るために３６個のvertexが必要になります。１つの面につき２つの三角形、１つの三角形につき３つのvertex、これが６面あるので３６個のvertexが必要になる計算です。</p>
    49. 

  49. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const vertices = [
    50. 

  50.   // front
    51. 

  51.   { pos: [-1, -1,  1], norm: [ 0,  0,  1], uv: [0, 0], },
    52. 

  52.   { pos: [ 1, -1,  1], norm: [ 0,  0,  1], uv: [1, 0], },
    53. 

  53.   { pos: [-1,  1,  1], norm: [ 0,  0,  1], uv: [0, 1], },
    54. 

  54. 

  55.   { pos: [-1,  1,  1], norm: [ 0,  0,  1], uv: [0, 1], },
    56. 

  56.   { pos: [ 1, -1,  1], norm: [ 0,  0,  1], uv: [1, 0], },
    57. 

  57.   { pos: [ 1,  1,  1], norm: [ 0,  0,  1], uv: [1, 1], },
    58. 

  58.   // right
    59. 

  59.   { pos: [ 1, -1,  1], norm: [ 1,  0,  0], uv: [0, 0], },
    60. 

  60.   { pos: [ 1, -1, -1], norm: [ 1,  0,  0], uv: [1, 0], },
    61. 

  61.   { pos: [ 1,  1,  1], norm: [ 1,  0,  0], uv: [0, 1], },
    62. 

  62. 

  63.   { pos: [ 1,  1,  1], norm: [ 1,  0,  0], uv: [0, 1], },
    64. 

  64.   { pos: [ 1, -1, -1], norm: [ 1,  0,  0], uv: [1, 0], },
    65. 

  65.   { pos: [ 1,  1, -1], norm: [ 1,  0,  0], uv: [1, 1], },
    66. 

  66.   // back
    67. 

  67.   { pos: [ 1, -1, -1], norm: [ 0,  0, -1], uv: [0, 0], },
    68. 

  68.   { pos: [-1, -1, -1], norm: [ 0,  0, -1], uv: [1, 0], },
    69. 

  69.   { pos: [ 1,  1, -1], norm: [ 0,  0, -1], uv: [0, 1], },
    70. 

  70. 

  71.   { pos: [ 1,  1, -1], norm: [ 0,  0, -1], uv: [0, 1], },
    72. 

  72.   { pos: [-1, -1, -1], norm: [ 0,  0, -1], uv: [1, 0], },
    73. 

  73.   { pos: [-1,  1, -1], norm: [ 0,  0, -1], uv: [1, 1], },
    74. 

  74.   // left
    75. 

  75.   { pos: [-1, -1, -1], norm: [-1,  0,  0], uv: [0, 0], },
    76. 

  76.   { pos: [-1, -1,  1], norm: [-1,  0,  0], uv: [1, 0], },
    77. 

  77.   { pos: [-1,  1, -1], norm: [-1,  0,  0], uv: [0, 1], },
    78. 

  78. 

  79.   { pos: [-1,  1, -1], norm: [-1,  0,  0], uv: [0, 1], },
    80. 

  80.   { pos: [-1, -1,  1], norm: [-1,  0,  0], uv: [1, 0], },
    81. 

  81.   { pos: [-1,  1,  1], norm: [-1,  0,  0], uv: [1, 1], },
    82. 

  82.   // top
    83. 

  83.   { pos: [ 1,  1, -1], norm: [ 0,  1,  0], uv: [0, 0], },
    84. 

  84.   { pos: [-1,  1, -1], norm: [ 0,  1,  0], uv: [1, 0], },
    85. 

  85.   { pos: [ 1,  1,  1], norm: [ 0,  1,  0], uv: [0, 1], },
    86. 

  86. 

  87.   { pos: [ 1,  1,  1], norm: [ 0,  1,  0], uv: [0, 1], },
    88. 

  88.   { pos: [-1,  1, -1], norm: [ 0,  1,  0], uv: [1, 0], },
    89. 

  89.   { pos: [-1,  1,  1], norm: [ 0,  1,  0], uv: [1, 1], },
    90. 

  90.   // bottom
    91. 

  91.   { pos: [ 1, -1,  1], norm: [ 0, -1,  0], uv: [0, 0], },
    92. 

  92.   { pos: [-1, -1,  1], norm: [ 0, -1,  0], uv: [1, 0], },
    93. 

  93.   { pos: [ 1, -1, -1], norm: [ 0, -1,  0], uv: [0, 1], },
    94. 

  94. 

  95.   { pos: [ 1, -1, -1], norm: [ 0, -1,  0], uv: [0, 1], },
    96. 

  96.   { pos: [-1, -1,  1], norm: [ 0, -1,  0], uv: [1, 0], },
    97. 

  97.   { pos: [-1, -1, -1], norm: [ 0, -1,  0], uv: [1, 1], },
    98. 

  98. ];
    99. 

  99. </pre>
    100. 

  100. <p>次にこれを３つの並列な配列に変換します。
    101. 

  101. （訳註：並列な配列<em>parallel arrays</em>とは例えば頂点を指定する配列と色を指定する配列があり１つの頂点をレンダリングするために２つの配列の同じインデックスの要素を指定するような使われ方をする配列のことです。次の例ではpositions, normals, uvsの３つの配列が並列の配列として使われています）</p>
    102. 

  102. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const positions = [];
    103. 

  103. const normals = [];
    104. 

  104. const uvs = [];
    105. 

  105. for (const vertex of vertices) {
    106. 

  106.   positions.push(...vertex.pos);
    107. 

  107.   normals.push(...vertex.norm);
    108. 

  108.   uvs.push(...vertex.uv);
    109. 

  109. }
    110. 

  110. </pre>
    111. 

  111. <p>最後にそれぞれの配列に対して<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>を作り<a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>に指定します。</p>
    112. 

  112. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">  const geometry = new THREE.BufferGeometry();
    113. 

  113.   const positionNumComponents = 3;
    114. 

  114.   const normalNumComponents = 3;
    115. 

  115.   const uvNumComponents = 2;
    116. 

  116.   geometry.setAttribute(
    117. 

  117.       'position',
    118. 

  118.       new THREE.BufferAttribute(new Float32Array(positions), positionNumComponents));
    119. 

  119.   geometry.setAttribute(
    120. 

  120.       'normal',
    121. 

  121.       new THREE.BufferAttribute(new Float32Array(normals), normalNumComponents));
    122. 

  122.   geometry.setAttribute(
    123. 

  123.       'uv',
    124. 

  124.       new THREE.BufferAttribute(new Float32Array(uvs), uvNumComponents));
    125. 

  125. </pre>
    126. 

  126. <p>名前の付け方に注意してください。three.jsで決められている名前以外を指定することはできません（カスタムシェーダーを使用する場合は別です）。<code class="notranslate" translate="no">position</code>, <code class="notranslate" translate="no">normal</code>, <code class="notranslate" translate="no">uv</code>はthree.jsで決められている名前です。ここでは指定していませんが<code class="notranslate" translate="no">color</code>も指定可能です。</p>
    127. 

  127. <p>上の例では<code class="notranslate" translate="no">positions</code>, <code class="notranslate" translate="no">normals</code>, <code class="notranslate" translate="no">uvs</code>の３つのJavaScriptのネイティブ配列を作りました。次に<code class="notranslate" translate="no">Float32Array</code>型の<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">TypedArrays</a>に変換します。<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>はネイティブ配列ではなくTypedArrayである必要があります。さらにそれぞれの<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>に対して「１つのvertexに対していくつの要素が必要か」を指定する必要があります。例えばpositionやnormalsは３次元なので１つのvertexつき３つの要素を必要とします。UVはテクスチャ上の２次元の点なので２つの要素を必要とします。</p>
    128. 

  128. <p></p><div translate="no" class="threejs_example_container notranslate">
    129. 

  129.   <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/custom-buffergeometry-cube.html"></iframe></div>
    130. 

  130.   <a class="threejs_center" href="/manual/examples/custom-buffergeometry-cube.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
    131. 

  131. </div>
    132. 

  132. 

  133. <p></p>
    134. 

  134. <p>かなり大量のデータです。この配列からvertexを選ぶときにはインデックスを使います。１つの三角形は３つのvertexで構成されていて２つの三角形が１つのfaceを作っています。これが６枚で１つの立方体を構成しています。１つのfaceを構成する２つの三角形を作っているvertexは２つが同じデータを持っています。position, normal, UVすべて同じです。そこで重複しているデータを１つ消して１つにして、そのデータを別のインデックスで指定します。</p>
    135. 

  135. <p>ではまず重複したデータを１つにします。</p>
    136. 

  136. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const vertices = [
    137. 

  137.   // front
    138. 

  138.   { pos: [-1, -1,  1], norm: [ 0,  0,  1], uv: [0, 0], }, // 0
    139. 

  139.   { pos: [ 1, -1,  1], norm: [ 0,  0,  1], uv: [1, 0], }, // 1
    140. 

  140.   { pos: [-1,  1,  1], norm: [ 0,  0,  1], uv: [0, 1], }, // 2
    141. 

  141. -
    142. 

  142. -  { pos: [-1,  1,  1], norm: [ 0,  0,  1], uv: [0, 1], },
    143. 

  143. -  { pos: [ 1, -1,  1], norm: [ 0,  0,  1], uv: [1, 0], },
    144. 

  144.   { pos: [ 1,  1,  1], norm: [ 0,  0,  1], uv: [1, 1], }, // 3
    145. 

  145.   // right
    146. 

  146.   { pos: [ 1, -1,  1], norm: [ 1,  0,  0], uv: [0, 0], }, // 4
    147. 

  147.   { pos: [ 1, -1, -1], norm: [ 1,  0,  0], uv: [1, 0], }, // 5
    148. 

  148. -
    149. 

  149. -  { pos: [ 1,  1,  1], norm: [ 1,  0,  0], uv: [0, 1], },
    150. 

  150. -  { pos: [ 1, -1, -1], norm: [ 1,  0,  0], uv: [1, 0], },
    151. 

  151.   { pos: [ 1,  1,  1], norm: [ 1,  0,  0], uv: [0, 1], }, // 6
    152. 

  152.   { pos: [ 1,  1, -1], norm: [ 1,  0,  0], uv: [1, 1], }, // 7
    153. 

  153.   // back
    154. 

  154.   { pos: [ 1, -1, -1], norm: [ 0,  0, -1], uv: [0, 0], }, // 8
    155. 

  155.   { pos: [-1, -1, -1], norm: [ 0,  0, -1], uv: [1, 0], }, // 9
    156. 

  156. -
    157. 

  157. -  { pos: [ 1,  1, -1], norm: [ 0,  0, -1], uv: [0, 1], },
    158. 

  158. -  { pos: [-1, -1, -1], norm: [ 0,  0, -1], uv: [1, 0], },
    159. 

  159.   { pos: [ 1,  1, -1], norm: [ 0,  0, -1], uv: [0, 1], }, // 10
    160. 

  160.   { pos: [-1,  1, -1], norm: [ 0,  0, -1], uv: [1, 1], }, // 11
    161. 

  161.   // left
    162. 

  162.   { pos: [-1, -1, -1], norm: [-1,  0,  0], uv: [0, 0], }, // 12
    163. 

  163.   { pos: [-1, -1,  1], norm: [-1,  0,  0], uv: [1, 0], }, // 13
    164. 

  164. -
    165. 

  165. -  { pos: [-1,  1, -1], norm: [-1,  0,  0], uv: [0, 1], },
    166. 

  166. -  { pos: [-1, -1,  1], norm: [-1,  0,  0], uv: [1, 0], },
    167. 

  167.   { pos: [-1,  1, -1], norm: [-1,  0,  0], uv: [0, 1], }, // 14
    168. 

  168.   { pos: [-1,  1,  1], norm: [-1,  0,  0], uv: [1, 1], }, // 15
    169. 

  169.   // top
    170. 

  170.   { pos: [ 1,  1, -1], norm: [ 0,  1,  0], uv: [0, 0], }, // 16
    171. 

  171.   { pos: [-1,  1, -1], norm: [ 0,  1,  0], uv: [1, 0], }, // 17
    172. 

  172. -
    173. 

  173. -  { pos: [ 1,  1,  1], norm: [ 0,  1,  0], uv: [0, 1], },
    174. 

  174. -  { pos: [-1,  1, -1], norm: [ 0,  1,  0], uv: [1, 0], },
    175. 

  175.   { pos: [ 1,  1,  1], norm: [ 0,  1,  0], uv: [0, 1], }, // 18
    176. 

  176.   { pos: [-1,  1,  1], norm: [ 0,  1,  0], uv: [1, 1], }, // 19
    177. 

  177.   // bottom
    178. 

  178.   { pos: [ 1, -1,  1], norm: [ 0, -1,  0], uv: [0, 0], }, // 20
    179. 

  179.   { pos: [-1, -1,  1], norm: [ 0, -1,  0], uv: [1, 0], }, // 21
    180. 

  180. -
    181. 

  181. -  { pos: [ 1, -1, -1], norm: [ 0, -1,  0], uv: [0, 1], },
    182. 

  182. -  { pos: [-1, -1,  1], norm: [ 0, -1,  0], uv: [1, 0], },
    183. 

  183.   { pos: [ 1, -1, -1], norm: [ 0, -1,  0], uv: [0, 1], }, // 22
    184. 

  184.   { pos: [-1, -1, -1], norm: [ 0, -1,  0], uv: [1, 1], }, // 23
    185. 

  185. ];
    186. 

  186. </pre>
    187. 

  187. <p>はい、24個になりました。これに対して36個のインデックスを指定して36個のvertexを作ります。<a href="/docs/#api/ja/core/BufferGeometry.setIndex"><code class="notranslate" translate="no">BufferGeometry.setIndex</code></a>により36個のインデックスを使って12個の三角形を作ります。</p>
    188. 

  188. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">geometry.setAttribute(
    189. 

  189.     'position',
    190. 

  190.     new THREE.BufferAttribute(positions, positionNumComponents));
    191. 

  191. geometry.setAttribute(
    192. 

  192.     'normal',
    193. 

  193.     new THREE.BufferAttribute(normals, normalNumComponents));
    194. 

  194. geometry.setAttribute(
    195. 

  195.     'uv',
    196. 

  196.     new THREE.BufferAttribute(uvs, uvNumComponents));
    197. 

  197. 

  198. +geometry.setIndex([
    199. 

  199. +   0,  1,  2,   2,  1,  3,  // front
    200. 

  200. +   4,  5,  6,   6,  5,  7,  // right
    201. 

  201. +   8,  9, 10,  10,  9, 11,  // back
    202. 

  202. +  12, 13, 14,  14, 13, 15,  // left
    203. 

  203. +  16, 17, 18,  18, 17, 19,  // top
    204. 

  204. +  20, 21, 22,  22, 21, 23,  // bottom
    205. 

  205. +]);
    206. 

  206. </pre>
    207. 

  207. <p></p><div translate="no" class="threejs_example_container notranslate">
    208. 

  208.   <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/custom-buffergeometry-cube-indexed.html"></iframe></div>
    209. 

  209.   <a class="threejs_center" href="/manual/examples/custom-buffergeometry-cube-indexed.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
    210. 

  210. </div>
    211. 

  211. 

  212. <p></p>
    213. 

  213. <p><code class="notranslate" translate="no">Geometry</code>と同じように<a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>も<a href="/docs/#api/ja/core/BufferGeometry#computeVertexNormals"><code class="notranslate" translate="no">computeVertexNormals</code></a>メソッドを持っています。これは特に指定がない場合に自動的にnormalを計算するメソッドです。ただし<code class="notranslate" translate="no">Geometry</code>の場合と違いvertexがfaceによって共有されていないために<code class="notranslate" translate="no">computeVertexNormals</code>の結果も少し違います。</p>
    214. 

  214. <div class="spread">
    215. 

  215.   <div>
    216. 

  216.     <div data-diagram="bufferGeometryCylinder"></div>
    217. 

  217.   </div>
    218. 

  218. </div>
    219. 

  219. 

  220. <p>シリンダーで<code class="notranslate" translate="no">computeVertexNormals</code>の違いを比較してみましょう。よく見ると左のシリンダーには縫い目が見えると思います。これはvertexを共有することができないためにUVも異なるためです。ちょっとしたことですが、気になるときは自分でnormalを指定すれば良いだけです。</p>
    221. 

  221. <p>ネイティブの配列を使う代わりに<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">TypedArrays</a>を使うこともできます。TypedArrayは最初に配列の大きさを指定する必要があるため少し面倒です。ネイティブの配列は<code class="notranslate" translate="no">push</code>で追加して<code class="notranslate" translate="no">length</code>で配列の長さを確認することができます。TypedArrayには<code class="notranslate" translate="no">push</code>メソッドがないのであらかじめ用意した配列に注意しながら要素を入れていく必要があります。</p>
    222. 

  222. <p>この例では最初に大きなデータを使っているので配列の長さを意識することはそれほど大変ではありません。</p>
    223. 

  223. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">-const positions = [];
    224. 

  224. -const normals = [];
    225. 

  225. -const uvs = [];
    226. 

  226. +const numVertices = vertices.length;
    227. 

  227. +const positionNumComponents = 3;
    228. 

  228. +const normalNumComponents = 3;
    229. 

  229. +const uvNumComponents = 2;
    230. 

  230. +const positions = new Float32Array(numVertices * positionNumComponents);
    231. 

  231. +const normals = new Float32Array(numVertices * normalNumComponents);
    232. 

  232. +const uvs = new Float32Array(numVertices * uvNumComponents);
    233. 

  233. +let posNdx = 0;
    234. 

  234. +let nrmNdx = 0;
    235. 

  235. +let uvNdx = 0;
    236. 

  236. for (const vertex of vertices) {
    237. 

  237. -  positions.push(...vertex.pos);
    238. 

  238. -  normals.push(...vertex.norm);
    239. 

  239. -  uvs.push(...vertex.uv);
    240. 

  240. +  positions.set(vertex.pos, posNdx);
    241. 

  241. +  normals.set(vertex.norm, nrmNdx);
    242. 

  242. +  uvs.set(vertex.uv, uvNdx);
    243. 

  243. +  posNdx += positionNumComponents;
    244. 

  244. +  nrmNdx += normalNumComponents;
    245. 

  245. +  uvNdx += uvNumComponents;
    246. 

  246. }
    247. 

  247. 

  248. geometry.setAttribute(
    249. 

  249.     'position',
    250. 

  250. -    new THREE.BufferAttribute(new Float32Array(positions), positionNumComponents));
    251. 

  251. +    new THREE.BufferAttribute(positions, positionNumComponents));
    252. 

  252. geometry.setAttribute(
    253. 

  253.     'normal',
    254. 

  254. -    new THREE.BufferAttribute(new Float32Array(normals), normalNumComponents));
    255. 

  255. +    new THREE.BufferAttribute(normals, normalNumComponents));
    256. 

  256. geometry.setAttribute(
    257. 

  257.     'uv',
    258. 

  258. -    new THREE.BufferAttribute(new Float32Array(uvs), uvNumComponents));
    259. 

  259. +    new THREE.BufferAttribute(uvs, uvNumComponents));
    260. 

  260. 

  261. geometry.setIndex([
    262. 

  262.    0,  1,  2,   2,  1,  3,  // front
    263. 

  263.    4,  5,  6,   6,  5,  7,  // right
    264. 

  264.    8,  9, 10,  10,  9, 11,  // back
    265. 

  265.   12, 13, 14,  14, 13, 15,  // left
    266. 

  266.   16, 17, 18,  18, 17, 19,  // top
    267. 

  267.   20, 21, 22,  22, 21, 23,  // bottom
    268. 

  268. ]);
    269. 

  269. </pre>
    270. 

  270. <p></p><div translate="no" class="threejs_example_container notranslate">
    271. 

  271.   <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/custom-buffergeometry-cube-typedarrays.html"></iframe></div>
    272. 

  272.   <a class="threejs_center" href="/manual/examples/custom-buffergeometry-cube-typedarrays.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
    273. 

  273. </div>
    274. 

  274. 

  275. <p></p>
    276. 

  276. <p>TypedArrayはプログラムが走っている状態でvertexの編集をしたいときに便利です。</p>
    277. 

  277. <p>良い例が思いつかないのでとりあえずメッシュの四角形が出たり入ったりする球体を作ってみます。</p>
    278. 

  278. <p>球体の位置とindexを生成するコードです。四角形の中でvertexを共有していますが四角形と四角形でvertexを共有することはありません。共有してしまうと１つの四角形が出たり入ったりするたびに隣の四角形が移動してしまいます。今回は別々に移動させたいのでそうしています。</p>
    279. 

  279. <p>面倒なので３つの<a href="/docs/#api/ja/core/Object3D"><code class="notranslate" translate="no">Object3D</code></a>階層を用意して球体のvertexを計算します。くわしくは<a href="optimize-lots-of-objects.html">たくさんのオブジェクトを最適化するこの記事</a>をご覧ください。</p>
    280. 

  280. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">function makeSpherePositions(segmentsAround, segmentsDown) {
    281. 

  281.   const numVertices = segmentsAround * segmentsDown * 6;
    282. 

  282.   const numComponents = 3;
    283. 

  283.   const positions = new Float32Array(numVertices * numComponents);
    284. 

  284.   const indices = [];
    285. 

  285. 

  286.   const longHelper = new THREE.Object3D();
    287. 

  287.   const latHelper = new THREE.Object3D();
    288. 

  288.   const pointHelper = new THREE.Object3D();
    289. 

  289.   longHelper.add(latHelper);
    290. 

  290.   latHelper.add(pointHelper);
    291. 

  291.   pointHelper.position.z = 1;
    292. 

  292.   const temp = new THREE.Vector3();
    293. 

  293. 

  294.   function getPoint(lat, long) {
    295. 

  295.     latHelper.rotation.x = lat;
    296. 

  296.     longHelper.rotation.y = long;
    297. 

  297.     longHelper.updateMatrixWorld(true);
    298. 

  298.     return pointHelper.getWorldPosition(temp).toArray();
    299. 

  299.   }
    300. 

  300. 

  301.   let posNdx = 0;
    302. 

  302.   let ndx = 0;
    303. 

  303.   for (let down = 0; down &lt; segmentsDown; ++down) {
    304. 

  304.     const v0 = down / segmentsDown;
    305. 

  305.     const v1 = (down + 1) / segmentsDown;
    306. 

  306.     const lat0 = (v0 - 0.5) * Math.PI;
    307. 

  307.     const lat1 = (v1 - 0.5) * Math.PI;
    308. 

  308. 

  309.     for (let across = 0; across &lt; segmentsAround; ++across) {
    310. 

  310.       const u0 = across / segmentsAround;
    311. 

  311.       const u1 = (across + 1) / segmentsAround;
    312. 

  312.       const long0 = u0 * Math.PI * 2;
    313. 

  313.       const long1 = u1 * Math.PI * 2;
    314. 

  314. 

  315.       positions.set(getPoint(lat0, long0), posNdx);  posNdx += numComponents;
    316. 

  316.       positions.set(getPoint(lat1, long0), posNdx);  posNdx += numComponents;
    317. 

  317.       positions.set(getPoint(lat0, long1), posNdx);  posNdx += numComponents;
    318. 

  318.       positions.set(getPoint(lat1, long1), posNdx);  posNdx += numComponents;
    319. 

  319. 

  320.       indices.push(
    321. 

  321.         ndx, ndx + 1, ndx + 2,
    322. 

  322.         ndx + 2, ndx + 1, ndx + 3,
    323. 

  323.       );
    324. 

  324.       ndx += 4;
    325. 

  325.     }
    326. 

  326.   }
    327. 

  327.   return {positions, indices};
    328. 

  328. }
    329. 

  329. </pre>
    330. 

  330. <p>こんな感じです。</p>
    331. 

  331. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const segmentsAround = 24;
    332. 

  332. const segmentsDown = 16;
    333. 

  333. const {positions, indices} = makeSpherePositions(segmentsAround, segmentsDown);
    334. 

  334. </pre>
    335. 

  335. <p>returnされているpositionは単位球（半径が１の球体）なのでそのままこのデータをnormalに使えます。</p>
    336. 

  336. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const normals = positions.slice();
    337. 

  337. </pre>
    338. 

  338. <p>attributeも設定しましょう。</p>
    339. 

  339. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const geometry = new THREE.BufferGeometry();
    340. 

  340. const positionNumComponents = 3;
    341. 

  341. const normalNumComponents = 3;
    342. 

  342. 

  343. +const positionAttribute = new THREE.BufferAttribute(positions, positionNumComponents);
    344. 

  344. +positionAttribute.setUsage(THREE.DynamicDrawUsage);
    345. 

  345. geometry.setAttribute(
    346. 

  346.     'position',
    347. 

  347. +    positionAttribute);
    348. 

  348. geometry.setAttribute(
    349. 

  349.     'normal',
    350. 

  350.     new THREE.BufferAttribute(normals, normalNumComponents));
    351. 

  351. geometry.setIndex(indices);
    352. 

  352. </pre>
    353. 

  353. <p>position attributeに対する参照を保存しています。dynamicに指定しているところも注意が必要です。これはTHREE.jsに「これからこのattributeは変更が加えられる」ことを教えます。renderループではpositionを毎度アップデートします。</p>
    354. 

  354. <pre class="prettyprint showlinemods notranslate lang-js" translate="no">const temp = new THREE.Vector3();
    355. 

  355. 

  356. ...
    357. 

  357. 

  358. for (let i = 0; i &lt; positions.length; i += 3) {
    359. 

  359.   const quad = (i / 12 | 0);
    360. 

  360.   const ringId = quad / segmentsAround | 0;
    361. 

  361.   const ringQuadId = quad % segmentsAround;
    362. 

  362.   const ringU = ringQuadId / segmentsAround;
    363. 

  363.   const angle = ringU * Math.PI * 2;
    364. 

  364.   temp.fromArray(normals, i);
    365. 

  365.   temp.multiplyScalar(THREE.MathUtils.lerp(1, 1.4, Math.sin(time + ringId + angle) * .5 + .5));
    366. 

  366.   temp.toArray(positions, i);
    367. 

  367. }
    368. 

  368. positionAttribute.needsUpdate = true;
    369. 

  369. </pre>
    370. 

  370. <p>最後に<code class="notranslate" translate="no">positionAttribute.needsUpdate</code>を設定してTHREE.jsに変更が必要であることを伝えます。</p>
    371. 

  371. <p></p><div translate="no" class="threejs_example_container notranslate">
    372. 

  372.   <div><iframe class="threejs_example notranslate" translate="no" style=" " src="/manual/examples/resources/editor.html?url=/manual/examples/custom-buffergeometry-dynamic.html"></iframe></div>
    373. 

  373.   <a class="threejs_center" href="/manual/examples/custom-buffergeometry-dynamic.html" target="_blank">ここをクリックして別のウィンドウで開きます</a>
    374. 

  374. </div>
    375. 

  375. 

  376. <p></p>
    377. 

  377. <p><a href="/docs/#api/ja/core/BufferGeometry"><code class="notranslate" translate="no">BufferGeometry</code></a>を作って<a href="/docs/#api/ja/core/BufferAttribute"><code class="notranslate" translate="no">BufferAttribute</code></a>をアップデートする方法を紹介しました。</p>
    378. 

  378. <p><canvas id="c"></canvas></p>
    379. 

  379. <script type="module" src="../resources/threejs-custom-buffergeometry.js"></script>
    380. 

  380. 

  381. 

  382.         </div>
    383. 

  383.       </div>
    384. 

  384.     </div>
    385. 

  385.   
    386. 

  386.   <script src="../resources/prettify.js"></script>
    387. 

  387.   <script src="../resources/lesson.js"></script>
    388. 

  388. 

  389. 

  390. 

  391. 

  392. </body></html>
    393.