chorama 0.0.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (380) hide show
  1. package/.github/workflows/publish.yml +24 -0
  2. package/.github/workflows/static.yml +22 -53
  3. package/README.md +3 -1
  4. package/assets/models/glb/AlphaBlendModeTest.glb +0 -0
  5. package/assets/models/glb/IridescenceLamp.glb +0 -0
  6. package/assets/models/glb/teapot.glb +0 -0
  7. package/astro.config.mjs +9 -21
  8. package/content/guide/render-targets-and-views.md +3 -4
  9. package/content/guide/textures-and-assets.md +5 -2
  10. package/dist/index.module.js +23334 -0
  11. package/dist/index.module.js.map +1 -0
  12. package/dist/index.umd.js +23610 -0
  13. package/dist/index.umd.js.map +1 -0
  14. package/dist/website/_astro/DocLayout.BsV7p0dY.css +1 -0
  15. package/dist/website/examples/camera/orthographic/example.html +172 -0
  16. package/dist/website/examples/camera/orthographic/index.html +124 -0
  17. package/dist/website/examples/camera/perspective/example.html +190 -0
  18. package/dist/website/examples/camera/perspective/index.html +142 -0
  19. package/dist/website/examples/camera/tone_mapping/example.html +238 -0
  20. package/dist/website/examples/camera/tone_mapping/index.html +190 -0
  21. package/dist/website/examples/index.html +2 -0
  22. package/dist/website/examples/lights/directional/example.html +447 -0
  23. package/dist/website/examples/lights/directional/index.html +399 -0
  24. package/dist/website/examples/lights/multiple_spot_lights/example.html +356 -0
  25. package/dist/website/examples/lights/multiple_spot_lights/index.html +308 -0
  26. package/dist/website/examples/lights/point/example.html +387 -0
  27. package/dist/website/examples/lights/point/index.html +339 -0
  28. package/dist/website/examples/lights/spot/example.html +416 -0
  29. package/dist/website/examples/lights/spot/index.html +368 -0
  30. package/dist/website/examples/loader/gltf/basic/example.html +129 -0
  31. package/dist/website/examples/loader/gltf/basic/index.html +81 -0
  32. package/dist/website/examples/loader/gltf/material/alpha-blend-mode/example.html +131 -0
  33. package/dist/website/examples/loader/gltf/material/alpha-blend-mode/index.html +83 -0
  34. package/dist/website/examples/loader/gltf/material/flight_helmet/example.html +162 -0
  35. package/dist/website/examples/loader/gltf/material/flight_helmet/index.html +114 -0
  36. package/dist/website/examples/loader/gltf/material/iridescence_lamp/example.html +169 -0
  37. package/dist/website/examples/loader/gltf/material/iridescence_lamp/index.html +121 -0
  38. package/dist/website/examples/loader/objloader/example.html +144 -0
  39. package/dist/website/examples/loader/objloader/index.html +96 -0
  40. package/dist/website/examples/material/cullface/example.html +163 -0
  41. package/dist/website/examples/material/cullface/index.html +115 -0
  42. package/dist/website/examples/material/materials/example.html +175 -0
  43. package/dist/website/examples/material/materials/index.html +127 -0
  44. package/dist/website/examples/material/standard/basic/example.html +212 -0
  45. package/dist/website/examples/material/standard/basic/index.html +164 -0
  46. package/dist/website/examples/material/standard/reflection_refraction/example.html +241 -0
  47. package/dist/website/examples/material/standard/reflection_refraction/index.html +193 -0
  48. package/dist/website/examples/mesh/capsule/example.html +173 -0
  49. package/dist/website/examples/mesh/capsule/index.html +125 -0
  50. package/dist/website/examples/mesh/circle/example.html +173 -0
  51. package/dist/website/examples/mesh/circle/index.html +125 -0
  52. package/dist/website/examples/mesh/cone/example.html +180 -0
  53. package/dist/website/examples/mesh/cone/index.html +132 -0
  54. package/dist/website/examples/mesh/cuboid/example.html +207 -0
  55. package/dist/website/examples/mesh/cuboid/index.html +159 -0
  56. package/dist/website/examples/mesh/cylinder/example.html +195 -0
  57. package/dist/website/examples/mesh/cylinder/index.html +147 -0
  58. package/dist/website/examples/mesh/dodecahedron/example.html +158 -0
  59. package/dist/website/examples/mesh/dodecahedron/index.html +110 -0
  60. package/dist/website/examples/mesh/ellipsoid/example.html +179 -0
  61. package/dist/website/examples/mesh/ellipsoid/index.html +131 -0
  62. package/dist/website/examples/mesh/extrude/example.html +169 -0
  63. package/dist/website/examples/mesh/extrude/index.html +121 -0
  64. package/dist/website/examples/mesh/frustum/example.html +185 -0
  65. package/dist/website/examples/mesh/frustum/index.html +137 -0
  66. package/dist/website/examples/mesh/helix/example.html +184 -0
  67. package/dist/website/examples/mesh/helix/index.html +136 -0
  68. package/dist/website/examples/mesh/icosahedron/example.html +158 -0
  69. package/dist/website/examples/mesh/icosahedron/index.html +110 -0
  70. package/dist/website/examples/mesh/icosphere/example.html +163 -0
  71. package/dist/website/examples/mesh/icosphere/index.html +115 -0
  72. package/dist/website/examples/mesh/lathe/example.html +175 -0
  73. package/dist/website/examples/mesh/lathe/index.html +127 -0
  74. package/dist/website/examples/mesh/meshTopology/example.html +210 -0
  75. package/dist/website/examples/mesh/meshTopology/index.html +162 -0
  76. package/dist/website/examples/mesh/octahedron/example.html +158 -0
  77. package/dist/website/examples/mesh/octahedron/index.html +110 -0
  78. package/dist/website/examples/mesh/plane/example.html +173 -0
  79. package/dist/website/examples/mesh/plane/index.html +125 -0
  80. package/dist/website/examples/mesh/prism/example.html +173 -0
  81. package/dist/website/examples/mesh/prism/index.html +125 -0
  82. package/dist/website/examples/mesh/pyramid/example.html +172 -0
  83. package/dist/website/examples/mesh/pyramid/index.html +124 -0
  84. package/dist/website/examples/mesh/ring/example.html +173 -0
  85. package/dist/website/examples/mesh/ring/index.html +125 -0
  86. package/dist/website/examples/mesh/skinning/example.html +187 -0
  87. package/dist/website/examples/mesh/skinning/index.html +139 -0
  88. package/dist/website/examples/mesh/terrain/example.html +214 -0
  89. package/dist/website/examples/mesh/terrain/index.html +166 -0
  90. package/dist/website/examples/mesh/tetrahedron/example.html +158 -0
  91. package/dist/website/examples/mesh/tetrahedron/index.html +110 -0
  92. package/dist/website/examples/mesh/torus/example.html +173 -0
  93. package/dist/website/examples/mesh/torus/index.html +125 -0
  94. package/dist/website/examples/mesh/torus-knot/example.html +188 -0
  95. package/dist/website/examples/mesh/torus-knot/index.html +140 -0
  96. package/dist/website/examples/mesh/tube/example.html +180 -0
  97. package/dist/website/examples/mesh/tube/index.html +132 -0
  98. package/dist/website/examples/mesh/uvsphere/example.html +169 -0
  99. package/dist/website/examples/mesh/uvsphere/index.html +121 -0
  100. package/dist/website/examples/mesh/wedge/example.html +168 -0
  101. package/dist/website/examples/mesh/wedge/index.html +120 -0
  102. package/dist/website/examples/other/rotatingCube/example.html +142 -0
  103. package/dist/website/examples/other/rotatingCube/index.html +94 -0
  104. package/dist/website/examples/other/rotatingSphere/example.html +144 -0
  105. package/dist/website/examples/other/rotatingSphere/index.html +96 -0
  106. package/dist/website/examples/rendertarget/basic_canvas/example.html +178 -0
  107. package/dist/website/examples/rendertarget/basic_canvas/index.html +130 -0
  108. package/dist/website/examples/rendertarget/depth_texture/example.html +188 -0
  109. package/dist/website/examples/rendertarget/depth_texture/index.html +140 -0
  110. package/dist/website/examples/rendertarget/image_target/example.html +196 -0
  111. package/dist/website/examples/rendertarget/image_target/index.html +148 -0
  112. package/dist/website/examples/rendertarget/multiple_views/example.html +204 -0
  113. package/dist/website/examples/rendertarget/multiple_views/index.html +156 -0
  114. package/dist/website/examples/rendertarget/render_masks/example.html +222 -0
  115. package/dist/website/examples/rendertarget/render_masks/index.html +174 -0
  116. package/dist/website/examples/rendertarget/split_screen/example.html +178 -0
  117. package/dist/website/examples/rendertarget/split_screen/index.html +130 -0
  118. package/dist/website/examples/rendertarget/split_view/example.html +191 -0
  119. package/dist/website/examples/rendertarget/split_view/index.html +143 -0
  120. package/dist/website/examples/skybox/skybox/example.html +162 -0
  121. package/dist/website/examples/skybox/skybox/index.html +114 -0
  122. package/dist/website/examples/texture/arrays/example.html +204 -0
  123. package/dist/website/examples/texture/arrays/index.html +156 -0
  124. package/dist/website/examples/texture/textureWrap/example.html +169 -0
  125. package/dist/website/examples/texture/textureWrap/index.html +121 -0
  126. package/dist/website/examples/transform/propagation/example.html +141 -0
  127. package/dist/website/examples/transform/propagation/index.html +93 -0
  128. package/dist/website/guide/api-map/index.html +82 -0
  129. package/dist/website/guide/camera-and-controls/index.html +62 -0
  130. package/dist/website/guide/first-scene/index.html +119 -0
  131. package/dist/website/guide/index.html +58 -0
  132. package/dist/website/guide/installation/index.html +133 -0
  133. package/dist/website/guide/materials-and-lighting/index.html +90 -0
  134. package/dist/website/guide/plugins-and-render-pipeline/index.html +89 -0
  135. package/dist/website/guide/render-targets-and-views/index.html +95 -0
  136. package/dist/website/guide/scene-graph-and-transforms/index.html +69 -0
  137. package/dist/website/guide/textures-and-assets/index.html +85 -0
  138. package/dist/website/guide/troubleshooting/index.html +39 -0
  139. package/dist/website/images/disappointed.jpg +0 -0
  140. package/dist/website/images/skybox/grimmnight_back.png +0 -0
  141. package/dist/website/images/skybox/grimmnight_bottom.png +0 -0
  142. package/dist/website/images/skybox/grimmnight_front.png +0 -0
  143. package/dist/website/images/skybox/grimmnight_left.png +0 -0
  144. package/dist/website/images/skybox/grimmnight_right.png +0 -0
  145. package/dist/website/images/skybox/grimmnight_top.png +0 -0
  146. package/dist/website/images/skybox/miramar_back.png +0 -0
  147. package/dist/website/images/skybox/miramar_bottom.png +0 -0
  148. package/dist/website/images/skybox/miramar_front.png +0 -0
  149. package/dist/website/images/skybox/miramar_left.png +0 -0
  150. package/dist/website/images/skybox/miramar_right.png +0 -0
  151. package/dist/website/images/skybox/miramar_top.png +0 -0
  152. package/dist/website/images/uv.jpg +0 -0
  153. package/dist/website/index.html +157 -0
  154. package/dist/website/models/glb/AlphaBlendModeTest.glb +0 -0
  155. package/dist/website/models/glb/IridescenceLamp.glb +0 -0
  156. package/dist/website/models/glb/teapot.glb +0 -0
  157. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_GlassPlasticMat_BaseColor.png +0 -0
  158. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_GlassPlasticMat_Normal.png +0 -0
  159. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_GlassPlasticMat_OcclusionRoughMetal.png +0 -0
  160. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LeatherPartsMat_BaseColor.png +0 -0
  161. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LeatherPartsMat_Normal.png +0 -0
  162. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LeatherPartsMat_OcclusionRoughMetal.png +0 -0
  163. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LensesMat_BaseColor.png +0 -0
  164. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LensesMat_Normal.png +0 -0
  165. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_LensesMat_OcclusionRoughMetal.png +0 -0
  166. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_MetalPartsMat_BaseColor.png +0 -0
  167. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_MetalPartsMat_Normal.png +0 -0
  168. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_MetalPartsMat_OcclusionRoughMetal.png +0 -0
  169. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_RubberWoodMat_BaseColor.png +0 -0
  170. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_RubberWoodMat_Normal.png +0 -0
  171. package/dist/website/models/gltf/flight_helmet/FlightHelmet_Materials_RubberWoodMat_OcclusionRoughMetal.png +0 -0
  172. package/dist/website/models/gltf/flight_helmet/index.bin +0 -0
  173. package/dist/website/models/gltf/flight_helmet/index.gltf +705 -0
  174. package/dist/website/models/gltf/object.gltf +23 -0
  175. package/dist/website/models/gltf/pirate_girl/index.bin +0 -0
  176. package/dist/website/models/gltf/pirate_girl/index.gltf +2082 -0
  177. package/dist/website/models/obj/pirate_girl/pirate_girl.obj +18459 -0
  178. package/dist/website/models/obj/pirate_girl/pirate_girl.png +0 -0
  179. package/env.d.ts +0 -14
  180. package/examples/camera/orthographic.js +2 -1
  181. package/examples/camera/perspective.js +2 -1
  182. package/examples/camera/tone_mapping.js +187 -0
  183. package/examples/lights/directional.js +2 -3
  184. package/examples/lights/multiple_spot_lights.js +2 -1
  185. package/examples/lights/point.js +2 -3
  186. package/examples/lights/spot.js +2 -3
  187. package/examples/loader/{gltfloader.js → gltf/basic.js} +8 -8
  188. package/examples/loader/gltf/material/alpha-blend-mode.js +80 -0
  189. package/examples/loader/{gltf_material.js → gltf/material/flight_helmet.js} +8 -8
  190. package/examples/loader/gltf/material/iridescence_lamp.js +118 -0
  191. package/examples/loader/objloader.js +9 -11
  192. package/examples/material/cullface.js +8 -7
  193. package/examples/material/materials.js +9 -11
  194. package/examples/material/standard/basic.js +3 -6
  195. package/examples/material/standard/reflection_refraction.js +190 -0
  196. package/examples/mesh/capsule.js +122 -0
  197. package/examples/mesh/circle.js +11 -6
  198. package/examples/mesh/cone.js +129 -0
  199. package/examples/mesh/cuboid.js +11 -6
  200. package/examples/mesh/cylinder.js +11 -6
  201. package/examples/mesh/dodecahedron.js +107 -0
  202. package/examples/mesh/ellipsoid.js +128 -0
  203. package/examples/mesh/extrude.js +118 -0
  204. package/examples/mesh/frustum.js +134 -0
  205. package/examples/mesh/helix.js +133 -0
  206. package/examples/mesh/icosahedron.js +107 -0
  207. package/examples/mesh/icosphere.js +112 -0
  208. package/examples/mesh/lathe.js +124 -0
  209. package/examples/mesh/meshTopology.js +64 -8
  210. package/examples/mesh/octahedron.js +107 -0
  211. package/examples/mesh/plane.js +11 -6
  212. package/examples/mesh/prism.js +122 -0
  213. package/examples/mesh/pyramid.js +121 -0
  214. package/examples/mesh/ring.js +122 -0
  215. package/examples/mesh/skinning.js +8 -8
  216. package/examples/mesh/terrain.js +163 -0
  217. package/examples/mesh/tetrahedron.js +107 -0
  218. package/examples/mesh/torus-knot.js +137 -0
  219. package/examples/mesh/torus.js +122 -0
  220. package/examples/mesh/tube.js +129 -0
  221. package/examples/mesh/uvsphere.js +11 -6
  222. package/examples/mesh/wedge.js +117 -0
  223. package/examples/other/rotatingCube.js +9 -11
  224. package/examples/other/rotatingSphere.js +9 -12
  225. package/examples/rendertarget/basic_canvas.js +5 -8
  226. package/examples/rendertarget/depth_texture.js +18 -11
  227. package/examples/rendertarget/image_target.js +19 -14
  228. package/examples/rendertarget/multiple_views.js +11 -16
  229. package/examples/rendertarget/render_masks.js +3 -5
  230. package/examples/rendertarget/split_screen.js +18 -14
  231. package/examples/rendertarget/split_view.js +12 -9
  232. package/examples/skybox/skybox.js +8 -8
  233. package/examples/texture/arrays.js +9 -12
  234. package/examples/texture/textureWrap.js +8 -8
  235. package/examples/transform/propagation.js +9 -11
  236. package/package.json +18 -12
  237. package/src/caches/cache.js +121 -182
  238. package/src/caches/uniformbuffers.js +42 -53
  239. package/src/constants/texture.js +1 -1
  240. package/src/content.config.js +1 -0
  241. package/src/core/layouts/bindgroup.js +167 -0
  242. package/src/core/layouts/index.js +3 -1
  243. package/src/core/layouts/pipeline.js +165 -0
  244. package/src/core/layouts/uniformbuffer.js +11 -3
  245. package/src/core/resources/gpubuffer.js +23 -2
  246. package/src/core/resources/gpumesh.js +37 -4
  247. package/src/core/resources/gpusampler.js +43 -0
  248. package/src/core/resources/gputexture.js +31 -2
  249. package/src/core/resources/index.js +4 -2
  250. package/src/core/resources/newuniformbuffer.js +58 -0
  251. package/src/core/resources/webglshadermodule.js +58 -0
  252. package/src/core/shader.js +24 -11
  253. package/src/core/webgl/bindgroup.js +200 -42
  254. package/src/core/webgl/descriptors.js +87 -25
  255. package/src/core/webgl/gpuqueue.js +63 -0
  256. package/src/core/webgl/index.js +3 -0
  257. package/src/core/webgl/renderpassencoder.js +703 -16
  258. package/src/core/webgl/renderpipeline.js +38 -1
  259. package/src/core/webgl/utils.js +207 -57
  260. package/src/core/webgl/webglrenderdevice.js +77 -53
  261. package/src/loader/gltf.js +716 -166
  262. package/src/loader/texture.js +69 -16
  263. package/src/loader/utils.js +44 -0
  264. package/src/material/alphablend.js +21 -0
  265. package/src/material/basic.js +15 -1
  266. package/src/material/depth.js +15 -1
  267. package/src/material/index.js +1 -0
  268. package/src/material/lambert.js +15 -1
  269. package/src/material/material.js +49 -7
  270. package/src/material/normal.js +14 -0
  271. package/src/material/phong.js +16 -2
  272. package/src/material/raw.js +21 -2
  273. package/src/material/standard.js +90 -2
  274. package/src/mesh/attribute/attribute.js +2 -2
  275. package/src/mesh/attributedata/separate.js +2 -2
  276. package/src/mesh/builders/capsule.js +47 -0
  277. package/src/mesh/builders/cone.js +29 -0
  278. package/src/mesh/builders/dodecahedron.js +130 -0
  279. package/src/mesh/builders/ellipsoid.js +65 -0
  280. package/src/mesh/builders/extrude.js +136 -0
  281. package/src/mesh/builders/frustum.js +26 -0
  282. package/src/mesh/builders/geometry.js +121 -0
  283. package/src/mesh/builders/helix.js +35 -0
  284. package/src/mesh/builders/icosahedron.js +61 -0
  285. package/src/mesh/builders/icosphere.js +141 -0
  286. package/src/mesh/builders/index.js +22 -1
  287. package/src/mesh/builders/lathe.js +85 -0
  288. package/src/mesh/builders/octahedron.js +43 -0
  289. package/src/mesh/builders/polyhedron.js +121 -0
  290. package/src/mesh/builders/prism.js +19 -0
  291. package/src/mesh/builders/pyramid.js +90 -0
  292. package/src/mesh/builders/ring.js +109 -0
  293. package/src/mesh/builders/surfaces.js +69 -0
  294. package/src/mesh/builders/terrain.js +80 -0
  295. package/src/mesh/builders/tetrahedron.js +37 -0
  296. package/src/mesh/builders/torusknot.js +36 -0
  297. package/src/mesh/builders/tube.js +209 -0
  298. package/src/mesh/builders/utils.js +130 -2
  299. package/src/mesh/builders/wedge.js +22 -0
  300. package/src/mesh/mesh.js +12 -4
  301. package/src/objects/camera/camera.js +104 -1
  302. package/src/objects/light/ambient.js +22 -1
  303. package/src/objects/light/directional.js +23 -1
  304. package/src/objects/light/point.js +25 -1
  305. package/src/objects/light/spot.js +27 -1
  306. package/src/objects/mesh.js +1 -53
  307. package/src/plugins/camera/RenderTarget2DPool.js +94 -0
  308. package/src/plugins/camera/camera.js +14 -6
  309. package/src/plugins/camera/index.js +2 -0
  310. package/src/plugins/camera/nodes/canvasblit.js +153 -0
  311. package/src/plugins/camera/nodes/index.js +4 -1
  312. package/src/plugins/camera/nodes/opaquepass.js +48 -33
  313. package/src/plugins/camera/nodes/tonemapping.js +217 -0
  314. package/src/plugins/camera/nodes/transparentpass.js +87 -0
  315. package/src/plugins/camera/nodes/{cameraview.js → view.js} +27 -1
  316. package/src/plugins/camera/resources/cameracolortargets.js +66 -0
  317. package/src/plugins/camera/resources/canvasblitpipeline.js +6 -0
  318. package/src/plugins/camera/resources/index.js +3 -0
  319. package/src/plugins/camera/resources/tonemappingpipeline.js +6 -0
  320. package/src/plugins/light/light.js +0 -4
  321. package/src/plugins/meshmaterial/meshmaterial.js +433 -170
  322. package/src/plugins/meshmaterial/nodes/meshmaterial.js +39 -6
  323. package/src/plugins/meshmaterial/resources/bonetexture.js +176 -0
  324. package/src/plugins/meshmaterial/resources/environmentmap.js +44 -0
  325. package/src/plugins/meshmaterial/resources/index.js +4 -0
  326. package/src/plugins/meshmaterial/resources/materialuniformbuffers.js +94 -0
  327. package/src/plugins/meshmaterial/resources/meshmaterialbindgroups.js +40 -0
  328. package/src/plugins/shadow/nodes/index.js +3 -3
  329. package/src/plugins/shadow/nodes/{shadowOccluder.js → occluder.js} +13 -19
  330. package/src/plugins/shadow/nodes/opaquePass.js +110 -0
  331. package/src/plugins/shadow/shadow.js +0 -5
  332. package/src/plugins/skeletonhelper/skeletonhelper.js +111 -69
  333. package/src/plugins/skybox/nodes/skybox.js +230 -38
  334. package/src/plugins/skybox/resources/skyboxpipeline.js +10 -0
  335. package/src/plugins/skybox/skybox.js +0 -119
  336. package/src/renderer/core/index.js +135 -21
  337. package/src/renderer/plugin.js +0 -20
  338. package/src/renderer/renderer.js +28 -12
  339. package/src/rendertarget/canvastarget.js +8 -5
  340. package/src/rendertarget/image.js +3 -3
  341. package/src/shader/basicFragment.glsl +12 -4
  342. package/src/shader/basicVertex.glsl +26 -15
  343. package/src/shader/blitFragment.glsl +9 -0
  344. package/src/shader/common/common.glsl +35 -6
  345. package/src/shader/common/index.js +1 -0
  346. package/src/shader/common/tonemap.glsl +118 -0
  347. package/src/shader/debug/skeletonFragment.glsl +0 -2
  348. package/src/shader/debug/skeletonVertex.glsl +1 -3
  349. package/src/shader/depthFragment.glsl +0 -3
  350. package/src/shader/fullscreenVertex.glsl +26 -0
  351. package/src/shader/index.js +3 -0
  352. package/src/shader/lambertFragment.glsl +12 -4
  353. package/src/shader/normalFragment.glsl +0 -3
  354. package/src/shader/phongFragment.glsl +12 -4
  355. package/src/shader/skyboxFragment.glsl +5 -5
  356. package/src/shader/skyboxVertex.glsl +5 -4
  357. package/src/shader/standardFragment.glsl +74 -17
  358. package/src/shader/tonemappingFragment.glsl +37 -0
  359. package/src/texture/sampler.js +101 -21
  360. package/src/texture/texture.js +252 -48
  361. package/src/utils/index.js +15 -1
  362. package/{examples/addons → src/utils}/rendergraph_gui.js +5 -2
  363. package/examples/mesh/geometries.js +0 -108
  364. package/scripts/stage-chorama.mjs +0 -29
  365. package/src/core/resources/framebuffer.js +0 -127
  366. package/src/plugins/shadow/nodes/shadowOpaquePass.js +0 -73
  367. package/website/config/index.ts +0 -1
  368. package/website/config/navigation.ts +0 -53
  369. package/website/content.config.ts +0 -92
  370. package/website/layouts/DocLayout.astro +0 -501
  371. package/website/layouts/Example.astro +0 -91
  372. package/website/pages/examples/[...slug].astro +0 -77
  373. package/website/pages/examples/index.astro +0 -98
  374. package/website/pages/examples/samples/[...slug].astro +0 -17
  375. package/website/pages/guide/[slug].astro +0 -30
  376. package/website/pages/guide/index.astro +0 -21
  377. package/website/pages/index.astro +0 -9
  378. package/website/plugins/remark-link-base.js +0 -23
  379. package/website/utils/url.ts +0 -30
  380. /package/src/plugins/shadow/nodes/{shadow.js → view.js} +0 -0
