@luma.gl/webgl 9.0.0-alpha.3 → 9.0.0-alpha.31

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 (512) hide show
  1. package/LICENSE +2 -1
  2. package/dist/adapter/converters/device-parameters.d.ts +14 -4
  3. package/dist/adapter/converters/device-parameters.d.ts.map +1 -1
  4. package/dist/adapter/converters/device-parameters.js +28 -46
  5. package/dist/adapter/converters/device-parameters.js.map +1 -1
  6. package/dist/adapter/converters/sampler-parameters.d.ts +5 -5
  7. package/dist/adapter/converters/sampler-parameters.d.ts.map +1 -1
  8. package/dist/adapter/converters/sampler-parameters.js +20 -56
  9. package/dist/adapter/converters/sampler-parameters.js.map +1 -1
  10. package/dist/adapter/converters/shader-formats.d.ts +9 -0
  11. package/dist/adapter/converters/shader-formats.d.ts.map +1 -0
  12. package/dist/adapter/converters/shader-formats.js +53 -0
  13. package/dist/adapter/converters/shader-formats.js.map +1 -0
  14. package/dist/adapter/converters/texture-formats.d.ts +32 -44
  15. package/dist/adapter/converters/texture-formats.d.ts.map +1 -1
  16. package/dist/adapter/converters/texture-formats.js +165 -201
  17. package/dist/adapter/converters/texture-formats.js.map +1 -1
  18. package/dist/adapter/converters/vertex-formats.d.ts +9 -3
  19. package/dist/adapter/converters/vertex-formats.d.ts.map +1 -1
  20. package/dist/adapter/converters/vertex-formats.js +48 -16
  21. package/dist/adapter/converters/vertex-formats.js.map +1 -1
  22. package/dist/adapter/device-helpers/device-features.d.ts +1 -1
  23. package/dist/adapter/device-helpers/device-features.d.ts.map +1 -1
  24. package/dist/adapter/device-helpers/device-features.js +13 -20
  25. package/dist/adapter/device-helpers/device-features.js.map +1 -1
  26. package/dist/adapter/device-helpers/device-limits.d.ts +3 -3
  27. package/dist/adapter/device-helpers/device-limits.d.ts.map +1 -1
  28. package/dist/adapter/device-helpers/device-limits.js +2 -5
  29. package/dist/adapter/device-helpers/device-limits.js.map +1 -1
  30. package/dist/adapter/device-helpers/get-device-info.d.ts +1 -1
  31. package/dist/adapter/device-helpers/get-device-info.d.ts.map +1 -1
  32. package/dist/adapter/device-helpers/get-device-info.js +9 -11
  33. package/dist/adapter/device-helpers/get-device-info.js.map +1 -1
  34. package/dist/adapter/device-helpers/is-old-ie.js +2 -1
  35. package/dist/adapter/device-helpers/is-old-ie.js.map +1 -1
  36. package/dist/adapter/helpers/decode-webgl-types.d.ts +26 -0
  37. package/dist/adapter/helpers/decode-webgl-types.d.ts.map +1 -0
  38. package/dist/adapter/helpers/{uniforms.js → decode-webgl-types.js} +20 -29
  39. package/dist/adapter/helpers/decode-webgl-types.js.map +1 -0
  40. package/dist/adapter/helpers/get-shader-info.d.ts +9 -0
  41. package/dist/adapter/helpers/get-shader-info.d.ts.map +1 -0
  42. package/dist/adapter/helpers/get-shader-info.js +25 -0
  43. package/dist/adapter/helpers/get-shader-info.js.map +1 -0
  44. package/dist/adapter/helpers/get-shader-layout.d.ts +1 -48
  45. package/dist/adapter/helpers/get-shader-layout.d.ts.map +1 -1
  46. package/dist/adapter/helpers/get-shader-layout.js +58 -113
  47. package/dist/adapter/helpers/get-shader-layout.js.map +1 -1
  48. package/dist/adapter/helpers/parse-shader-compiler-log.d.ts +1 -1
  49. package/dist/adapter/helpers/parse-shader-compiler-log.d.ts.map +1 -1
  50. package/dist/adapter/helpers/parse-shader-compiler-log.js +0 -7
  51. package/dist/adapter/helpers/parse-shader-compiler-log.js.map +1 -1
  52. package/dist/adapter/helpers/set-uniform.d.ts +2 -2
  53. package/dist/adapter/helpers/set-uniform.d.ts.map +1 -1
  54. package/dist/adapter/helpers/set-uniform.js +3 -33
  55. package/dist/adapter/helpers/set-uniform.js.map +1 -1
  56. package/dist/adapter/helpers/webgl-topology-utils.d.ts +11 -0
  57. package/dist/adapter/helpers/webgl-topology-utils.d.ts.map +1 -0
  58. package/dist/adapter/helpers/{attribute-utils.js → webgl-topology-utils.js} +2 -19
  59. package/dist/adapter/helpers/webgl-topology-utils.js.map +1 -0
  60. package/dist/adapter/objects/constants-to-keys.d.ts +1 -3
  61. package/dist/adapter/objects/constants-to-keys.d.ts.map +1 -1
  62. package/dist/adapter/objects/constants-to-keys.js +1 -28
  63. package/dist/adapter/objects/constants-to-keys.js.map +1 -1
  64. package/dist/adapter/objects/webgl-renderbuffer.d.ts +15 -12
  65. package/dist/adapter/objects/webgl-renderbuffer.d.ts.map +1 -1
  66. package/dist/adapter/objects/webgl-renderbuffer.js +35 -41
  67. package/dist/adapter/objects/webgl-renderbuffer.js.map +1 -1
  68. package/dist/adapter/objects/webgl-resource.d.ts +6 -9
  69. package/dist/adapter/objects/webgl-resource.d.ts.map +1 -1
  70. package/dist/adapter/objects/webgl-resource.js +19 -75
  71. package/dist/adapter/objects/webgl-resource.js.map +1 -1
  72. package/dist/adapter/objects/webgl-vertex-array-object.d.ts +39 -11
  73. package/dist/adapter/objects/webgl-vertex-array-object.d.ts.map +1 -1
  74. package/dist/adapter/objects/webgl-vertex-array-object.js +122 -32
  75. package/dist/adapter/objects/webgl-vertex-array-object.js.map +1 -1
  76. package/dist/adapter/resources/webgl-buffer.d.ts +18 -10
  77. package/dist/adapter/resources/webgl-buffer.d.ts.map +1 -1
  78. package/dist/adapter/resources/webgl-buffer.js +43 -71
  79. package/dist/adapter/resources/webgl-buffer.js.map +1 -1
  80. package/dist/adapter/resources/webgl-command-buffer.d.ts +15 -9
  81. package/dist/adapter/resources/webgl-command-buffer.d.ts.map +1 -1
  82. package/dist/adapter/resources/webgl-command-buffer.js +169 -41
  83. package/dist/adapter/resources/webgl-command-buffer.js.map +1 -1
  84. package/dist/adapter/resources/webgl-command-encoder.d.ts +7 -6
  85. package/dist/adapter/resources/webgl-command-encoder.d.ts.map +1 -1
  86. package/dist/adapter/resources/webgl-command-encoder.js +9 -18
  87. package/dist/adapter/resources/webgl-command-encoder.js.map +1 -1
  88. package/dist/adapter/resources/webgl-external-texture.js.map +1 -1
  89. package/dist/adapter/resources/webgl-framebuffer.d.ts +21 -24
  90. package/dist/adapter/resources/webgl-framebuffer.d.ts.map +1 -1
  91. package/dist/adapter/resources/webgl-framebuffer.js +41 -149
  92. package/dist/adapter/resources/webgl-framebuffer.js.map +1 -1
  93. package/dist/adapter/resources/webgl-render-pass.d.ts +19 -4
  94. package/dist/adapter/resources/webgl-render-pass.d.ts.map +1 -1
  95. package/dist/adapter/resources/webgl-render-pass.js +88 -9
  96. package/dist/adapter/resources/webgl-render-pass.js.map +1 -1
  97. package/dist/adapter/resources/webgl-render-pipeline.d.ts +52 -14
  98. package/dist/adapter/resources/webgl-render-pipeline.d.ts.map +1 -1
  99. package/dist/adapter/resources/webgl-render-pipeline.js +119 -182
  100. package/dist/adapter/resources/webgl-render-pipeline.js.map +1 -1
  101. package/dist/adapter/resources/webgl-sampler.d.ts +6 -5
  102. package/dist/adapter/resources/webgl-sampler.d.ts.map +1 -1
  103. package/dist/adapter/resources/webgl-sampler.js +7 -15
  104. package/dist/adapter/resources/webgl-sampler.js.map +1 -1
  105. package/dist/adapter/resources/webgl-shader.d.ts +3 -4
  106. package/dist/adapter/resources/webgl-shader.d.ts.map +1 -1
  107. package/dist/adapter/resources/webgl-shader.js +9 -22
  108. package/dist/adapter/resources/webgl-shader.js.map +1 -1
  109. package/dist/adapter/resources/webgl-texture.d.ts +64 -44
  110. package/dist/adapter/resources/webgl-texture.d.ts.map +1 -1
  111. package/dist/adapter/resources/webgl-texture.js +98 -213
  112. package/dist/adapter/resources/webgl-texture.js.map +1 -1
  113. package/dist/adapter/webgl-canvas-context.d.ts +6 -7
  114. package/dist/adapter/webgl-canvas-context.d.ts.map +1 -1
  115. package/dist/adapter/webgl-canvas-context.js +8 -20
  116. package/dist/adapter/webgl-canvas-context.js.map +1 -1
  117. package/dist/adapter/webgl-device.d.ts +64 -41
  118. package/dist/adapter/webgl-device.d.ts.map +1 -1
  119. package/dist/adapter/webgl-device.js +133 -113
  120. package/dist/adapter/webgl-device.js.map +1 -1
  121. package/dist/classic/accessor.d.ts +3 -3
  122. package/dist/classic/accessor.d.ts.map +1 -1
  123. package/dist/classic/accessor.js +14 -38
  124. package/dist/classic/accessor.js.map +1 -1
  125. package/dist/classic/{buffer.d.ts → buffer-with-accessor.d.ts} +16 -28
  126. package/dist/classic/buffer-with-accessor.d.ts.map +1 -0
  127. package/dist/classic/{buffer.js → buffer-with-accessor.js} +54 -122
  128. package/dist/classic/buffer-with-accessor.js.map +1 -0
  129. package/dist/classic/clear.d.ts +22 -0
  130. package/dist/classic/clear.d.ts.map +1 -0
  131. package/dist/classic/clear.js +88 -0
  132. package/dist/classic/clear.js.map +1 -0
  133. package/dist/classic/copy-and-blit.d.ts +62 -0
  134. package/dist/classic/copy-and-blit.d.ts.map +1 -0
  135. package/dist/classic/copy-and-blit.js +202 -0
  136. package/dist/classic/copy-and-blit.js.map +1 -0
  137. package/dist/classic/format-utils.d.ts +3 -0
  138. package/dist/classic/format-utils.d.ts.map +1 -0
  139. package/dist/classic/format-utils.js +38 -0
  140. package/dist/classic/format-utils.js.map +1 -0
  141. package/dist/classic/typed-array-utils.d.ts +15 -17
  142. package/dist/classic/typed-array-utils.d.ts.map +1 -1
  143. package/dist/classic/typed-array-utils.js +1 -21
  144. package/dist/classic/typed-array-utils.js.map +1 -1
  145. package/dist/context/context/create-browser-context.d.ts +40 -0
  146. package/dist/context/context/create-browser-context.d.ts.map +1 -0
  147. package/dist/{esm/context/context/create-context.js → context/context/create-browser-context.js} +23 -19
  148. package/dist/context/context/create-browser-context.js.map +1 -0
  149. package/dist/context/context/create-headless-context.d.ts +9 -0
  150. package/dist/context/context/create-headless-context.d.ts.map +1 -0
  151. package/dist/context/context/create-headless-context.js +42 -0
  152. package/dist/context/context/create-headless-context.js.map +1 -0
  153. package/dist/context/context/webgl-checks.js +1 -4
  154. package/dist/context/context/webgl-checks.js.map +1 -1
  155. package/dist/context/debug/spector.d.ts +1 -2
  156. package/dist/context/debug/spector.d.ts.map +1 -1
  157. package/dist/context/debug/spector.js +8 -20
  158. package/dist/context/debug/spector.js.map +1 -1
  159. package/dist/context/debug/webgl-developer-tools.d.ts +2 -2
  160. package/dist/context/debug/webgl-developer-tools.d.ts.map +1 -1
  161. package/dist/context/debug/webgl-developer-tools.js +11 -34
  162. package/dist/context/debug/webgl-developer-tools.js.map +1 -1
  163. package/dist/context/parameters/unified-parameter-api.d.ts +8 -7
  164. package/dist/context/parameters/unified-parameter-api.d.ts.map +1 -1
  165. package/dist/context/parameters/unified-parameter-api.js +8 -18
  166. package/dist/context/parameters/unified-parameter-api.js.map +1 -1
  167. package/dist/context/parameters/webgl-parameter-tables.d.ts +105 -106
  168. package/dist/context/parameters/webgl-parameter-tables.d.ts.map +1 -1
  169. package/dist/context/parameters/webgl-parameter-tables.js +18 -36
  170. package/dist/context/parameters/webgl-parameter-tables.js.map +1 -1
  171. package/dist/context/polyfill/context-data.d.ts +13 -0
  172. package/dist/context/polyfill/context-data.d.ts.map +1 -0
  173. package/dist/context/polyfill/context-data.js +12 -0
  174. package/dist/context/polyfill/context-data.js.map +1 -0
  175. package/dist/context/polyfill/get-parameter-polyfill.d.ts +1 -1
  176. package/dist/context/polyfill/get-parameter-polyfill.d.ts.map +1 -1
  177. package/dist/context/polyfill/get-parameter-polyfill.js +4 -9
  178. package/dist/context/polyfill/get-parameter-polyfill.js.map +1 -1
  179. package/dist/context/polyfill/polyfill-context.js +21 -29
  180. package/dist/context/polyfill/polyfill-context.js.map +1 -1
  181. package/dist/context/polyfill/polyfill-table.d.ts +8 -8
  182. package/dist/context/polyfill/polyfill-table.d.ts.map +1 -1
  183. package/dist/context/polyfill/polyfill-table.js +10 -32
  184. package/dist/context/polyfill/polyfill-table.js.map +1 -1
  185. package/dist/context/polyfill/polyfill-vertex-array-object.d.ts.map +1 -1
  186. package/dist/context/polyfill/polyfill-vertex-array-object.js +0 -70
  187. package/dist/context/polyfill/polyfill-vertex-array-object.js.map +1 -1
  188. package/dist/context/state-tracker/deep-array-equal.js +0 -4
  189. package/dist/context/state-tracker/deep-array-equal.js.map +1 -1
  190. package/dist/context/state-tracker/track-context-state.d.ts.map +1 -1
  191. package/dist/context/state-tracker/track-context-state.js +16 -51
  192. package/dist/context/state-tracker/track-context-state.js.map +1 -1
  193. package/dist/context/state-tracker/with-parameters.d.ts +2 -1
  194. package/dist/context/state-tracker/with-parameters.d.ts.map +1 -1
  195. package/dist/context/state-tracker/with-parameters.js +7 -9
  196. package/dist/context/state-tracker/with-parameters.js.map +1 -1
  197. package/dist/dist.dev.js +10245 -0
  198. package/dist/index.cjs +6550 -0
  199. package/dist/index.d.ts +25 -22
  200. package/dist/index.d.ts.map +1 -1
  201. package/dist/index.js +27 -26
  202. package/dist/index.js.map +1 -1
  203. package/dist/types.d.ts +3 -1
  204. package/dist/types.d.ts.map +1 -1
  205. package/dist/types.js.map +1 -1
  206. package/dist.min.js +37 -0
  207. package/package.json +21 -9
  208. package/src/adapter/converters/device-parameters.ts +88 -35
  209. package/src/adapter/converters/sampler-parameters.ts +19 -9
  210. package/src/adapter/converters/shader-formats.ts +41 -0
  211. package/src/adapter/converters/texture-formats.ts +264 -194
  212. package/src/adapter/converters/vertex-formats.ts +68 -10
  213. package/src/adapter/device-helpers/device-features.ts +10 -3
  214. package/src/adapter/device-helpers/device-limits.ts +3 -3
  215. package/src/adapter/device-helpers/get-device-info.ts +14 -10
  216. package/src/adapter/helpers/{uniforms.ts → decode-webgl-types.ts} +36 -21
  217. package/src/adapter/helpers/get-shader-info.ts +40 -0
  218. package/src/adapter/helpers/get-shader-layout.ts +120 -146
  219. package/src/adapter/helpers/parse-shader-compiler-log.ts +2 -2
  220. package/src/adapter/helpers/set-uniform.ts +7 -6
  221. package/src/adapter/helpers/{attribute-utils.ts → webgl-topology-utils.ts} +4 -5
  222. package/src/adapter/objects/constants-to-keys.ts +3 -25
  223. package/src/adapter/objects/webgl-renderbuffer.ts +40 -37
  224. package/src/adapter/objects/webgl-resource.ts +14 -23
  225. package/src/adapter/objects/webgl-vertex-array-object.ts +202 -37
  226. package/src/adapter/resources/webgl-buffer.ts +56 -58
  227. package/src/adapter/resources/webgl-command-buffer.ts +332 -25
  228. package/src/adapter/resources/webgl-command-encoder.ts +17 -12
  229. package/src/adapter/resources/webgl-external-texture.ts +2 -2
  230. package/src/adapter/resources/webgl-framebuffer.ts +88 -133
  231. package/src/adapter/resources/webgl-render-pass.ts +155 -4
  232. package/src/adapter/resources/webgl-render-pipeline.ts +232 -131
  233. package/src/adapter/resources/webgl-sampler.ts +13 -8
  234. package/src/adapter/resources/webgl-shader.ts +11 -10
  235. package/src/adapter/resources/webgl-texture.ts +113 -85
  236. package/src/adapter/webgl-canvas-context.ts +14 -14
  237. package/src/adapter/webgl-device.ts +192 -77
  238. package/src/classic/accessor.ts +4 -17
  239. package/src/classic/{buffer.ts → buffer-with-accessor.ts} +67 -75
  240. package/src/classic/clear.ts +110 -0
  241. package/src/classic/copy-and-blit.ts +308 -0
  242. package/src/classic/format-utils.ts +43 -0
  243. package/src/classic/typed-array-utils.ts +18 -27
  244. package/src/context/context/{create-context.ts → create-browser-context.ts} +48 -31
  245. package/src/context/context/create-headless-context.ts +48 -0
  246. package/src/context/context/webgl-checks.ts +1 -1
  247. package/src/context/debug/spector.ts +7 -6
  248. package/src/context/debug/webgl-developer-tools.ts +21 -15
  249. package/src/context/parameters/unified-parameter-api.ts +20 -14
  250. package/src/context/parameters/webgl-parameter-tables.ts +117 -98
  251. package/src/context/polyfill/context-data.ts +27 -0
  252. package/src/context/polyfill/get-parameter-polyfill.ts +8 -7
  253. package/src/context/polyfill/polyfill-context.ts +7 -9
  254. package/src/context/polyfill/polyfill-table.ts +18 -16
  255. package/src/context/polyfill/polyfill-vertex-array-object.ts +2 -0
  256. package/src/context/state-tracker/track-context-state.ts +14 -13
  257. package/src/context/state-tracker/with-parameters.ts +8 -2
  258. package/src/index.ts +42 -33
  259. package/src/types.ts +2 -0
  260. package/dist/adapter/converters/renderbuffer-formats.d.ts +0 -16
  261. package/dist/adapter/converters/renderbuffer-formats.d.ts.map +0 -1
  262. package/dist/adapter/converters/renderbuffer-formats.js +0 -185
  263. package/dist/adapter/converters/renderbuffer-formats.js.map +0 -1
  264. package/dist/adapter/helpers/attribute-utils.d.ts +0 -11
  265. package/dist/adapter/helpers/attribute-utils.d.ts.map +0 -1
  266. package/dist/adapter/helpers/attribute-utils.js.map +0 -1
  267. package/dist/adapter/helpers/uniforms.d.ts +0 -26
  268. package/dist/adapter/helpers/uniforms.d.ts.map +0 -1
  269. package/dist/adapter/helpers/uniforms.js.map +0 -1
  270. package/dist/bundle.d.ts +0 -2
  271. package/dist/bundle.d.ts.map +0 -1
  272. package/dist/bundle.js +0 -5
  273. package/dist/bundle.js.map +0 -1
  274. package/dist/classic/buffer.d.ts.map +0 -1
  275. package/dist/classic/buffer.js.map +0 -1
  276. package/dist/context/context/context-state.d.ts +0 -18
  277. package/dist/context/context/context-state.d.ts.map +0 -1
  278. package/dist/context/context/context-state.js +0 -26
  279. package/dist/context/context/context-state.js.map +0 -1
  280. package/dist/context/context/create-context.d.ts +0 -41
  281. package/dist/context/context/create-context.d.ts.map +0 -1
  282. package/dist/context/context/create-context.js +0 -49
  283. package/dist/context/context/create-context.js.map +0 -1
  284. package/dist/context/context/device-pixels.d.ts +0 -25
  285. package/dist/context/context/device-pixels.d.ts.map +0 -1
  286. package/dist/context/context/device-pixels.js +0 -98
  287. package/dist/context/context/device-pixels.js.map +0 -1
  288. package/dist/es5/adapter/converters/device-parameters.js +0 -170
  289. package/dist/es5/adapter/converters/device-parameters.js.map +0 -1
  290. package/dist/es5/adapter/converters/renderbuffer-formats.js +0 -163
  291. package/dist/es5/adapter/converters/renderbuffer-formats.js.map +0 -1
  292. package/dist/es5/adapter/converters/sampler-parameters.js +0 -226
  293. package/dist/es5/adapter/converters/sampler-parameters.js.map +0 -1
  294. package/dist/es5/adapter/converters/texture-formats.js +0 -1031
  295. package/dist/es5/adapter/converters/texture-formats.js.map +0 -1
  296. package/dist/es5/adapter/converters/vertex-formats.js +0 -45
  297. package/dist/es5/adapter/converters/vertex-formats.js.map +0 -1
  298. package/dist/es5/adapter/device-helpers/device-features.js +0 -144
  299. package/dist/es5/adapter/device-helpers/device-features.js.map +0 -1
  300. package/dist/es5/adapter/device-helpers/device-limits.js +0 -64
  301. package/dist/es5/adapter/device-helpers/device-limits.js.map +0 -1
  302. package/dist/es5/adapter/device-helpers/get-device-info.js +0 -55
  303. package/dist/es5/adapter/device-helpers/get-device-info.js.map +0 -1
  304. package/dist/es5/adapter/device-helpers/is-old-ie.js +0 -16
  305. package/dist/es5/adapter/device-helpers/is-old-ie.js.map +0 -1
  306. package/dist/es5/adapter/helpers/attribute-utils.js +0 -91
  307. package/dist/es5/adapter/helpers/attribute-utils.js.map +0 -1
  308. package/dist/es5/adapter/helpers/get-shader-layout.js +0 -371
  309. package/dist/es5/adapter/helpers/get-shader-layout.js.map +0 -1
  310. package/dist/es5/adapter/helpers/parse-shader-compiler-log.js +0 -72
  311. package/dist/es5/adapter/helpers/parse-shader-compiler-log.js.map +0 -1
  312. package/dist/es5/adapter/helpers/set-uniform.js +0 -125
  313. package/dist/es5/adapter/helpers/set-uniform.js.map +0 -1
  314. package/dist/es5/adapter/helpers/uniforms.js +0 -112
  315. package/dist/es5/adapter/helpers/uniforms.js.map +0 -1
  316. package/dist/es5/adapter/objects/constants-to-keys.js +0 -54
  317. package/dist/es5/adapter/objects/constants-to-keys.js.map +0 -1
  318. package/dist/es5/adapter/objects/webgl-renderbuffer.js +0 -150
  319. package/dist/es5/adapter/objects/webgl-renderbuffer.js.map +0 -1
  320. package/dist/es5/adapter/objects/webgl-resource.js +0 -292
  321. package/dist/es5/adapter/objects/webgl-resource.js.map +0 -1
  322. package/dist/es5/adapter/objects/webgl-vertex-array-object.js +0 -137
  323. package/dist/es5/adapter/objects/webgl-vertex-array-object.js.map +0 -1
  324. package/dist/es5/adapter/resources/webgl-buffer.js +0 -243
  325. package/dist/es5/adapter/resources/webgl-buffer.js.map +0 -1
  326. package/dist/es5/adapter/resources/webgl-command-buffer.js +0 -96
  327. package/dist/es5/adapter/resources/webgl-command-buffer.js.map +0 -1
  328. package/dist/es5/adapter/resources/webgl-command-encoder.js +0 -98
  329. package/dist/es5/adapter/resources/webgl-command-encoder.js.map +0 -1
  330. package/dist/es5/adapter/resources/webgl-external-texture.js +0 -2
  331. package/dist/es5/adapter/resources/webgl-external-texture.js.map +0 -1
  332. package/dist/es5/adapter/resources/webgl-framebuffer.js +0 -345
  333. package/dist/es5/adapter/resources/webgl-framebuffer.js.map +0 -1
  334. package/dist/es5/adapter/resources/webgl-render-pass.js +0 -61
  335. package/dist/es5/adapter/resources/webgl-render-pass.js.map +0 -1
  336. package/dist/es5/adapter/resources/webgl-render-pipeline.js +0 -505
  337. package/dist/es5/adapter/resources/webgl-render-pipeline.js.map +0 -1
  338. package/dist/es5/adapter/resources/webgl-sampler.js +0 -96
  339. package/dist/es5/adapter/resources/webgl-sampler.js.map +0 -1
  340. package/dist/es5/adapter/resources/webgl-shader.js +0 -149
  341. package/dist/es5/adapter/resources/webgl-shader.js.map +0 -1
  342. package/dist/es5/adapter/resources/webgl-texture.js +0 -986
  343. package/dist/es5/adapter/resources/webgl-texture.js.map +0 -1
  344. package/dist/es5/adapter/webgl-canvas-context.js +0 -97
  345. package/dist/es5/adapter/webgl-canvas-context.js.map +0 -1
  346. package/dist/es5/adapter/webgl-device.js +0 -399
  347. package/dist/es5/adapter/webgl-device.js.map +0 -1
  348. package/dist/es5/bundle.js +0 -7
  349. package/dist/es5/bundle.js.map +0 -1
  350. package/dist/es5/classic/accessor.js +0 -181
  351. package/dist/es5/classic/accessor.js.map +0 -1
  352. package/dist/es5/classic/buffer.js +0 -470
  353. package/dist/es5/classic/buffer.js.map +0 -1
  354. package/dist/es5/classic/typed-array-utils.js +0 -126
  355. package/dist/es5/classic/typed-array-utils.js.map +0 -1
  356. package/dist/es5/context/context/context-state.js +0 -31
  357. package/dist/es5/context/context/context-state.js.map +0 -1
  358. package/dist/es5/context/context/create-context.js +0 -69
  359. package/dist/es5/context/context/create-context.js.map +0 -1
  360. package/dist/es5/context/context/device-pixels.js +0 -115
  361. package/dist/es5/context/context/device-pixels.js.map +0 -1
  362. package/dist/es5/context/context/webgl-checks.js +0 -54
  363. package/dist/es5/context/context/webgl-checks.js.map +0 -1
  364. package/dist/es5/context/debug/spector.js +0 -133
  365. package/dist/es5/context/debug/spector.js.map +0 -1
  366. package/dist/es5/context/debug/webgl-developer-tools.js +0 -198
  367. package/dist/es5/context/debug/webgl-developer-tools.js.map +0 -1
  368. package/dist/es5/context/parameters/unified-parameter-api.js +0 -97
  369. package/dist/es5/context/parameters/unified-parameter-api.js.map +0 -1
  370. package/dist/es5/context/parameters/webgl-parameter-tables.js +0 -392
  371. package/dist/es5/context/parameters/webgl-parameter-tables.js.map +0 -1
  372. package/dist/es5/context/polyfill/get-parameter-polyfill.js +0 -81
  373. package/dist/es5/context/polyfill/get-parameter-polyfill.js.map +0 -1
  374. package/dist/es5/context/polyfill/polyfill-context.js +0 -135
  375. package/dist/es5/context/polyfill/polyfill-context.js.map +0 -1
  376. package/dist/es5/context/polyfill/polyfill-table.js +0 -166
  377. package/dist/es5/context/polyfill/polyfill-table.js.map +0 -1
  378. package/dist/es5/context/polyfill/polyfill-vertex-array-object.js +0 -341
  379. package/dist/es5/context/polyfill/polyfill-vertex-array-object.js.map +0 -1
  380. package/dist/es5/context/state-tracker/deep-array-equal.js +0 -28
  381. package/dist/es5/context/state-tracker/deep-array-equal.js.map +0 -1
  382. package/dist/es5/context/state-tracker/track-context-state.js +0 -211
  383. package/dist/es5/context/state-tracker/track-context-state.js.map +0 -1
  384. package/dist/es5/context/state-tracker/with-parameters.js +0 -44
  385. package/dist/es5/context/state-tracker/with-parameters.js.map +0 -1
  386. package/dist/es5/index.js +0 -276
  387. package/dist/es5/index.js.map +0 -1
  388. package/dist/es5/init.js +0 -10
  389. package/dist/es5/init.js.map +0 -1
  390. package/dist/es5/types/webgl.js +0 -6
  391. package/dist/es5/types/webgl.js.map +0 -1
  392. package/dist/es5/types.js +0 -2
  393. package/dist/es5/types.js.map +0 -1
  394. package/dist/esm/adapter/converters/device-parameters.js +0 -155
  395. package/dist/esm/adapter/converters/device-parameters.js.map +0 -1
  396. package/dist/esm/adapter/converters/renderbuffer-formats.js +0 -185
  397. package/dist/esm/adapter/converters/renderbuffer-formats.js.map +0 -1
  398. package/dist/esm/adapter/converters/sampler-parameters.js +0 -208
  399. package/dist/esm/adapter/converters/sampler-parameters.js.map +0 -1
  400. package/dist/esm/adapter/converters/texture-formats.js +0 -954
  401. package/dist/esm/adapter/converters/texture-formats.js.map +0 -1
  402. package/dist/esm/adapter/converters/vertex-formats.js +0 -35
  403. package/dist/esm/adapter/converters/vertex-formats.js.map +0 -1
  404. package/dist/esm/adapter/device-helpers/device-features.js +0 -102
  405. package/dist/esm/adapter/device-helpers/device-features.js.map +0 -1
  406. package/dist/esm/adapter/device-helpers/device-limits.js +0 -91
  407. package/dist/esm/adapter/device-helpers/device-limits.js.map +0 -1
  408. package/dist/esm/adapter/device-helpers/get-device-info.js +0 -44
  409. package/dist/esm/adapter/device-helpers/get-device-info.js.map +0 -1
  410. package/dist/esm/adapter/device-helpers/is-old-ie.js +0 -8
  411. package/dist/esm/adapter/device-helpers/is-old-ie.js.map +0 -1
  412. package/dist/esm/adapter/helpers/attribute-utils.js +0 -81
  413. package/dist/esm/adapter/helpers/attribute-utils.js.map +0 -1
  414. package/dist/esm/adapter/helpers/get-shader-layout.js +0 -306
  415. package/dist/esm/adapter/helpers/get-shader-layout.js.map +0 -1
  416. package/dist/esm/adapter/helpers/parse-shader-compiler-log.js +0 -37
  417. package/dist/esm/adapter/helpers/parse-shader-compiler-log.js.map +0 -1
  418. package/dist/esm/adapter/helpers/set-uniform.js +0 -115
  419. package/dist/esm/adapter/helpers/set-uniform.js.map +0 -1
  420. package/dist/esm/adapter/helpers/uniforms.js +0 -99
  421. package/dist/esm/adapter/helpers/uniforms.js.map +0 -1
  422. package/dist/esm/adapter/objects/constants-to-keys.js +0 -42
  423. package/dist/esm/adapter/objects/constants-to-keys.js.map +0 -1
  424. package/dist/esm/adapter/objects/webgl-renderbuffer.js +0 -94
  425. package/dist/esm/adapter/objects/webgl-renderbuffer.js.map +0 -1
  426. package/dist/esm/adapter/objects/webgl-resource.js +0 -216
  427. package/dist/esm/adapter/objects/webgl-resource.js.map +0 -1
  428. package/dist/esm/adapter/objects/webgl-vertex-array-object.js +0 -84
  429. package/dist/esm/adapter/objects/webgl-vertex-array-object.js.map +0 -1
  430. package/dist/esm/adapter/resources/webgl-buffer.js +0 -164
  431. package/dist/esm/adapter/resources/webgl-buffer.js.map +0 -1
  432. package/dist/esm/adapter/resources/webgl-command-buffer.js +0 -65
  433. package/dist/esm/adapter/resources/webgl-command-buffer.js.map +0 -1
  434. package/dist/esm/adapter/resources/webgl-command-encoder.js +0 -53
  435. package/dist/esm/adapter/resources/webgl-command-encoder.js.map +0 -1
  436. package/dist/esm/adapter/resources/webgl-external-texture.js +0 -2
  437. package/dist/esm/adapter/resources/webgl-external-texture.js.map +0 -1
  438. package/dist/esm/adapter/resources/webgl-framebuffer.js +0 -265
  439. package/dist/esm/adapter/resources/webgl-framebuffer.js.map +0 -1
  440. package/dist/esm/adapter/resources/webgl-render-pass.js +0 -19
  441. package/dist/esm/adapter/resources/webgl-render-pass.js.map +0 -1
  442. package/dist/esm/adapter/resources/webgl-render-pipeline.js +0 -400
  443. package/dist/esm/adapter/resources/webgl-render-pipeline.js.map +0 -1
  444. package/dist/esm/adapter/resources/webgl-sampler.js +0 -50
  445. package/dist/esm/adapter/resources/webgl-sampler.js.map +0 -1
  446. package/dist/esm/adapter/resources/webgl-shader.js +0 -75
  447. package/dist/esm/adapter/resources/webgl-shader.js.map +0 -1
  448. package/dist/esm/adapter/resources/webgl-texture.js +0 -831
  449. package/dist/esm/adapter/resources/webgl-texture.js.map +0 -1
  450. package/dist/esm/adapter/webgl-canvas-context.js +0 -54
  451. package/dist/esm/adapter/webgl-canvas-context.js.map +0 -1
  452. package/dist/esm/adapter/webgl-device.js +0 -280
  453. package/dist/esm/adapter/webgl-device.js.map +0 -1
  454. package/dist/esm/bundle.js +0 -5
  455. package/dist/esm/bundle.js.map +0 -1
  456. package/dist/esm/classic/accessor.js +0 -144
  457. package/dist/esm/classic/accessor.js.map +0 -1
  458. package/dist/esm/classic/buffer.js +0 -384
  459. package/dist/esm/classic/buffer.js.map +0 -1
  460. package/dist/esm/classic/typed-array-utils.js +0 -112
  461. package/dist/esm/classic/typed-array-utils.js.map +0 -1
  462. package/dist/esm/context/context/context-state.js +0 -26
  463. package/dist/esm/context/context/context-state.js.map +0 -1
  464. package/dist/esm/context/context/create-context.js.map +0 -1
  465. package/dist/esm/context/context/device-pixels.js +0 -98
  466. package/dist/esm/context/context/device-pixels.js.map +0 -1
  467. package/dist/esm/context/context/webgl-checks.js +0 -34
  468. package/dist/esm/context/context/webgl-checks.js.map +0 -1
  469. package/dist/esm/context/debug/spector.js +0 -76
  470. package/dist/esm/context/debug/spector.js.map +0 -1
  471. package/dist/esm/context/debug/webgl-developer-tools.js +0 -121
  472. package/dist/esm/context/debug/webgl-developer-tools.js.map +0 -1
  473. package/dist/esm/context/parameters/unified-parameter-api.js +0 -65
  474. package/dist/esm/context/parameters/unified-parameter-api.js.map +0 -1
  475. package/dist/esm/context/parameters/webgl-parameter-tables.js +0 -445
  476. package/dist/esm/context/parameters/webgl-parameter-tables.js.map +0 -1
  477. package/dist/esm/context/polyfill/get-parameter-polyfill.js +0 -91
  478. package/dist/esm/context/polyfill/get-parameter-polyfill.js.map +0 -1
  479. package/dist/esm/context/polyfill/polyfill-context.js +0 -92
  480. package/dist/esm/context/polyfill/polyfill-context.js.map +0 -1
  481. package/dist/esm/context/polyfill/polyfill-table.js +0 -160
  482. package/dist/esm/context/polyfill/polyfill-table.js.map +0 -1
  483. package/dist/esm/context/polyfill/polyfill-vertex-array-object.js +0 -335
  484. package/dist/esm/context/polyfill/polyfill-vertex-array-object.js.map +0 -1
  485. package/dist/esm/context/state-tracker/deep-array-equal.js +0 -21
  486. package/dist/esm/context/state-tracker/deep-array-equal.js.map +0 -1
  487. package/dist/esm/context/state-tracker/track-context-state.js +0 -183
  488. package/dist/esm/context/state-tracker/track-context-state.js.map +0 -1
  489. package/dist/esm/context/state-tracker/with-parameters.js +0 -36
  490. package/dist/esm/context/state-tracker/with-parameters.js.map +0 -1
  491. package/dist/esm/index.js +0 -27
  492. package/dist/esm/index.js.map +0 -1
  493. package/dist/esm/init.js +0 -4
  494. package/dist/esm/init.js.map +0 -1
  495. package/dist/esm/types/webgl.js +0 -2
  496. package/dist/esm/types/webgl.js.map +0 -1
  497. package/dist/esm/types.js +0 -2
  498. package/dist/esm/types.js.map +0 -1
  499. package/dist/init.d.ts +0 -2
  500. package/dist/init.d.ts.map +0 -1
  501. package/dist/init.js +0 -4
  502. package/dist/init.js.map +0 -1
  503. package/dist/types/webgl.d.ts +0 -144
  504. package/dist/types/webgl.d.ts.map +0 -1
  505. package/dist/types/webgl.js +0 -2
  506. package/dist/types/webgl.js.map +0 -1
  507. package/src/adapter/converters/renderbuffer-formats.ts +0 -92
  508. package/src/bundle.ts +0 -4
  509. package/src/context/context/context-state.ts +0 -41
  510. package/src/context/context/device-pixels.ts +0 -152
  511. package/src/init.ts +0 -4
  512. package/src/types/webgl.ts +0 -283
