webgl_instancing_performance.html 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>three.js webgl - instancing - performance</title>
  5. <meta charset="utf-8">
  6. <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
  7. <link type="text/css" rel="stylesheet" href="main.css">
  8. <style>
  9. #info {
  10. background-color: rgba(0,0,0,0.75);
  11. }
  12. .lil-gui .gui-stats {
  13. line-height: var(--widget-height);
  14. padding: var(--padding);
  15. }
  16. </style>
  17. </head>
  18. <body>
  19. <div id="info">
  20. <a href="https://threejs.org" target="_blank" rel="noopener">three.js</a> webgl - instancing - performance
  21. </div>
  22. <div id="container"></div>
  23. <script type="importmap">
  24. {
  25. "imports": {
  26. "three": "../build/three.module.js",
  27. "three/addons/": "./jsm/"
  28. }
  29. }
  30. </script>
  31. <script type="module">
  32. import * as THREE from 'three';
  33. import Stats from 'three/addons/libs/stats.module.js';
  34. import { GUI } from 'three/addons/libs/lil-gui.module.min.js';
  35. import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
  36. import * as BufferGeometryUtils from 'three/addons/utils/BufferGeometryUtils.js';
  37. let container, stats, gui, guiStatsEl;
  38. let camera, controls, scene, renderer, material;
  39. // gui
  40. const Method = {
  41. INSTANCED: 'INSTANCED',
  42. MERGED: 'MERGED',
  43. NAIVE: 'NAIVE'
  44. };
  45. const api = {
  46. method: Method.INSTANCED,
  47. count: 1000
  48. };
  49. //
  50. init();
  51. initMesh();
  52. animate();
  53. //
  54. function clean() {
  55. const meshes = [];
  56. scene.traverse( function ( object ) {
  57. if ( object.isMesh ) meshes.push( object );
  58. } );
  59. for ( let i = 0; i < meshes.length; i ++ ) {
  60. const mesh = meshes[ i ];
  61. mesh.material.dispose();
  62. mesh.geometry.dispose();
  63. scene.remove( mesh );
  64. }
  65. }
  66. const randomizeMatrix = function () {
  67. const position = new THREE.Vector3();
  68. const quaternion = new THREE.Quaternion();
  69. const scale = new THREE.Vector3();
  70. return function ( matrix ) {
  71. position.x = Math.random() * 40 - 20;
  72. position.y = Math.random() * 40 - 20;
  73. position.z = Math.random() * 40 - 20;
  74. quaternion.random();
  75. scale.x = scale.y = scale.z = Math.random() * 1;
  76. matrix.compose( position, quaternion, scale );
  77. };
  78. }();
  79. function initMesh() {
  80. clean();
  81. // make instances
  82. new THREE.BufferGeometryLoader()
  83. .setPath( 'models/json/' )
  84. .load( 'suzanne_buffergeometry.json', function ( geometry ) {
  85. material = new THREE.MeshNormalMaterial();
  86. geometry.computeVertexNormals();
  87. console.time( api.method + ' (build)' );
  88. switch ( api.method ) {
  89. case Method.INSTANCED:
  90. makeInstanced( geometry );
  91. break;
  92. case Method.MERGED:
  93. makeMerged( geometry );
  94. break;
  95. case Method.NAIVE:
  96. makeNaive( geometry );
  97. break;
  98. }
  99. console.timeEnd( api.method + ' (build)' );
  100. } );
  101. }
  102. function makeInstanced( geometry ) {
  103. const matrix = new THREE.Matrix4();
  104. const mesh = new THREE.InstancedMesh( geometry, material, api.count );
  105. for ( let i = 0; i < api.count; i ++ ) {
  106. randomizeMatrix( matrix );
  107. mesh.setMatrixAt( i, matrix );
  108. }
  109. scene.add( mesh );
  110. //
  111. const geometryByteLength = getGeometryByteLength( geometry );
  112. guiStatsEl.innerHTML = [
  113. '<i>GPU draw calls</i>: 1',
  114. '<i>GPU memory</i>: ' + formatBytes( api.count * 16 + geometryByteLength, 2 )
  115. ].join( '<br/>' );
  116. }
  117. function makeMerged( geometry ) {
  118. const geometries = [];
  119. const matrix = new THREE.Matrix4();
  120. for ( let i = 0; i < api.count; i ++ ) {
  121. randomizeMatrix( matrix );
  122. const instanceGeometry = geometry.clone();
  123. instanceGeometry.applyMatrix4( matrix );
  124. geometries.push( instanceGeometry );
  125. }
  126. const mergedGeometry = BufferGeometryUtils.mergeGeometries( geometries );
  127. scene.add( new THREE.Mesh( mergedGeometry, material ) );
  128. //
  129. guiStatsEl.innerHTML = [
  130. '<i>GPU draw calls</i>: 1',
  131. '<i>GPU memory</i>: ' + formatBytes( getGeometryByteLength( mergedGeometry ), 2 )
  132. ].join( '<br/>' );
  133. }
  134. function makeNaive( geometry ) {
  135. const matrix = new THREE.Matrix4();
  136. for ( let i = 0; i < api.count; i ++ ) {
  137. randomizeMatrix( matrix );
  138. const mesh = new THREE.Mesh( geometry, material );
  139. mesh.applyMatrix4( matrix );
  140. scene.add( mesh );
  141. }
  142. //
  143. const geometryByteLength = getGeometryByteLength( geometry );
  144. guiStatsEl.innerHTML = [
  145. '<i>GPU draw calls</i>: ' + api.count,
  146. '<i>GPU memory</i>: ' + formatBytes( api.count * 16 + geometryByteLength, 2 )
  147. ].join( '<br/>' );
  148. }
  149. function init() {
  150. const width = window.innerWidth;
  151. const height = window.innerHeight;
  152. // camera
  153. camera = new THREE.PerspectiveCamera( 70, width / height, 1, 100 );
  154. camera.position.z = 30;
  155. // renderer
  156. renderer = new THREE.WebGLRenderer( { antialias: true } );
  157. renderer.setPixelRatio( window.devicePixelRatio );
  158. renderer.setSize( width, height );
  159. container = document.getElementById( 'container' );
  160. container.appendChild( renderer.domElement );
  161. // scene
  162. scene = new THREE.Scene();
  163. scene.background = new THREE.Color( 0xffffff );
  164. // controls
  165. controls = new OrbitControls( camera, renderer.domElement );
  166. controls.autoRotate = true;
  167. // stats
  168. stats = new Stats();
  169. container.appendChild( stats.dom );
  170. // gui
  171. gui = new GUI();
  172. gui.add( api, 'method', Method ).onChange( initMesh );
  173. gui.add( api, 'count', 1, 10000 ).step( 1 ).onChange( initMesh );
  174. const perfFolder = gui.addFolder( 'Performance' );
  175. guiStatsEl = document.createElement( 'div' );
  176. guiStatsEl.classList.add( 'gui-stats' );
  177. perfFolder.$children.appendChild( guiStatsEl );
  178. perfFolder.open();
  179. // listeners
  180. window.addEventListener( 'resize', onWindowResize );
  181. Object.assign( window, { scene } );
  182. }
  183. //
  184. function onWindowResize() {
  185. const width = window.innerWidth;
  186. const height = window.innerHeight;
  187. camera.aspect = width / height;
  188. camera.updateProjectionMatrix();
  189. renderer.setSize( width, height );
  190. }
  191. function animate() {
  192. requestAnimationFrame( animate );
  193. controls.update();
  194. stats.update();
  195. render();
  196. }
  197. function render() {
  198. renderer.render( scene, camera );
  199. }
  200. //
  201. function getGeometryByteLength( geometry ) {
  202. let total = 0;
  203. if ( geometry.index ) total += geometry.index.array.byteLength;
  204. for ( const name in geometry.attributes ) {
  205. total += geometry.attributes[ name ].array.byteLength;
  206. }
  207. return total;
  208. }
  209. // Source: https://stackoverflow.com/a/18650828/1314762
  210. function formatBytes( bytes, decimals ) {
  211. if ( bytes === 0 ) return '0 bytes';
  212. const k = 1024;
  213. const dm = decimals < 0 ? 0 : decimals;
  214. const sizes = [ 'bytes', 'KB', 'MB' ];
  215. const i = Math.floor( Math.log( bytes ) / Math.log( k ) );
  216. return parseFloat( ( bytes / Math.pow( k, i ) ).toFixed( dm ) ) + ' ' + sizes[ i ];
  217. }
  218. </script>
  219. </body>
  220. </html>