@@ -2,43 +2,48 @@ import { TextureFilter, TextureWrap } from '../constants/index.js'
2
2
  import { CompareFunction } from '../core/index.js'
3
3
  export class Sampler {
4
4
  /**
5
- * @type {TextureFilter}
5
+ * Tracks if the sampler has changed since last checked.
6
+ * @type {boolean}
6
7
  */
8
+ #changed = false
7
9
 
8
- magnificationFilter
9
10
  /**
10
11
  * @type {TextureFilter}
11
12
  */
12
- minificationFilter
13
+ #magnificationFilter
14
+ /**
15
+ * @type {TextureFilter}
16
+ */
17
+ #minificationFilter
13
18
  /**
14
19
  * @type {TextureFilter | undefined}
15
20
  */
16
- mipmapFilter
21
+ #mipmapFilter
17
22
 
18
23
  /**
19
24
  * @type {TextureWrap}
20
25
  */
21
- wrapS
26
+ #wrapS
22
27
  /**
23
28
  * @type {TextureWrap}
24
29
  */
25
- wrapT
30
+ #wrapT
26
31
  /**
27
32
  * @type {TextureWrap}
28
33
  */
29
- wrapR
34
+ #wrapR
30
35
  /**
31
36
  * @type {number}
32
37
  */
33
- anisotropy
38
+ #anisotropy
34
39
  /**
35
- * @type {SamplerLODSettings}
40
+ * @type {SamplerLODSettings | undefined}
36
41
  */
37
- lod
42
+ #lod
38
43
  /**
39
44
  * @type {CompareFunction | undefined}
40
45
  */
41
- compare
46
+ #compare
42
47
  /**
43
48
  * @param {SamplerSettings} settings
44
49
  */
@@ -53,15 +58,90 @@ export class Sampler {
53
58
  anisotropy = Sampler.defaultSettings.anisotropy,
54
59
  compare = Sampler.defaultSettings.compare
55
60
  } = Sampler.defaultSettings) {
56
- this.minificationFilter = minificationFilter
57
- this.magnificationFilter = magnificationFilter
58
- this.mipmapFilter = mipmapFilter
59
- this.wrapS = wrapS
60
- this.wrapT = wrapT
61
- this.wrapR = wrapR
62
- this.anisotropy = anisotropy
63
- this.lod = lod
64
- this.compare = compare
61
+ this.#minificationFilter = minificationFilter
62
+ this.#magnificationFilter = magnificationFilter
63
+ this.#mipmapFilter = mipmapFilter
64
+ this.#wrapS = wrapS
65
+ this.#wrapT = wrapT
66
+ this.#wrapR = wrapR
67
+ this.#anisotropy = anisotropy
68
+ this.#lod = lod
69
+ this.#compare = compare
70
+ }
71
+
72
+ /**
73
+ * @package
74
+ * @returns {boolean}
75
+ */
76
+ get changed() {
77
+ const previous = this.#changed
78
+ this.#changed = false
79
+ return previous
80
+ }
81
+
82
+ /** @type {TextureFilter} */
83
+ get magnificationFilter() { return this.#magnificationFilter }
84
+ set magnificationFilter(value) {
85
+ this.#magnificationFilter = value
86
+ this.#changed = true
87
+ }
88
+
89
+ /** @type {TextureFilter} */
90
+ get minificationFilter() { return this.#minificationFilter }
91
+ set minificationFilter(value) {
92
+ this.#minificationFilter = value
93
+ this.#changed = true
94
+ }
95
+
96
+ /** @type {TextureFilter | undefined} */
97
+ get mipmapFilter() { return this.#mipmapFilter }
98
+ set mipmapFilter(value) {
99
+ this.#mipmapFilter = value
100
+ this.#changed = true
101
+ }
102
+
103
+ /** @type {TextureWrap} */
104
+ get wrapS() { return this.#wrapS }
105
+ set wrapS(value) {
106
+ this.#wrapS = value
107
+ this.#changed = true
108
+ }
109
+
110
+ /** @type {TextureWrap} */
111
+ get wrapT() { return this.#wrapT }
112
+ set wrapT(value) {
113
+ this.#wrapT = value
114
+ this.#changed = true
115
+ }
116
+
117
+ /** @type {TextureWrap} */
118
+ get wrapR() { return this.#wrapR }
119
+ set wrapR(value) {
120
+ this.#wrapR = value
121
+ this.#changed = true
122
+ }
123
+
124
+ /** @type {number} */
125
+ get anisotropy() { return this.#anisotropy }
126
+ set anisotropy(value) {
127
+ this.#anisotropy = value
128
+ this.#changed = true
129
+ }
130
+
131
+ /** @type {Readonly<SamplerLODSettings> | undefined} */
132
+ get lod() {
133
+ return this.#lod
134
+ }
135
+ set lod(value) {
136
+ this.#lod = value
137
+ this.#changed = true
138
+ }
139
+
140
+ /** @type {CompareFunction | undefined} */
141
+ get compare() { return this.#compare }
142
+ set compare(value) {
143
+ this.#compare = value
144
+ this.#changed = true
65
145
  }
66
146
 
67
147
  static default(){
@@ -108,4 +188,4 @@ export class Sampler {
108
188
  * @typedef SamplerLODSettings
109
189
  * @property {number} max
110
190
  * @property {number} min
111
- */
191
+ */
@@ -1,4 +1,5 @@
1
1
  import { TextureFormat, TextureType } from "../constants/index.js"
2
+ import { getMipLevelSize as getWebGLMipLevelSize, getMipmapCount as getWebGLMipmapCount } from "../core/webgl/utils.js"
2
3
 
3
4
  export class Texture {
4
5
 
@@ -9,8 +10,9 @@ export class Texture {
9
10
  #changed = false
10
11
 
11
12
  /**
12
- * The raw pixel data for the texture.
13
- * @type {ArrayBuffer | undefined}
13
+ * The raw pixel data for the texture, indexed by mip level.
14
+ * Undefined entries can be used to skip uploads for specific mip levels.
15
+ * @type {(ArrayBuffer | undefined)[]}
14
16
  */
15
17
  #data
16
18
 
@@ -38,18 +40,6 @@ export class Texture {
38
40
  */
39
41
  #format
40
42
 
41
- /**
42
- * Whether mipmaps should be automatically generated for this texture.
43
- * @type {boolean}
44
- */
45
- #generateMipmaps
46
-
47
- /**
48
- * Whether the texture should be flipped vertically on upload.
49
- * @type {boolean}
50
- */
51
- #flipY
52
-
53
43
  /**
54
44
  * The type of texture (e.g., Texture2D, TextureCube, etc.).
55
45
  * @type {TextureType}
@@ -57,26 +47,22 @@ export class Texture {
57
47
  #type
58
48
 
59
49
  /**
60
- * @param {TextureSettings & { data?: ArrayBuffer, type: TextureType }} settings
50
+ * @param {TextureSettings & { data?: (ArrayBuffer | undefined)[], type: TextureType }} settings
61
51
  */
62
52
  constructor({
63
53
  data,
64
54
  type,
65
55
  format = Texture.defaultSettings.format,
66
- generateMipmaps = Texture.defaultSettings.generateMipmaps,
67
- flipY = Texture.defaultSettings.flipY,
68
56
  width = Texture.defaultSettings.width,
69
57
  height = Texture.defaultSettings.height,
70
58
  depth = Texture.defaultSettings.depth,
71
59
  }) {
72
- this.#data = data
60
+ this.#data = data ?? []
73
61
  this.#type = type
74
62
  this.#width = width
75
63
  this.#height = height
76
64
  this.#depth = depth
77
- this.#flipY = flipY
78
65
  this.#format = format
79
- this.#generateMipmaps = generateMipmaps
80
66
  }
81
67
 
82
68
  /**
@@ -90,7 +76,7 @@ export class Texture {
90
76
  return previous
91
77
  }
92
78
 
93
- /** @type {ArrayBuffer | undefined} */
79
+ /** @type {(ArrayBuffer | undefined)[]} */
94
80
  get data() { return this.#data }
95
81
  set data(value) {
96
82
  this.#data = value
@@ -125,20 +111,6 @@ export class Texture {
125
111
  this.#changed = true
126
112
  }
127
113
 
128
- /** @type {boolean} */
129
- get generateMipmaps() { return this.#generateMipmaps }
130
- set generateMipmaps(value) {
131
- this.#generateMipmaps = value
132
- this.#changed = true
133
- }
134
-
135
- /** @type {boolean} */
136
- get flipY() { return this.#flipY }
137
- set flipY(value) {
138
- this.#flipY = value
139
- this.#changed = true
140
- }
141
-
142
114
  /** @type {TextureType} */
143
115
  get type() { return this.#type }
144
116
  set type(value) {
@@ -152,8 +124,6 @@ export class Texture {
152
124
  */
153
125
  apply({
154
126
  format = Texture.defaultSettings.format,
155
- generateMipmaps = Texture.defaultSettings.generateMipmaps,
156
- flipY = Texture.defaultSettings.flipY,
157
127
  width = Texture.defaultSettings.width,
158
128
  height = Texture.defaultSettings.height,
159
129
  depth = Texture.defaultSettings.depth,
@@ -161,9 +131,7 @@ export class Texture {
161
131
  this.width = width
162
132
  this.height = height
163
133
  this.depth = depth
164
- this.flipY = flipY
165
134
  this.format = format
166
- this.generateMipmaps = generateMipmaps
167
135
  }
168
136
 
169
137
  /**
@@ -172,14 +140,12 @@ export class Texture {
172
140
  * @returns {this}
173
141
  */
174
142
  copy(other) {
175
- this.data = other.data ? other.data.slice() : undefined
143
+ this.data = other.data.slice()
176
144
  this.format = other.format
177
145
  this.width = other.width
178
146
  this.height = other.height
179
147
  this.depth = other.depth
180
148
  this.type = other.type
181
- this.flipY = other.flipY
182
- this.generateMipmaps = other.generateMipmaps
183
149
  return this
184
150
  }
185
151
 
@@ -202,12 +168,104 @@ export class Texture {
202
168
  const texture = new Texture({
203
169
  width,
204
170
  height,
205
- data: pixel.buffer,
171
+ data: [pixel.buffer],
206
172
  type: TextureType.Texture2D,
207
173
  })
208
174
  return texture
209
175
  }
210
176
 
177
+ /**
178
+ * Returns the number of mip levels for the given base texture size.
179
+ * @param {TextureType} type
180
+ * @param {number} width
181
+ * @param {number} height
182
+ * @param {number} [depth=1]
183
+ * @returns {number}
184
+ */
185
+ static getMipmapCount(type, width, height, depth = 1) {
186
+ return getWebGLMipmapCount(type, width, height, depth)
187
+ }
188
+
189
+ /**
190
+ * Returns the dimensions for a specific mip level.
191
+ * @param {TextureType} type
192
+ * @param {number} width
193
+ * @param {number} height
194
+ * @param {number} [depth=1]
195
+ * @param {number} [mipmapLevel=0]
196
+ * @returns {{ width: number, height: number, depth: number }}
197
+ */
198
+ static getMipLevelSize(type, width, height, depth = 1, mipmapLevel = 0) {
199
+ return getWebGLMipLevelSize(type, width, height, depth, mipmapLevel)
200
+ }
201
+
202
+ /**
203
+ * Generates the full mip chain starting with the base level.
204
+ * Currently supported for uncompressed RGBA8 textures.
205
+ * @param {TextureMipmapSettings} settings
206
+ * @returns {ArrayBuffer[]}
207
+ */
208
+ static generateMipmaps({
209
+ level0,
210
+ type,
211
+ format,
212
+ width,
213
+ height,
214
+ depth = 1,
215
+ }) {
216
+ if (format !== TextureFormat.RGBA8Unorm) {
217
+ throw new Error("Texture.generateMipmaps only supports TextureFormat.RGBA8Unorm")
218
+ }
219
+
220
+ const mipmapCount = Texture.getMipmapCount(type, width, height, depth)
221
+ const mipmaps = [level0]
222
+ let source = level0
223
+ let sourceWidth = width
224
+ let sourceHeight = height
225
+ let sourceDepth = depth
226
+
227
+ for (let mipmapLevel = 1; mipmapLevel < mipmapCount; mipmapLevel++) {
228
+ const {
229
+ width: targetWidth,
230
+ height: targetHeight,
231
+ depth: targetDepth
232
+ } = Texture.getMipLevelSize(type, width, height, depth, mipmapLevel)
233
+
234
+ const target = new ArrayBuffer(targetWidth * targetHeight * targetDepth * 4)
235
+
236
+ if (type === TextureType.Texture3D) {
237
+ downsampleVolumeRgba8(
238
+ source,
239
+ target,
240
+ sourceWidth,
241
+ sourceHeight,
242
+ sourceDepth,
243
+ targetWidth,
244
+ targetHeight,
245
+ targetDepth
246
+ )
247
+ } else {
248
+ downsampleSlicesRgba8(
249
+ source,
250
+ target,
251
+ sourceWidth,
252
+ sourceHeight,
253
+ sourceDepth,
254
+ targetWidth,
255
+ targetHeight
256
+ )
257
+ }
258
+
259
+ mipmaps.push(target)
260
+ source = target
261
+ sourceWidth = targetWidth
262
+ sourceHeight = targetHeight
263
+ sourceDepth = targetDepth
264
+ }
265
+
266
+ return mipmaps
267
+ }
268
+
211
269
  /**
212
270
  * Default texture settings.
213
271
  * @readonly
@@ -215,8 +273,6 @@ export class Texture {
215
273
  */
216
274
  static defaultSettings = {
217
275
  format: TextureFormat.RGBA8Unorm,
218
- generateMipmaps: false,
219
- flipY: false,
220
276
  width: 0,
221
277
  height: 0,
222
278
  depth: 1,
@@ -225,10 +281,158 @@ export class Texture {
225
281
 
226
282
  /**
227
283
  * @typedef TextureSettings
228
- * @property {boolean} [generateMipmaps=true]
229
284
  * @property {TextureFormat} [format]
230
- * @property {boolean} [flipY]
231
285
  * @property {number} [width]
232
286
  * @property {number} [height]
233
287
  * @property {number} [depth]
234
- */
288
+ */
289
+
290
+ /**
291
+ * @typedef TextureMipmapSettings
292
+ * @property {ArrayBuffer} level0
293
+ * @property {TextureType} type
294
+ * @property {TextureFormat} format
295
+ * @property {number} width
296
+ * @property {number} height
297
+ * @property {number} [depth]
298
+ */
299
+
300
+ /**
301
+ * @param {ArrayBuffer} source
302
+ * @param {ArrayBuffer} target
303
+ * @param {number} sourceWidth
304
+ * @param {number} sourceHeight
305
+ * @param {number} sliceCount
306
+ * @param {number} targetWidth
307
+ * @param {number} targetHeight
308
+ */
309
+ function downsampleSlicesRgba8(source, target, sourceWidth, sourceHeight, sliceCount, targetWidth, targetHeight) {
310
+ const sourceView = new Uint8Array(source)
311
+ const targetView = new Uint8Array(target)
312
+ const sourceSliceSize = sourceWidth * sourceHeight * 4
313
+ const targetSliceSize = targetWidth * targetHeight * 4
314
+
315
+ for (let slice = 0; slice < sliceCount; slice++) {
316
+ downsampleImageRgba8(
317
+ sourceView,
318
+ slice * sourceSliceSize,
319
+ sourceWidth,
320
+ sourceHeight,
321
+ targetView,
322
+ slice * targetSliceSize,
323
+ targetWidth,
324
+ targetHeight
325
+ )
326
+ }
327
+ }
328
+
329
+ /**
330
+ * @param {ArrayBuffer} source
331
+ * @param {ArrayBuffer} target
332
+ * @param {number} sourceWidth
333
+ * @param {number} sourceHeight
334
+ * @param {number} sourceDepth
335
+ * @param {number} targetWidth
336
+ * @param {number} targetHeight
337
+ * @param {number} targetDepth
338
+ */
339
+ function downsampleVolumeRgba8(source, target, sourceWidth, sourceHeight, sourceDepth, targetWidth, targetHeight, targetDepth) {
340
+ const sourceView = new Uint8Array(source)
341
+ const targetView = new Uint8Array(target)
342
+ const sourceSliceSize = sourceWidth * sourceHeight * 4
343
+ const targetSliceSize = targetWidth * targetHeight * 4
344
+
345
+ for (let z = 0; z < targetDepth; z++) {
346
+ const sourceZStart = Math.floor(z * sourceDepth / targetDepth)
347
+ const sourceZEnd = Math.floor((z + 1) * sourceDepth / targetDepth)
348
+
349
+ for (let y = 0; y < targetHeight; y++) {
350
+ const sourceYStart = Math.floor(y * sourceHeight / targetHeight)
351
+ const sourceYEnd = Math.floor((y + 1) * sourceHeight / targetHeight)
352
+
353
+ for (let x = 0; x < targetWidth; x++) {
354
+ const sourceXStart = Math.floor(x * sourceWidth / targetWidth)
355
+ const sourceXEnd = Math.floor((x + 1) * sourceWidth / targetWidth)
356
+
357
+ let red = 0
358
+ let green = 0
359
+ let blue = 0
360
+ let alpha = 0
361
+ let count = 0
362
+
363
+ for (let sourceZ = sourceZStart; sourceZ < sourceZEnd; sourceZ++) {
364
+ const zOffset = sourceZ * sourceSliceSize
365
+
366
+ for (let sourceY = sourceYStart; sourceY < sourceYEnd; sourceY++) {
367
+ const yOffset = zOffset + sourceY * sourceWidth * 4
368
+
369
+ for (let sourceX = sourceXStart; sourceX < sourceXEnd; sourceX++) {
370
+ const offset = yOffset + sourceX * 4
371
+ red += sourceView[offset + 0] ?? 0
372
+ green += sourceView[offset + 1] ?? 0
373
+ blue += sourceView[offset + 2] ?? 0
374
+ alpha += sourceView[offset + 3] ?? 0
375
+ count++
376
+ }
377
+ }
378
+ }
379
+
380
+ const targetOffset = z * targetSliceSize + y * targetWidth * 4 + x * 4
381
+ targetView[targetOffset + 0] = Math.round(red / count)
382
+ targetView[targetOffset + 1] = Math.round(green / count)
383
+ targetView[targetOffset + 2] = Math.round(blue / count)
384
+ targetView[targetOffset + 3] = Math.round(alpha / count)
385
+ }
386
+ }
387
+ }
388
+ }
389
+
390
+ /**
391
+ * @param {Uint8Array} sourceView
392
+ * @param {number} sourceOffset
393
+ * @param {number} sourceWidth
394
+ * @param {number} sourceHeight
395
+ * @param {Uint8Array} targetView
396
+ * @param {number} targetOffset
397
+ * @param {number} targetWidth
398
+ * @param {number} targetHeight
399
+ */
400
+ function downsampleImageRgba8(sourceView, sourceOffset, sourceWidth, sourceHeight, targetView, targetOffset, targetWidth, targetHeight) {
401
+ const sourceRowStride = sourceWidth * 4
402
+ const targetRowStride = targetWidth * 4
403
+
404
+ for (let y = 0; y < targetHeight; y++) {
405
+ const sourceYStart = Math.floor(y * sourceHeight / targetHeight)
406
+ const sourceYEnd = Math.floor((y + 1) * sourceHeight / targetHeight)
407
+
408
+ for (let x = 0; x < targetWidth; x++) {
409
+ const sourceXStart = Math.floor(x * sourceWidth / targetWidth)
410
+ const sourceXEnd = Math.floor((x + 1) * sourceWidth / targetWidth)
411
+
412
+ let red = 0
413
+ let green = 0
414
+ let blue = 0
415
+ let alpha = 0
416
+ let count = 0
417
+
418
+ for (let sourceY = sourceYStart; sourceY < sourceYEnd; sourceY++) {
419
+ let offset = sourceOffset + sourceY * sourceRowStride + sourceXStart * 4
420
+
421
+ for (let sourceX = sourceXStart; sourceX < sourceXEnd; sourceX++) {
422
+ red += sourceView[offset + 0] ?? 0
423
+ green += sourceView[offset + 1] ?? 0
424
+ blue += sourceView[offset + 2] ?? 0
425
+ alpha += sourceView[offset + 3] ?? 0
426
+ offset += 4
427
+ count++
428
+ }
429
+ }
430
+
431
+ const writeOffset = targetOffset + y * targetRowStride + x * 4
432
+ targetView[writeOffset + 0] = Math.round(red / count)
433
+ targetView[writeOffset + 1] = Math.round(green / count)
434
+ targetView[writeOffset + 2] = Math.round(blue / count)
435
+ targetView[writeOffset + 3] = Math.round(alpha / count)
436
+ }
437
+ }
438
+ }
@@ -50,6 +50,18 @@ export function assert(test, message) {
50
50
  if (test === undefined || test === null) throw message
51
51
  }
52
52
 
53
+ /**
54
+ * Throws an error if the supplied test is false.
55
+ *
56
+ * @template T
57
+ * @param {T} test
58
+ * @param {string} message
59
+ * @returns {void}
60
+ */
61
+ export function assertTrue(test, message) {
62
+ if (!test) throw message
63
+ }
64
+
53
65
  /**
54
66
  * @template T
55
67
  * @template {string} U
@@ -112,4 +124,6 @@ export function abstractClass(item, baseConstructor) {
112
124
  if(item.constructor === baseConstructor){
113
125
  throw formatString(AbstractClassError.Unconstructable, item.constructor.name)
114
126
  }
115
- }
127
+ }
128
+
129
+ export * from "./rendergraph_gui.js"
@@ -9,6 +9,7 @@
9
9
  * @property {string} [title]
10
10
  * @property {{x:number;y:number}} [position]
11
11
  * @property {number} [width]
12
+ * @property {boolean} [visible]
12
13
  */
13
14
 
14
15
  /**
@@ -20,7 +21,8 @@ export function addRenderGraphGuiAddon({
20
21
  renderer,
21
22
  title = "Render Graph",
22
23
  position = { x: 24, y: 24 },
23
- width = 320
24
+ width = 320,
25
+ visible = false
24
26
  }) {
25
27
  const container = document.createElement("div")
26
28
  const header = document.createElement("div")
@@ -61,7 +63,7 @@ export function addRenderGraphGuiAddon({
61
63
  executionOrder: []
62
64
  }
63
65
  const panelState = {
64
- visible: true,
66
+ visible,
65
67
  refresh: () => renderSnapshot(),
66
68
  back: () => {
67
69
  if (graphStack.length <= 1) return
@@ -97,6 +99,7 @@ export function addRenderGraphGuiAddon({
97
99
  container.style.border = "1px solid #2c2c2c"
98
100
  container.style.boxShadow = "0 8px 24px rgba(0,0,0,0.35)"
99
101
  container.style.userSelect = "none"
102
+ container.style.display = visible ? "block" : "none"
100
103
 
101
104
  header.style.padding = "8px 10px"
102
105
  header.style.cursor = "move"