@@ -0,0 +1,308 @@
1
+ // luma.gl, MIT license
2
+ import {assert, Texture, Framebuffer, FramebufferProps} from '@luma.gl/core';
3
+ import {GL} from '@luma.gl/constants';
4
+
5
+ import {BufferWithAccessor as Buffer} from './buffer-with-accessor';
6
+ import {WEBGLTexture} from '../adapter/resources/webgl-texture';
7
+ import {WEBGLFramebuffer} from '../adapter/resources/webgl-framebuffer';
8
+ import {withParameters} from '../context/state-tracker/with-parameters';
9
+ import {getGLTypeFromTypedArray, getTypedArrayFromGLType} from './typed-array-utils';
10
+ import {glFormatToComponents, glTypeToBytes} from './format-utils';
11
+
12
+ /**
13
+ * Copies data from a type or a Texture object into ArrayBuffer object.
14
+ * App can provide targetPixelArray or have it auto allocated by this method
15
+ * newly allocated by this method unless provided by app.
16
+ * @deprecated Use CommandEncoder.copyTextureToBuffer and Buffer.read
17
+ * @note Slow requires roundtrip to GPU
18
+ *
19
+ * @param source
20
+ * @param options
21
+ * @returns pixel array,
22
+ */
23
+ export function readPixelsToArray(
24
+ source: Framebuffer | Texture,
25
+ options?: {
26
+ sourceX?: number;
27
+ sourceY?: number;
28
+ sourceFormat?: number;
29
+ sourceAttachment?: number;
30
+ target?: Uint8Array | Uint16Array | Float32Array;
31
+ // following parameters are auto deduced if not provided
32
+ sourceWidth?: number;
33
+ sourceHeight?: number;
34
+ sourceType?: number;
35
+ }
36
+ ): Uint8Array | Uint16Array | Float32Array {
37
+ const {sourceX = 0, sourceY = 0, sourceFormat = GL.RGBA} = options || {};
38
+ let {
39
+ sourceAttachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer
40
+ target = null,
41
+ // following parameters are auto deduced if not provided
42
+ sourceWidth,
43
+ sourceHeight,
44
+ sourceType
45
+ } = options || {};
46
+
47
+ const {framebuffer, deleteFramebuffer} = getFramebuffer(source);
48
+ assert(framebuffer);
49
+ const {gl, handle} = framebuffer as WEBGLFramebuffer;
50
+ sourceWidth = sourceWidth || framebuffer.width;
51
+ sourceHeight = sourceHeight || framebuffer.height;
52
+
53
+ // TODO - Set and unset gl.readBuffer
54
+ if (sourceAttachment === GL.COLOR_ATTACHMENT0 && handle === null) {
55
+ sourceAttachment = GL.FRONT;
56
+ }
57
+
58
+ const attachment = sourceAttachment - GL.COLOR_ATTACHMENT0;
59
+ // assert(attachments[sourceAttachment]);
60
+
61
+ // Deduce the type from color attachment if not provided.
62
+ sourceType = sourceType || (framebuffer.colorAttachments[attachment] as WEBGLTexture).type;
63
+
64
+ // Deduce type and allocated pixelArray if needed
65
+ target = getPixelArray(target, sourceType, sourceFormat, sourceWidth, sourceHeight);
66
+
67
+ // Pixel array available, if necessary, deduce type from it.
68
+ sourceType = sourceType || getGLTypeFromTypedArray(target);
69
+
70
+ const prevHandle = gl.bindFramebuffer(GL.FRAMEBUFFER, handle);
71
+ gl.readPixels(sourceX, sourceY, sourceWidth, sourceHeight, sourceFormat, sourceType, target);
72
+ // @ts-expect-error
73
+ gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);
74
+ if (deleteFramebuffer) {
75
+ framebuffer.destroy();
76
+ }
77
+ return target;
78
+ }
79
+
80
+ /**
81
+ * Copies data from a Framebuffer or a Texture object into a Buffer object.
82
+ * NOTE: doesn't wait for copy to be complete, it programs GPU to perform a DMA transffer.
83
+ * @deprecated Use CommandEncoder
84
+ * @param source
85
+ * @param options
86
+ */
87
+ export function readPixelsToBuffer(
88
+ source: Framebuffer | Texture,
89
+ options?: {
90
+ sourceX?: number;
91
+ sourceY?: number;
92
+ sourceFormat?: number;
93
+ target?: Buffer; // A new Buffer object is created when not provided.
94
+ targetByteOffset?: number; // byte offset in buffer object
95
+ // following parameters are auto deduced if not provided
96
+ sourceWidth?: number;
97
+ sourceHeight?: number;
98
+ sourceType?: number;
99
+ }
100
+ ): Buffer {
101
+ const {sourceX = 0, sourceY = 0, sourceFormat = GL.RGBA, targetByteOffset = 0} = options || {};
102
+ // following parameters are auto deduced if not provided
103
+ let {target, sourceWidth, sourceHeight, sourceType} = options || {};
104
+ const {framebuffer, deleteFramebuffer} = getFramebuffer(source);
105
+ assert(framebuffer);
106
+ sourceWidth = sourceWidth || framebuffer.width;
107
+ sourceHeight = sourceHeight || framebuffer.height;
108
+
109
+ // Asynchronous read (PIXEL_PACK_BUFFER) is WebGL2 only feature
110
+ const webglFramebuffer = framebuffer as WEBGLFramebuffer;
111
+ const gl2 = webglFramebuffer.device.assertWebGL2();
112
+
113
+ // deduce type if not available.
114
+ sourceType = sourceType || (target ? target.type : GL.UNSIGNED_BYTE);
115
+
116
+ if (!target) {
117
+ // Create new buffer with enough size
118
+ const components = glFormatToComponents(sourceFormat);
119
+ const byteCount = glTypeToBytes(sourceType);
120
+ const byteLength = targetByteOffset + sourceWidth * sourceHeight * components * byteCount;
121
+ target = new Buffer(gl2, {byteLength, accessor: {type: sourceType, size: components}});
122
+ }
123
+
124
+ target.bind({glTarget: GL.PIXEL_PACK_BUFFER});
125
+ withParameters(gl2, {framebuffer}, () => {
126
+ gl2.readPixels(
127
+ sourceX,
128
+ sourceY,
129
+ sourceWidth,
130
+ sourceHeight,
131
+ sourceFormat,
132
+ sourceType,
133
+ targetByteOffset
134
+ );
135
+ });
136
+ target.unbind({glTarget: GL.PIXEL_PACK_BUFFER});
137
+ if (deleteFramebuffer) {
138
+ framebuffer.destroy();
139
+ }
140
+
141
+ return target;
142
+ }
143
+
144
+ /**
145
+ * Copy a rectangle from a Framebuffer or Texture object into a texture (at an offset)
146
+ * @deprecated Use CommandEncoder
147
+ */
148
+ // eslint-disable-next-line complexity, max-statements
149
+ export function copyToTexture(
150
+ source: Framebuffer | Texture,
151
+ target: Texture | GL,
152
+ options?: {
153
+ sourceX?: number;
154
+ sourceY?: number;
155
+
156
+ targetX?: number;
157
+ targetY?: number;
158
+ targetZ?: number;
159
+ targetMipmaplevel?: number;
160
+ targetInternalFormat?: number;
161
+
162
+ width?: number; // defaults to target width
163
+ height?: number; // defaults to target height
164
+ }
165
+ ): Texture {
166
+ const {
167
+ sourceX = 0,
168
+ sourceY = 0,
169
+ // attachment = GL.COLOR_ATTACHMENT0, // TODO - support gl.readBuffer
170
+ targetMipmaplevel = 0,
171
+ targetInternalFormat = GL.RGBA
172
+ } = options || {};
173
+ let {
174
+ targetX,
175
+ targetY,
176
+ targetZ,
177
+ width, // defaults to target width
178
+ height // defaults to target height
179
+ } = options || {};
180
+
181
+ const {framebuffer, deleteFramebuffer} = getFramebuffer(source);
182
+ assert(framebuffer);
183
+ const webglFramebuffer = framebuffer as WEBGLFramebuffer;
184
+ const {device, handle} = webglFramebuffer;
185
+ const isSubCopy =
186
+ typeof targetX !== 'undefined' ||
187
+ typeof targetY !== 'undefined' ||
188
+ typeof targetZ !== 'undefined';
189
+ targetX = targetX || 0;
190
+ targetY = targetY || 0;
191
+ targetZ = targetZ || 0;
192
+ const prevHandle = device.gl.bindFramebuffer(GL.FRAMEBUFFER, handle);
193
+ // TODO - support gl.readBuffer (WebGL2 only)
194
+ // const prevBuffer = gl.readBuffer(attachment);
195
+ assert(target);
196
+ let texture = null;
197
+ let textureTarget: GL;
198
+ if (target instanceof Texture) {
199
+ texture = target;
200
+ width = Number.isFinite(width) ? width : texture.width;
201
+ height = Number.isFinite(height) ? height : texture.height;
202
+ texture.bind(0);
203
+ textureTarget = texture.target;
204
+ } else {
205
+ textureTarget = target;
206
+ }
207
+
208
+ if (!isSubCopy) {
209
+ device.gl.copyTexImage2D(
210
+ textureTarget,
211
+ targetMipmaplevel,
212
+ targetInternalFormat,
213
+ sourceX,
214
+ sourceY,
215
+ width,
216
+ height,
217
+ 0 /* border must be 0 */
218
+ );
219
+ } else {
220
+ switch (textureTarget) {
221
+ case GL.TEXTURE_2D:
222
+ case GL.TEXTURE_CUBE_MAP:
223
+ device.gl.copyTexSubImage2D(
224
+ textureTarget,
225
+ targetMipmaplevel,
226
+ targetX,
227
+ targetY,
228
+ sourceX,
229
+ sourceY,
230
+ width,
231
+ height
232
+ );
233
+ break;
234
+ case GL.TEXTURE_2D_ARRAY:
235
+ case GL.TEXTURE_3D:
236
+ device.assertWebGL2();
237
+ device.gl2.copyTexSubImage3D(
238
+ textureTarget,
239
+ targetMipmaplevel,
240
+ targetX,
241
+ targetY,
242
+ targetZ,
243
+ sourceX,
244
+ sourceY,
245
+ width,
246
+ height
247
+ );
248
+ break;
249
+ default:
250
+ }
251
+ }
252
+ if (texture) {
253
+ texture.unbind();
254
+ }
255
+ // @ts-expect-error
256
+ gl.bindFramebuffer(GL.FRAMEBUFFER, prevHandle || null);
257
+ if (deleteFramebuffer) {
258
+ framebuffer.destroy();
259
+ }
260
+ return texture;
261
+ }
262
+
263
+ function getFramebuffer(source: Texture | Framebuffer): {
264
+ framebuffer: Framebuffer;
265
+ deleteFramebuffer: boolean;
266
+ } {
267
+ if (!(source instanceof Framebuffer)) {
268
+ return {framebuffer: toFramebuffer(source), deleteFramebuffer: true};
269
+ }
270
+ return {framebuffer: source, deleteFramebuffer: false};
271
+ }
272
+
273
+ /**
274
+ * Wraps a given texture into a framebuffer object, that can be further used
275
+ * to read data from the texture object.
276
+ */
277
+ export function toFramebuffer(texture: Texture, props?: FramebufferProps): Framebuffer {
278
+ const {device, width, height, id} = texture;
279
+ const framebuffer = device.createFramebuffer({
280
+ ...props,
281
+ id: `framebuffer-for-${id}`,
282
+ width,
283
+ height,
284
+ colorAttachments: [
285
+ texture
286
+ ]
287
+ }
288
+ );
289
+ return framebuffer;
290
+ }
291
+
292
+ function getPixelArray(
293
+ pixelArray,
294
+ type,
295
+ format,
296
+ width: number,
297
+ height: number
298
+ ): Uint8Array | Uint16Array | Float32Array {
299
+ if (pixelArray) {
300
+ return pixelArray;
301
+ }
302
+ // Allocate pixel array if not already available, using supplied type
303
+ type = type || GL.UNSIGNED_BYTE;
304
+ const ArrayType = getTypedArrayFromGLType(type, {clamped: false});
305
+ const components = glFormatToComponents(format);
306
+ // TODO - check for composite type (components = 1).
307
+ return new ArrayType(width * height * components) as Uint8Array | Uint16Array | Float32Array;
308
+ }
@@ -0,0 +1,43 @@
1
+ import {assert} from '@luma.gl/core';
2
+ import {GL} from '@luma.gl/constants';
3
+
4
+ // Returns number of components in a specific readPixels WebGL format
5
+ export function glFormatToComponents(format) {
6
+ switch (format) {
7
+ case GL.ALPHA:
8
+ case GL.R32F:
9
+ case GL.RED:
10
+ return 1;
11
+ case GL.RG32F:
12
+ case GL.RG:
13
+ return 2;
14
+ case GL.RGB:
15
+ case GL.RGB32F:
16
+ return 3;
17
+ case GL.RGBA:
18
+ case GL.RGBA32F:
19
+ return 4;
20
+ // TODO: Add support for additional WebGL2 formats
21
+ default:
22
+ assert(false);
23
+ return 0;
24
+ }
25
+ }
26
+
27
+ // Return byte count for given readPixels WebGL type
28
+ export function glTypeToBytes(type) {
29
+ switch (type) {
30
+ case GL.UNSIGNED_BYTE:
31
+ return 1;
32
+ case GL.UNSIGNED_SHORT_5_6_5:
33
+ case GL.UNSIGNED_SHORT_4_4_4_4:
34
+ case GL.UNSIGNED_SHORT_5_5_5_1:
35
+ return 2;
36
+ case GL.FLOAT:
37
+ return 4;
38
+ // TODO: Add support for additional WebGL2 types
39
+ default:
40
+ assert(false);
41
+ return 0;
42
+ }
43
+ }
@@ -1,26 +1,17 @@
1
- import {TypedArray} from '@luma.gl/api/types';
2
- import GL from '@luma.gl/constants';
3
- import {GLType} from '../types/webgl'
1
+ // luma.gl, MIT license
4
2
 
