chorama 0.0.0 → 0.1.1

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 +23336 -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
@@ -1,5 +1,17 @@
1
- /** @import { GPUMesh } from "../resources/index.js" */
1
+ /** @import { GPUMesh, GPUBuffer } from "../resources/index.js" */
2
+ /** @import { WebGLBindGroup } from "./bindgroup.js" */
3
+ /** @import { WebGLColorValue, WebGLRenderPassDescriptor } from "./descriptors.js" */
4
+ import { BufferType, TextureType, hasDepthComponent, hasStencilComponent } from "../../constants/index.js"
5
+ import { getFramebufferAttachment, mapVertexFormatToWebGL } from "../../function.js"
2
6
  import { assert } from "../../utils/index.js"
7
+ import { assertTrue } from "../../utils/index.js"
8
+
9
+ /**
10
+ * @typedef WebGLVertexBufferBinding
11
+ * @property {GPUBuffer} buffer
12
+ * @property {number} offset
13
+ * @property {number | undefined} size
14
+ */
3
15
 
4
16
  export class WebGLRenderPassEncoder {
5
17
  /**
@@ -14,24 +26,69 @@ export class WebGLRenderPassEncoder {
14
26
  pipeline
15
27
  /**
16
28
  * @private
17
- * @type {Map<number, any>}
29
+ * @type {(WebGLBindGroup | undefined)[]}
30
+ */
31
+ bindGroups = []
32
+ /**
33
+ * @private
34
+ * @type {(WebGLVertexBufferBinding | undefined)[]}
35
+ */
36
+ vertexBuffers = []
37
+ /**
38
+ * @private
39
+ * @type {GLenum | undefined}
40
+ */
41
+ indexType
42
+ /**
43
+ * @private
44
+ * @type {number}
45
+ */
46
+ indexBufferOffset = 0
47
+ /**
48
+ * @private
49
+ * @type {GLenum[]}
50
+ */
51
+ discardAttachments = []
52
+ /**
53
+ * @private
54
+ * @type {boolean}
55
+ */
56
+ active = true
57
+ /**
58
+ * @private
59
+ * @type {boolean}
60
+ */
61
+ depthReadOnly = false
62
+ /**
63
+ * @private
64
+ * @type {boolean}
18
65
  */
19
- bindGroups = new Map()
66
+ stencilReadOnly = false
20
67
 
21
68
  /**
22
69
  * @param {WebGL2RenderingContext} context
70
+ * @param {WebGLFramebuffer} drawBuffer
71
+ * @param {WebGLRenderPassDescriptor} descriptor
23
72
  */
24
- constructor(context) {
73
+ constructor(context, drawBuffer, descriptor) {
25
74
  this.context = context
75
+ this.depthReadOnly = descriptor.depthStencilAttachment?.depthReadOnly ?? false
76
+ this.stencilReadOnly = descriptor.depthStencilAttachment?.stencilReadOnly ?? false
77
+
78
+ beginRenderPass(context, drawBuffer, descriptor, this.discardAttachments)
26
79
  }
27
80
 
28
81
  /**
29
82
  * WebGPU-like API: selects the active render pipeline.
30
83
  * @param {import("./renderpipeline.js").WebGLRenderPipeline} pipeline
84
+ * @param {import("../../caches/uniformbuffers.js").UniformBuffers | undefined} [uniformBuffers]
31
85
  */
32
- setPipeline(pipeline) {
86
+ setPipeline(pipeline, uniformBuffers) {
87
+ this.assertActive()
33
88
  this.pipeline = pipeline
89
+ retainCompatibleBindGroups(pipeline, this.bindGroups)
34
90
  this.context.useProgram(pipeline.program)
91
+ pipeline.bindUniformBlocks(this.context, uniformBuffers)
35
92
 
36
93
  // culling
37
94
  if (pipeline.cullMode) {
@@ -43,7 +100,10 @@ export class WebGLRenderPassEncoder {
43
100
 
44
101
  // depth
45
102
  this.context.depthFunc(pipeline.depthCompare)
46
- this.context.depthMask(pipeline.depthWrite)
103
+ this.context.depthMask(!this.depthReadOnly && pipeline.depthWrite)
104
+ if (this.stencilReadOnly) {
105
+ this.context.stencilMask(0)
106
+ }
47
107
 
48
108
  // blending
49
109
  // NOTE: webgl does not have ability to blend differently on
@@ -63,34 +123,661 @@ export class WebGLRenderPassEncoder {
63
123
  } else {
64
124
  this.context.disable(this.context.BLEND)
65
125
  }
126
+
127
+ for (let index = 0; index < this.bindGroups.length; index++) {
128
+ const bindGroup = this.bindGroups[index]
129
+
130
+ if (bindGroup) {
131
+ bindGroup.apply(this.context, pipeline, index)
132
+ }
133
+ }
134
+
135
+ for (let slot = 0; slot < this.vertexBuffers.length; slot++) {
136
+ const binding = this.vertexBuffers[slot]
137
+
138
+ if (binding) {
139
+ applyVertexBuffer(this.context, pipeline, slot, binding)
140
+ }
141
+ }
66
142
  }
67
143
 
68
144
  /**
69
145
  * Makeshift bind-group entry point for future expansion.
70
146
  * @param {number} index
71
- * @param {any} bindGroup
147
+ * @param {WebGLBindGroup} bindGroup
72
148
  */
73
149
  setBindGroup(index, bindGroup) {
74
- this.bindGroups.set(index, bindGroup)
150
+ this.assertActive()
151
+ assertTrue(Number.isInteger(index) && index >= 0, `Invalid bind group index ${index}`)
152
+
153
+ if (this.pipeline) {
154
+ validateBindGroupCompatibility(this.pipeline, index, bindGroup)
155
+ bindGroup.apply(this.context, this.pipeline, index)
156
+ }
157
+
158
+ this.bindGroups[index] = bindGroup
75
159
  }
76
160
 
77
161
  /**
78
- * @param {GPUMesh} mesh
162
+ * @param {number} slot
163
+ * @param {GPUBuffer | null} buffer
164
+ * @param {number} [offset=0]
165
+ * @param {number} [size]
79
166
  */
80
- draw(mesh) {
81
- assert(this.pipeline, "No active pipeline set on render pass encoder")
167
+ setVertexBuffer(slot, buffer, offset = 0, size) {
168
+ this.assertActive()
169
+ assertTrue(Number.isInteger(slot) && slot >= 0, `Invalid vertex buffer slot ${slot}`)
170
+ assertTrue(Number.isInteger(offset) && offset >= 0, `Invalid vertex buffer offset ${offset}`)
82
171
 
83
- this.context.bindVertexArray(mesh.inner)
84
- if (mesh.indexType !== undefined) {
85
- this.context.drawElements(this.pipeline.topology, mesh.count, mesh.indexType, 0)
172
+ if (!buffer) {
173
+ this.vertexBuffers[slot] = undefined
86
174
  return
87
175
  }
88
- this.context.drawArrays(this.pipeline.topology, 0, mesh.count)
176
+
177
+ assertTrue(buffer.type === BufferType.Array, "Vertex buffers must use BufferType.Array")
178
+
179
+ const binding = { buffer, offset, size }
180
+ this.vertexBuffers[slot] = binding
181
+
182
+ if (this.pipeline) {
183
+ applyVertexBuffer(this.context, this.pipeline, slot, binding)
184
+ }
185
+ }
186
+
187
+ /**
188
+ * @param {GPUBuffer} buffer
189
+ * @param {"uint16" | "uint32"} indexFormat
190
+ * @param {number} [offset=0]
191
+ * @param {number} [_size]
192
+ */
193
+ setIndexBuffer(buffer, indexFormat, offset = 0, _size) {
194
+ this.assertActive()
195
+ assertTrue(buffer.type === BufferType.ElementArray, "Index buffers must use BufferType.ElementArray")
196
+ assertTrue(Number.isInteger(offset) && offset >= 0, `Invalid index buffer offset ${offset}`)
197
+
198
+ this.indexType = getIndexFormatType(this.context, indexFormat)
199
+ this.indexBufferOffset = offset
200
+ this.context.bindVertexArray(null)
201
+ this.context.bindBuffer(buffer.type, buffer.inner)
202
+ }
203
+
204
+ /**
205
+ * Sets the viewport in framebuffer pixels.
206
+ * @param {number} x
207
+ * @param {number} y
208
+ * @param {number} width
209
+ * @param {number} height
210
+ * @param {number} [minDepth=0]
211
+ * @param {number} [maxDepth=1]
212
+ */
213
+ setViewport(x, y, width, height, minDepth = 0, maxDepth = 1) {
214
+ this.assertActive()
215
+ this.context.viewport(x, y, width, height)
216
+ this.context.depthRange(minDepth, maxDepth)
217
+ }
218
+
219
+ /**
220
+ * Sets the scissor rectangle in framebuffer pixels.
221
+ * @param {number} x
222
+ * @param {number} y
223
+ * @param {number} width
224
+ * @param {number} height
225
+ */
226
+ setScissorRect(x, y, width, height) {
227
+ this.assertActive()
228
+ this.context.enable(this.context.SCISSOR_TEST)
229
+ this.context.scissor(x, y, width, height)
230
+ }
231
+
232
+ /**
233
+ * @param {WebGLColorValue} color
234
+ */
235
+ setBlendConstant(color) {
236
+ this.assertActive()
237
+ const [r, g, b, a] = color
238
+
239
+ this.context.blendColor(r, g, b, a)
240
+ }
241
+
242
+ /**
243
+ * @param {number} reference
244
+ */
245
+ setStencilReference(reference) {
246
+ this.assertActive()
247
+ this.context.stencilFunc(this.context.ALWAYS, reference, 0xFF)
248
+ }
249
+
250
+ /**
251
+ * WebGPU draw for vertex counts, with a compatibility path for GPUMesh.
252
+ * @param {GPUMesh | number} meshOrVertexCount
253
+ * @param {number} [instanceCount=1]
254
+ * @param {number} [firstVertex=0]
255
+ * @param {number} [firstInstance=0]
256
+ */
257
+ draw(meshOrVertexCount, instanceCount = 1, firstVertex = 0, firstInstance = 0) {
258
+ const pipeline = this.getPipelineReadyToDraw()
259
+
260
+ if (typeof meshOrVertexCount === "number") {
261
+ assertTrue(firstInstance === 0, "WebGL2 does not support firstInstance")
262
+ this.context.bindVertexArray(null)
263
+
264
+ if (instanceCount > 1) {
265
+ this.context.drawArraysInstanced(pipeline.topology, firstVertex, meshOrVertexCount, instanceCount)
266
+ } else {
267
+ this.context.drawArrays(pipeline.topology, firstVertex, meshOrVertexCount)
268
+ }
269
+ return
270
+ }
271
+
272
+ assertTrue(instanceCount === 1, "Instanced GPUMesh drawing is not supported")
273
+ assertTrue(firstVertex === 0, "GPUMesh drawing does not support firstVertex")
274
+ assertTrue(firstInstance === 0, "GPUMesh drawing does not support firstInstance")
275
+
276
+ this.context.bindVertexArray(meshOrVertexCount.inner)
277
+ if (meshOrVertexCount.indexType !== undefined) {
278
+ this.context.drawElements(pipeline.topology, meshOrVertexCount.count, meshOrVertexCount.indexType, 0)
279
+ return
280
+ }
281
+ this.context.drawArrays(pipeline.topology, 0, meshOrVertexCount.count)
282
+ }
283
+
284
+ /**
285
+ * @param {number} indexCount
286
+ * @param {number} [instanceCount=1]
287
+ * @param {number} [firstIndex=0]
288
+ * @param {number} [baseVertex=0]
289
+ * @param {number} [firstInstance=0]
290
+ */
291
+ drawIndexed(indexCount, instanceCount = 1, firstIndex = 0, baseVertex = 0, firstInstance = 0) {
292
+ const pipeline = this.getPipelineReadyToDraw()
293
+
294
+ assert(this.indexType, "No active index buffer set on render pass encoder")
295
+ assertTrue(baseVertex === 0, "WebGL2 does not support baseVertex")
296
+ assertTrue(firstInstance === 0, "WebGL2 does not support firstInstance")
297
+
298
+ const offset = this.indexBufferOffset + firstIndex * getIndexFormatSize(this.indexType)
299
+
300
+ this.context.bindVertexArray(null)
301
+ if (instanceCount > 1) {
302
+ this.context.drawElementsInstanced(pipeline.topology, indexCount, this.indexType, offset, instanceCount)
303
+ return
304
+ }
305
+
306
+ this.context.drawElements(pipeline.topology, indexCount, this.indexType, offset)
307
+ }
308
+
309
+ /**
310
+ * Draws a non-indexed primitive stream without binding a mesh.
311
+ * @param {number} count
312
+ * @param {number} [first=0]
313
+ */
314
+ drawArrays(count, first = 0) {
315
+ this.draw(count, 1, first)
89
316
  }
90
317
 
91
318
  end() {
319
+ this.assertActive()
320
+ if (this.discardAttachments.length > 0) {
321
+ this.context.invalidateFramebuffer(this.context.FRAMEBUFFER, this.discardAttachments)
322
+ }
323
+
92
324
  this.pipeline = undefined
93
- this.bindGroups.clear()
325
+ this.bindGroups.length = 0
326
+ this.vertexBuffers.length = 0
327
+ this.indexType = undefined
328
+ this.indexBufferOffset = 0
329
+ this.active = false
94
330
  this.context.bindVertexArray(null)
95
331
  }
332
+
333
+ assertActive() {
334
+ assertTrue(this.active, "Render pass encoder has ended")
335
+ }
336
+
337
+ getPipelineReadyToDraw() {
338
+ this.assertActive()
339
+ assert(this.pipeline, "No active pipeline set on render pass encoder")
340
+ validateRequiredBindGroups(this.pipeline, this.bindGroups)
341
+ return this.pipeline
342
+ }
343
+ }
344
+
345
+ /**
346
+ * @param {import("./renderpipeline.js").WebGLRenderPipeline} pipeline
347
+ * @param {number} index
348
+ * @param {WebGLBindGroup} bindGroup
349
+ */
350
+ function validateBindGroupCompatibility(pipeline, index, bindGroup) {
351
+ const expectedLayout = pipeline.layout.getBindGroupLayout(index)
352
+
353
+ assert(expectedLayout, `Pipeline does not declare bind group ${index}`)
354
+ assertTrue(expectedLayout.compatibleWith(bindGroup.layout), `Bind group ${index} is not compatible with the active pipeline layout`)
355
+ }
356
+
357
+ /**
358
+ * @param {WebGL2RenderingContext} context
359
+ * @param {WebGLFramebuffer} drawBuffer
360
+ * @param {WebGLRenderPassDescriptor} descriptor
361
+ * @param {GLenum[]} discardAttachments
362
+ */
363
+ function beginRenderPass(context, drawBuffer, descriptor, discardAttachments) {
364
+ const useDefaultFramebuffer = descriptor.defaultFramebuffer ?? false
365
+ const drawBuffers = resolveDrawBuffers(context, descriptor)
366
+
367
+ context.bindFramebuffer(context.FRAMEBUFFER, useDefaultFramebuffer ? null : drawBuffer)
368
+
369
+ if (!useDefaultFramebuffer) {
370
+ configureFramebufferAttachments(context, descriptor)
371
+ }
372
+
373
+ context.drawBuffers(drawBuffers)
374
+ setInitialViewportAndScissor(context, descriptor)
375
+ configureDepthStencilState(context, descriptor)
376
+ clearRenderPassAttachments(context, descriptor)
377
+ collectDiscardAttachments(context, descriptor, drawBuffers, discardAttachments)
378
+ }
379
+
380
+ /**
381
+ * @param {WebGL2RenderingContext} context
382
+ * @param {WebGLRenderPassDescriptor} descriptor
383
+ * @returns {GLenum[]}
384
+ */
385
+ function resolveDrawBuffers(context, descriptor) {
386
+ const { colorAttachments, defaultFramebuffer = false } = descriptor
387
+
388
+ if (colorAttachments.length === 0) {
389
+ return [context.NONE]
390
+ }
391
+
392
+ return colorAttachments.map((attachment, index) => {
393
+ if (!attachment) {
394
+ return context.NONE
395
+ }
396
+
397
+ if (!defaultFramebuffer) {
398
+ assert(attachment.texture, `Render pass color attachment ${index} does not have a texture`)
399
+ }
400
+
401
+ return defaultFramebuffer ? context.BACK : context.COLOR_ATTACHMENT0 + index
402
+ })
403
+ }
404
+
405
+ /**
406
+ * @param {WebGL2RenderingContext} context
407
+ * @param {WebGLRenderPassDescriptor} descriptor
408
+ */
409
+ function configureFramebufferAttachments(context, descriptor) {
410
+ const maxColorAttachments = /** @type {number} */ (context.getParameter(context.MAX_COLOR_ATTACHMENTS))
411
+
412
+ for (let i = 0; i < maxColorAttachments; i++) {
413
+ const attachment = descriptor.colorAttachments[i]
414
+ const colorAttachment = context.COLOR_ATTACHMENT0 + i
415
+
416
+ if (attachment?.texture) {
417
+ attachTextureToFramebuffer(
418
+ context,
419
+ colorAttachment,
420
+ attachment.texture,
421
+ attachment.mipLevel ?? 0,
422
+ attachment.layer ?? 0
423
+ )
424
+ } else {
425
+ context.framebufferTexture2D(context.FRAMEBUFFER, colorAttachment, context.TEXTURE_2D, null, 0)
426
+ }
427
+ }
428
+
429
+ context.framebufferTexture2D(context.FRAMEBUFFER, context.DEPTH_ATTACHMENT, context.TEXTURE_2D, null, 0)
430
+ context.framebufferTexture2D(context.FRAMEBUFFER, context.STENCIL_ATTACHMENT, context.TEXTURE_2D, null, 0)
431
+ context.framebufferTexture2D(context.FRAMEBUFFER, context.DEPTH_STENCIL_ATTACHMENT, context.TEXTURE_2D, null, 0)
432
+
433
+ const depthStencilTexture = descriptor.depthStencilAttachment?.texture
434
+
435
+ if (descriptor.depthStencilAttachment) {
436
+ assert(depthStencilTexture, "Render pass depth/stencil attachment does not have a texture")
437
+ }
438
+
439
+ if (depthStencilTexture) {
440
+ attachTextureToFramebuffer(
441
+ context,
442
+ getFramebufferAttachment(depthStencilTexture.actualFormat),
443
+ depthStencilTexture,
444
+ descriptor.depthStencilAttachment?.mipLevel ?? 0,
445
+ descriptor.depthStencilAttachment?.layer ?? 0
446
+ )
447
+ }
448
+
449
+ const status = context.checkFramebufferStatus(context.FRAMEBUFFER)
450
+
451
+ assertTrue(status === context.FRAMEBUFFER_COMPLETE, `Render pass framebuffer is incomplete: ${status}`)
452
+ }
453
+
454
+ /**
455
+ * @param {WebGL2RenderingContext} context
456
+ * @param {GLenum} attachment
457
+ * @param {import("../resources/index.js").GPUTexture} texture
458
+ * @param {number} mipLevel
459
+ * @param {number} layer
460
+ */
461
+ function attachTextureToFramebuffer(context, attachment, texture, mipLevel, layer) {
462
+ switch (texture.type) {
463
+ case TextureType.Texture2D:
464
+ context.framebufferTexture2D(
465
+ context.FRAMEBUFFER,
466
+ attachment,
467
+ context.TEXTURE_2D,
468
+ texture.inner,
469
+ mipLevel
470
+ )
471
+ break
472
+ case TextureType.Texture2DArray:
473
+ context.framebufferTextureLayer(
474
+ context.FRAMEBUFFER,
475
+ attachment,
476
+ texture.inner,
477
+ mipLevel,
478
+ layer
479
+ )
480
+ break
481
+ default:
482
+ throw new Error("Texture type is not supported as a render pass attachment")
483
+ }
484
+ }
485
+
486
+ /**
487
+ * @param {WebGL2RenderingContext} context
488
+ * @param {WebGLRenderPassDescriptor} descriptor
489
+ */
490
+ function setInitialViewportAndScissor(context, descriptor) {
491
+ const { viewport, scissor } = descriptor
492
+ const viewportPixels = rectangleToPixels(descriptor, viewport)
493
+
494
+ context.viewport(
495
+ viewportPixels.x,
496
+ viewportPixels.y,
497
+ viewportPixels.width,
498
+ viewportPixels.height
499
+ )
500
+
501
+ const scissorRectangle = scissor || viewport
502
+
503
+ if (!scissorRectangle) {
504
+ context.disable(context.SCISSOR_TEST)
505
+ return
506
+ }
507
+
508
+ const scissorPixels = rectangleToPixels(descriptor, scissorRectangle)
509
+
510
+ context.enable(context.SCISSOR_TEST)
511
+ context.scissor(
512
+ scissorPixels.x,
513
+ scissorPixels.y,
514
+ scissorPixels.width,
515
+ scissorPixels.height
516
+ )
517
+ }
518
+
519
+ /**
520
+ * @param {{ width: number, height: number }} target
521
+ * @param {import("../../utils/index.js").ViewRectangle | undefined} rectangle
522
+ */
523
+ function rectangleToPixels(target, rectangle) {
524
+ if (!rectangle) {
525
+ return {
526
+ x: 0,
527
+ y: 0,
528
+ width: target.width,
529
+ height: target.height
530
+ }
531
+ }
532
+
533
+ return {
534
+ x: rectangle.offset.x * target.width,
535
+ y: rectangle.offset.y * target.height,
536
+ width: rectangle.size.x * target.width,
537
+ height: rectangle.size.y * target.height
538
+ }
539
+ }
540
+
541
+ /**
542
+ * @param {WebGL2RenderingContext} context
543
+ * @param {WebGLRenderPassDescriptor} descriptor
544
+ */
545
+ function configureDepthStencilState(context, descriptor) {
546
+ const { depthStencilAttachment } = descriptor
547
+
548
+ if (!depthStencilAttachment) {
549
+ context.disable(context.DEPTH_TEST)
550
+ context.disable(context.STENCIL_TEST)
551
+ return
552
+ }
553
+
554
+ const format = depthStencilAttachment.texture?.actualFormat
555
+ const depthRequested = depthStencilAttachment.depthLoadOp !== undefined ||
556
+ depthStencilAttachment.depthStoreOp !== undefined ||
557
+ depthStencilAttachment.depthClearValue !== undefined
558
+ const stencilRequested = depthStencilAttachment.stencilLoadOp !== undefined ||
559
+ depthStencilAttachment.stencilStoreOp !== undefined ||
560
+ depthStencilAttachment.stencilClearValue !== undefined
561
+
562
+ if (format !== undefined) {
563
+ assertTrue(!depthRequested || hasDepthComponent(format), "Render pass depth attachment does not have a depth component")
564
+ assertTrue(!stencilRequested || hasStencilComponent(format), "Render pass stencil attachment does not have a stencil component")
565
+ }
566
+
567
+ if (depthRequested) {
568
+ context.enable(context.DEPTH_TEST)
569
+ } else {
570
+ context.disable(context.DEPTH_TEST)
571
+ }
572
+
573
+ if (stencilRequested) {
574
+ context.enable(context.STENCIL_TEST)
575
+ context.stencilMask(depthStencilAttachment.stencilReadOnly ? 0 : 0xFF)
576
+ } else {
577
+ context.disable(context.STENCIL_TEST)
578
+ }
579
+ }
580
+
581
+ /**
582
+ * @param {WebGL2RenderingContext} context
583
+ * @param {WebGLRenderPassDescriptor} descriptor
584
+ */
585
+ function clearRenderPassAttachments(context, descriptor) {
586
+ const { colorAttachments, depthStencilAttachment } = descriptor
587
+
588
+ for (let i = 0; i < colorAttachments.length; i++) {
589
+ const attachment = colorAttachments[i]
590
+
591
+ if (!attachment || attachment.loadOp !== "clear") {
592
+ continue
593
+ }
594
+
595
+ const [r, g, b, a] = attachment.clearValue ?? [0, 0, 0, 0]
596
+
597
+ context.colorMask(true, true, true, true)
598
+ context.clearBufferfv(context.COLOR, i, new Float32Array([r, g, b, a]))
599
+ }
600
+
601
+ if (!depthStencilAttachment) {
602
+ return
603
+ }
604
+
605
+ const clearDepth = depthStencilAttachment.depthLoadOp === "clear"
606
+ const clearStencil = depthStencilAttachment.stencilLoadOp === "clear"
607
+
608
+ if (clearDepth && clearStencil) {
609
+ context.depthMask(true)
610
+ context.stencilMask(0xFF)
611
+ context.clearBufferfi(
612
+ context.DEPTH_STENCIL,
613
+ 0,
614
+ depthStencilAttachment.depthClearValue ?? 1,
615
+ depthStencilAttachment.stencilClearValue ?? 0
616
+ )
617
+ return
618
+ }
619
+
620
+ if (clearDepth) {
621
+ context.depthMask(true)
622
+ context.clearBufferfv(context.DEPTH, 0, new Float32Array([depthStencilAttachment.depthClearValue ?? 1]))
623
+ }
624
+
625
+ if (clearStencil) {
626
+ context.stencilMask(0xFF)
627
+ context.clearBufferiv(context.STENCIL, 0, new Int32Array([depthStencilAttachment.stencilClearValue ?? 0]))
628
+ }
629
+ }
630
+
631
+ /**
632
+ * @param {WebGL2RenderingContext} context
633
+ * @param {WebGLRenderPassDescriptor} descriptor
634
+ * @param {GLenum[]} drawBuffers
635
+ * @param {GLenum[]} discardAttachments
636
+ */
637
+ function collectDiscardAttachments(context, descriptor, drawBuffers, discardAttachments) {
638
+ const { colorAttachments, depthStencilAttachment, defaultFramebuffer = false } = descriptor
639
+
640
+ for (let i = 0; i < colorAttachments.length; i++) {
641
+ const attachment = colorAttachments[i]
642
+
643
+ if (!attachment || attachment.storeOp !== "discard") {
644
+ continue
645
+ }
646
+
647
+ const drawBuffer = drawBuffers[i]
648
+
649
+ assert(drawBuffer, `Framebuffer does not have color attachment ${i}`)
650
+ discardAttachments.push(defaultFramebuffer ? context.COLOR : drawBuffer)
651
+ }
652
+
653
+ if (!depthStencilAttachment) {
654
+ return
655
+ }
656
+
657
+ if (depthStencilAttachment.depthStoreOp === "discard") {
658
+ discardAttachments.push(defaultFramebuffer ? context.DEPTH : context.DEPTH_ATTACHMENT)
659
+ }
660
+
661
+ if (depthStencilAttachment.stencilStoreOp === "discard") {
662
+ discardAttachments.push(defaultFramebuffer ? context.STENCIL : context.STENCIL_ATTACHMENT)
663
+ }
664
+ }
665
+
666
+ /**
667
+ * @param {WebGL2RenderingContext} context
668
+ * @param {import("./renderpipeline.js").WebGLRenderPipeline} pipeline
669
+ * @param {number} slot
670
+ * @param {WebGLVertexBufferBinding} binding
671
+ */
672
+ function applyVertexBuffer(context, pipeline, slot, binding) {
673
+ const layout = pipeline.vertexLayout.layouts[slot]
674
+
675
+ assert(layout, `Pipeline does not declare vertex buffer slot ${slot}`)
676
+
677
+ context.bindVertexArray(null)
678
+ context.bindBuffer(binding.buffer.type, binding.buffer.inner)
679
+
680
+ for (const attribute of layout.attributes) {
681
+ setVertexAttribute(context, attribute.id, mapVertexFormatToWebGL(attribute.format), 0, binding.offset)
682
+ }
683
+ }
684
+
685
+ /**
686
+ * @param {WebGL2RenderingContext} context
687
+ * @param {number} index
688
+ * @param {import("../../function.js").WebGLAtttributeParams} params
689
+ * @param {number} stride
690
+ * @param {number} offset
691
+ */
692
+ function setVertexAttribute(context, index, params, stride, offset) {
693
+ const { type, size, normalized } = params
694
+
695
+ context.enableVertexAttribArray(index)
696
+ switch (type) {
697
+ case WebGL2RenderingContext.FLOAT:
698
+ context.vertexAttribPointer(index, size, type, normalized, stride, offset)
699
+ break
700
+ case WebGL2RenderingContext.BYTE:
701
+ case WebGL2RenderingContext.UNSIGNED_BYTE:
702
+ case WebGL2RenderingContext.SHORT:
703
+ case WebGL2RenderingContext.UNSIGNED_SHORT:
704
+ case WebGL2RenderingContext.INT:
705
+ case WebGL2RenderingContext.UNSIGNED_INT:
706
+ if (normalized) {
707
+ context.vertexAttribPointer(index, size, type, normalized, stride, offset)
708
+ } else {
709
+ context.vertexAttribIPointer(index, size, type, stride, offset)
710
+ }
711
+ break
712
+ default:
713
+ throw new Error(`Unsupported GlDataType: ${type.toString()}`)
714
+ }
715
+ }
716
+
717
+ /**
718
+ * @param {WebGL2RenderingContext} context
719
+ * @param {"uint16" | "uint32"} indexFormat
720
+ */
721
+ function getIndexFormatType(context, indexFormat) {
722
+ switch (indexFormat) {
723
+ case "uint16":
724
+ return context.UNSIGNED_SHORT
725
+ case "uint32":
726
+ return context.UNSIGNED_INT
727
+ default:
728
+ throw new Error(`Unsupported index format: ${indexFormat}`)
729
+ }
730
+ }
731
+
732
+ /**
733
+ * @param {GLenum} indexType
734
+ */
735
+ function getIndexFormatSize(indexType) {
736
+ switch (indexType) {
737
+ case WebGL2RenderingContext.UNSIGNED_SHORT:
738
+ return 2
739
+ case WebGL2RenderingContext.UNSIGNED_INT:
740
+ return 4
741
+ default:
742
+ throw new Error(`Unsupported index type: ${indexType}`)
743
+ }
744
+ }
745
+
746
+ /**
747
+ * Keeps only bind groups that still match the active pipeline layout at the same index.
748
+ * @param {import("./renderpipeline.js").WebGLRenderPipeline} pipeline
749
+ * @param {Array<WebGLBindGroup | undefined>} bindGroups
750
+ */
751
+ function retainCompatibleBindGroups(pipeline, bindGroups) {
752
+ for (let index = 0; index < bindGroups.length; index++) {
753
+ const bindGroup = bindGroups[index]
754
+
755
+ if (!bindGroup) {
756
+ continue
757
+ }
758
+
759
+ const expectedLayout = pipeline.layout.getBindGroupLayout(index)
760
+
761
+ if (!expectedLayout || !expectedLayout.compatibleWith(bindGroup.layout)) {
762
+ bindGroups[index] = undefined
763
+ }
764
+ }
765
+ }
766
+
767
+ /**
768
+ * @param {import("./renderpipeline.js").WebGLRenderPipeline} pipeline
769
+ * @param {ReadonlyArray<WebGLBindGroup | undefined>} bindGroups
770
+ */
771
+ function validateRequiredBindGroups(pipeline, bindGroups) {
772
+ for (let i = 0; i < pipeline.layout.bindGroupLayouts.length; i++) {
773
+ const layout = pipeline.layout.bindGroupLayouts[i]
774
+
775
+ if (!layout || layout.entries.length === 0) {
776
+ continue
777
+ }
778
+
779
+ const bindGroup = bindGroups[i]
780
+
781
+ assert(bindGroup, `Pipeline requires bind group ${i}`)
782
+ }
96
783
  }