5
- const ERR_TYPE_DEDUCTION = 'Failed to deduce GL constant from typed array';
3
+ import {TypedArray, TypedArrayConstructor} from '@luma.gl/core';
4
+ import {GL, GLDataType, GLPixelType} from '@luma.gl/constants';
6
5
 
7
- type TypedArrayConstructor =
8
- | Float32ArrayConstructor
9
- | Uint16ArrayConstructor
10
- | Uint32ArrayConstructor
11
- | Uint8ArrayConstructor
12
- | Uint8ClampedArrayConstructor
13
- | Int8ArrayConstructor
14
- | Int16ArrayConstructor
15
- | Int32ArrayConstructor;
6
+ const ERR_TYPE_DEDUCTION = 'Failed to deduce GL constant from typed array';
16
7
 
17
8
  /**
18
9
  * Converts TYPED ARRAYS to corresponding GL constant
19
10
  * Used to auto deduce gl parameter types
20
- * @param {*} arrayOrType
11
+ * @param arrayOrType
21
12
  * @returns
22
13
  */
23
- export function getGLTypeFromTypedArray(arrayOrType: TypedArray): GLType {
14
+ export function getGLTypeFromTypedArray(arrayOrType: TypedArray): GLDataType {
24
15
  // If typed array, look up constructor
25
16
  const type = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;
26
17
  switch (type) {
@@ -48,13 +39,13 @@ export function getGLTypeFromTypedArray(arrayOrType: TypedArray): GLType {
48
39
  /**
49
40
  * Converts GL constant to corresponding TYPED ARRAY
50
41
  * Used to auto deduce gl parameter types
51
- * @param {*} glType
52
- * @param {*} param1
42
+ * @param glType
43
+ * @param param1
53
44
  * @returns
54
45
  */
55
46
  // eslint-disable-next-line complexity
56
47
  export function getTypedArrayFromGLType(
57
- glType: any,
48
+ glType: GLDataType | GLPixelType,
58
49
  options?: {
59
50
  clamped?: boolean;
60
51
  }
@@ -88,14 +79,14 @@ export function getTypedArrayFromGLType(
88
79
  * Flip rows (can be used on arrays returned from `Framebuffer.readPixels`)
89
80
  * https: *stackoverflow.com/questions/41969562/
90
81
  * how-can-i-flip-the-result-of-webglrenderingcontext-readpixels
91
- * @param {*} param0
82
+ * @param param0
92
83
  */
93
- export function flipRows(options: {
94
- data: any;
95
- width: any;
96
- height: any;
84
+ export function flipRows(options: {
85
+ data: TypedArray;
86
+ width: number;
87
+ height: number;
97
88
  bytesPerPixel?: number;
98
- temp?: any;
89
+ temp?: Uint8Array;
99
90
  }): void {
100
91
  const {data, width, height, bytesPerPixel = 4, temp} = options;
101
92
  const bytesPerRow = width * bytesPerPixel;
@@ -116,9 +107,9 @@ export function getTypedArrayFromGLType(
116
107
 
117
108
 
118
109
  export function scalePixels(options: {
119
- data: any;
120
- width: any;
121
- height: any;
110
+ data: TypedArray;
111
+ width: number;
112
+ height: number;
122
113
  }): {
123
114
  data: Uint8Array;
124
115
  width: number;
@@ -2,21 +2,21 @@
2
2
 
3
3
  /**
4
4
  * ContextProps
5
- * @param webgl2 Set to false to not create a WebGL2 context (force webgl1)
6
- * @param webgl1 set to false to not create a WebGL1 context (fail if webgl2 not available)
7
- * @param onContextLost
8
- * @param onContextRestored
9
- *
10
- * BROWSER CONTEXT PARAMETERS
11
- * @param debug Instrument context (at the expense of performance).
12
- * @param alpha Default render target has an alpha buffer.
13
- * @param depth Default render target has a depth buffer of at least 16 bits.
14
- * @param stencil Default render target has a stencil buffer of at least 8 bits.
15
- * @param antialias Boolean that indicates whether or not to perform anti-aliasing.
16
- * @param premultipliedAlpha Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
17
- * @param preserveDrawingBuffer Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten
18
- * @param failIfMajorPerformanceCaveat Do not create if the system performance is low.
19
- */
5
+ * @param webgl2 Set to false to not create a WebGL2 context (force webgl1)
6
+ * @param webgl1 set to false to not create a WebGL1 context (fail if webgl2 not available)
7
+ * @param onContextLost
8
+ * @param onContextRestored
9
+ *
10
+ * BROWSER CONTEXT PARAMETERS
11
+ * @param debug Instrument context (at the expense of performance).
12
+ * @param alpha Default render target has an alpha buffer.
13
+ * @param depth Default render target has a depth buffer of at least 16 bits.
14
+ * @param stencil Default render target has a stencil buffer of at least 8 bits.
15
+ * @param antialias Boolean that indicates whether or not to perform anti-aliasing.
16
+ * @param premultipliedAlpha Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
17
+ * @param preserveDrawingBuffer Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten
18
+ * @param failIfMajorPerformanceCaveat Do not create if the system performance is low.
19
+ */
20
20
  type ContextProps = {
21
21
  type?: 'webgl' | 'webgl1' | 'webgl2' | string;
22
22
  webgl1?: boolean;
@@ -27,35 +27,40 @@ type ContextProps = {
27
27
  desynchronized?: boolean; // hints the user agent to reduce the latency by desynchronizing the canvas paint cycle from the event loop
28
28
  antialias?: boolean; // indicates whether or not to perform anti-aliasing.
29
29
  depth?: boolean; // indicates that the drawing buffer has a depth buffer of at least 16 bits.
30
- failIfMajorPerformanceCaveat?: boolean, // indicates if a context will be created if the system performance is low or if no hardware GPU is available.
31
- powerPreference?: 'default' | 'high-performance' | 'low-power',
32
- premultipliedAlpha?: boolean, // page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
33
- preserveDrawingBuffer?: boolean // buffers will not be cleared and will preserve their values until cleared or overwritten by the author.
30
+ failIfMajorPerformanceCaveat?: boolean; // indicates if a context will be created if the system performance is low or if no hardware GPU is available.
31
+ powerPreference?: 'default' | 'high-performance' | 'low-power';
32
+ premultipliedAlpha?: boolean; // page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
33
+ preserveDrawingBuffer?: boolean; // buffers will not be cleared and will preserve their values until cleared or overwritten by the author.
34
34
  };
35
35
 
36
36
  const DEFAULT_CONTEXT_PROPS: ContextProps = {
37
37
  webgl2: true, // Attempt to create a WebGL2 context
38
38
  webgl1: true, // Attempt to create a WebGL1 context (false to fail if webgl2 not available)
39
39
  powerPreference: 'high-performance', // After all, most apps are using WebGL for performance reasons
40
+ // eslint-disable-next-line no-console
40
41
  onContextLost: () => console.error('WebGL context lost'),
41
- onContextRestored: () => console.info('WebGL context restored'),
42
+ // eslint-disable-next-line no-console
43
+ onContextRestored: () => console.info('WebGL context restored')
42
44
  };
43
45
 
44
46
  /**
45
47
  * Create a WebGL context for a canvas
46
48
  * Note calling this multiple time on the same canvas does return the same context
47
- * @param canvas A canvas element or offscreen canvas
49
+ * @param canvas A canvas element or offscreen canvas
48
50
  */
49
- export function createBrowserContext(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): WebGLRenderingContext {
50
- props = {...DEFAULT_CONTEXT_PROPS, ...props};
51
+ export function createBrowserContext(
52
+ canvas: HTMLCanvasElement | OffscreenCanvas,
53
+ props: ContextProps
54
+ ): WebGLRenderingContext {
55
+ props = {...DEFAULT_CONTEXT_PROPS, ...props};
51
56
 
52
57
  // Try to extract any extra information about why context creation failed
53
58
  let errorMessage = null;
54
- const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);
59
+ const onCreateError = error => (errorMessage = error.statusMessage || errorMessage);
55
60
  canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
56
61
 
57
62
  // Create the desired context
58
- let gl = null;
63
+ let gl: WebGLRenderingContext | WebGL2RenderingContext | null = null;
59
64
 
60
65
  if (props.type === 'webgl2') {
61
66
  props = {...props, webgl1: false};
@@ -65,11 +70,11 @@ const DEFAULT_CONTEXT_PROPS: ContextProps = {
65
70
  }
66
71
 
67
72
  // Prefer webgl2 over webgl1 if both are acceptable
68
- if (props.webgl2) {
69
- gl = gl || canvas.getContext('webgl2', props);
73
+ if (!gl && props.webgl2) {
74
+ gl = canvas.getContext('webgl2', props) as WebGL2RenderingContext;
70
75
  }
71
- if (props.webgl1) {
72
- gl = gl || canvas.getContext('webgl', props);
76
+ if (!gl && props.webgl1) {
77
+ gl = canvas.getContext('webgl', props) as WebGLRenderingContext;
73
78
  }
74
79
 
75
80
  // TODO are we removing this listener before giving it a chance to fire?
@@ -83,8 +88,20 @@ const DEFAULT_CONTEXT_PROPS: ContextProps = {
83
88
  );
84
89
  }
85
90
 
86
- canvas.addEventListener('webglcontextlost', props.onContextLost, false);
87
- canvas.addEventListener('webglcontextrestored', props.onContextRestored, false);
91
+ if (props.onContextLost) {
92
+ // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.
93
+ const {onContextLost} = props;
94
+ canvas.addEventListener('webglcontextlost', (event: Event) => onContextLost(event), false);
95
+ }
96
+ if (props.onContextRestored) {
97
+ // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.
98
+ const {onContextRestored} = props;
99
+ canvas.addEventListener(
100
+ 'webglcontextrestored',
101
+ (event: Event) => onContextRestored(event),
102
+ false
103
+ );
104
+ }
88
105
 
89
106
  return gl;
90
107
  }
@@ -0,0 +1,48 @@
1
+ const ERR_HEADLESSGL_FAILED =
2
+ 'Failed to create WebGL context in Node.js, headless gl returned null';
3
+
4
+ const ERR_HEADLESSGL_LOAD = '\
5
+ luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL \
6
+ contexts can not be created. This may not be an error. For example, this is a \
7
+ typical configuration for isorender applications running on the server.';
8
+
9
+ const CONTEXT_DEFAULTS = {
10
+ width: 1,
11
+ height: 1,
12
+ debug: true,
13
+ throwOnError: false
14
+ };
15
+
16
+ /** Duck typing for the main headless gl export, a function to create contexts */
17
+ export type HeadlessGL = (width: number, height: number, options: Record<string, unknown>) => WebGLRenderingContext;
18
+
19
+ let headlessGL: HeadlessGL | null = null;
20
+
21
+ /** By importing `gl` and registering it with this function, contexts can be created under Node.js */
22
+ export function registerHeadlessGL(headlessgl: HeadlessGL) {
23
+ headlessGL = headlessgl;
24
+ }
25
+
26
+ /** @returns true if headless gl is registered */
27
+ export function isHeadlessGLRegistered(): boolean {
28
+ return headlessGL !== null;
29
+ }
30
+
31
+ /** Create headless gl context (for running under Node.js) */
32
+ export function createHeadlessContext(options?: Record<string, any>): WebGLRenderingContext {
33
+ options = {...CONTEXT_DEFAULTS, ...options};
34
+
35
+ const {width, height, webgl1, webgl2} = options;
36
+
37
+ if (webgl2 && !webgl1) {
38
+ throw new Error('headless-gl does not support WebGL2');
39
+ }
40
+ if (!headlessGL) {
41
+ throw new Error(ERR_HEADLESSGL_LOAD);
42
+ }
43
+ const gl = headlessGL(width, height, options);
44
+ if (!gl) {
45
+ throw new Error(ERR_HEADLESSGL_FAILED);
46
+ }
47
+ return gl;
48
+ }
@@ -1,5 +1,5 @@
1
1
  // luma.gl, MIT license
2
- import {assert} from '@luma.gl/api';
2
+ import {assert} from '@luma.gl/core';
3
3
 
4
4
  const ERR_CONTEXT = 'Invalid WebGLRenderingContext';
5
5
  export const ERR_WEBGL = ERR_CONTEXT;
@@ -1,5 +1,5 @@
1
1
  // luma.gl, MIT license
2
- import {log, loadScript} from '@luma.gl/api';
2
+ import {log, loadScript} from '@luma.gl/core';
3
3
 
4
4
  /** Spector debug initialization options */
5
5
  type SpectorProps = {
@@ -23,6 +23,7 @@ let spector: any = null;
23
23
  let initialized: boolean = false;
24
24
 
25
25
  declare global {
26
+ // eslint-disable-next-line no-var
26
27
  var SPECTOR: any;
27
28
  }
28
29
 
@@ -32,7 +33,7 @@ export async function loadSpectorJS(props?: SpectorProps) {
32
33
  try {
33
34
  await loadScript(SPECTOR_CDN_URL);
34
35
  } catch(error) {
35
- log.warn(error)
36
+ log.warn(String(error))
36
37
  }
37
38
  }
38
39
  }
@@ -44,7 +45,7 @@ export function initializeSpectorJS(props?: SpectorProps) {
44
45
  }
45
46
 
46
47
  if (!spector && globalThis.SPECTOR) {
47
- log.probe(LOG_LEVEL, "SPECTOR found and initialized")();
48
+ log.probe(LOG_LEVEL, 'SPECTOR found and initialized')();
48
49
  spector = new globalThis.SPECTOR.Spector();
49
50
  if (globalThis.luma) {
50
51
  globalThis.luma.spector = spector;
@@ -61,9 +62,9 @@ export function initializeSpectorJS(props?: SpectorProps) {
61
62
  // enables recording some extra information merged in the capture like texture memory sizes and formats
62
63
  spector.spyCanvases();
63
64
  // A callback when results are ready
64
- spector?.onCaptureStarted.add((capture: unknown) => log.info(`Spector capture started:`, capture)());
65
+ spector?.onCaptureStarted.add((capture: unknown) => log.info('Spector capture started:', capture)());
65
66
  spector?.onCapture.add((capture: unknown) => {
66
- log.info(`Spector capture complete:`, capture)();
67
+ log.info('Spector capture complete:', capture)();
67
68
  // Use undocumented Spector API to open the UI with our capture
68
69
  // See https://github.com/BabylonJS/Spector.js/blob/767ad1195a25b85a85c381f400eb50a979239eca/src/spector.ts#L124
69
70
  spector?.getResultUI()
@@ -82,7 +83,7 @@ export function initializeSpectorJS(props?: SpectorProps) {
82
83
  // spector?.captureCanvas(props?.canvas);
83
84
  spector?.startCapture(props?.canvas, 500); // 500 commands
84
85
  new Promise(resolve => setTimeout(resolve, 2000)).then(_ => {
85
- log.info(`Spector capture stopped after 2 seconds`)();
86
+ log.info('Spector capture stopped after 2 seconds')();
86
87
  spector?.stopCapture();
87
88
  // spector?.displayUI();
88
89
  });