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

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 (500) 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/texture-formats.d.ts +31 -42
  11. package/dist/adapter/converters/texture-formats.d.ts.map +1 -1
  12. package/dist/adapter/converters/texture-formats.js +163 -178
  13. package/dist/adapter/converters/texture-formats.js.map +1 -1
  14. package/dist/adapter/converters/vertex-formats.d.ts +2 -2
  15. package/dist/adapter/converters/vertex-formats.d.ts.map +1 -1
  16. package/dist/adapter/converters/vertex-formats.js +3 -9
  17. package/dist/adapter/converters/vertex-formats.js.map +1 -1
  18. package/dist/adapter/device-helpers/device-features.d.ts +1 -1
  19. package/dist/adapter/device-helpers/device-features.d.ts.map +1 -1
  20. package/dist/adapter/device-helpers/device-features.js +13 -20
  21. package/dist/adapter/device-helpers/device-features.js.map +1 -1
  22. package/dist/adapter/device-helpers/device-limits.d.ts +3 -3
  23. package/dist/adapter/device-helpers/device-limits.d.ts.map +1 -1
  24. package/dist/adapter/device-helpers/device-limits.js +2 -5
  25. package/dist/adapter/device-helpers/device-limits.js.map +1 -1
  26. package/dist/adapter/device-helpers/get-device-info.d.ts +1 -1
  27. package/dist/adapter/device-helpers/get-device-info.d.ts.map +1 -1
  28. package/dist/adapter/device-helpers/get-device-info.js +9 -11
  29. package/dist/adapter/device-helpers/get-device-info.js.map +1 -1
  30. package/dist/adapter/device-helpers/is-old-ie.js +2 -1
  31. package/dist/adapter/device-helpers/is-old-ie.js.map +1 -1
  32. package/dist/adapter/helpers/attribute-utils.d.ts +4 -4
  33. package/dist/adapter/helpers/attribute-utils.d.ts.map +1 -1
  34. package/dist/adapter/helpers/attribute-utils.js +1 -18
  35. package/dist/adapter/helpers/attribute-utils.js.map +1 -1
  36. package/dist/adapter/helpers/get-shader-info.d.ts +9 -0
  37. package/dist/adapter/helpers/get-shader-info.d.ts.map +1 -0
  38. package/dist/adapter/helpers/get-shader-info.js +25 -0
  39. package/dist/adapter/helpers/get-shader-info.js.map +1 -0
  40. package/dist/adapter/helpers/get-shader-layout.d.ts +10 -7
  41. package/dist/adapter/helpers/get-shader-layout.d.ts.map +1 -1
  42. package/dist/adapter/helpers/get-shader-layout.js +101 -84
  43. package/dist/adapter/helpers/get-shader-layout.js.map +1 -1
  44. package/dist/adapter/helpers/parse-shader-compiler-log.d.ts +1 -1
  45. package/dist/adapter/helpers/parse-shader-compiler-log.d.ts.map +1 -1
  46. package/dist/adapter/helpers/parse-shader-compiler-log.js +0 -7
  47. package/dist/adapter/helpers/parse-shader-compiler-log.js.map +1 -1
  48. package/dist/adapter/helpers/set-uniform.d.ts +2 -2
  49. package/dist/adapter/helpers/set-uniform.d.ts.map +1 -1
  50. package/dist/adapter/helpers/set-uniform.js +3 -33
  51. package/dist/adapter/helpers/set-uniform.js.map +1 -1
  52. package/dist/adapter/helpers/uniforms.d.ts +9 -10
  53. package/dist/adapter/helpers/uniforms.d.ts.map +1 -1
  54. package/dist/adapter/helpers/uniforms.js +8 -18
  55. package/dist/adapter/helpers/uniforms.js.map +1 -1
  56. package/dist/adapter/objects/constants-to-keys.d.ts +1 -3
  57. package/dist/adapter/objects/constants-to-keys.d.ts.map +1 -1
  58. package/dist/adapter/objects/constants-to-keys.js +1 -28
  59. package/dist/adapter/objects/constants-to-keys.js.map +1 -1
  60. package/dist/adapter/objects/webgl-renderbuffer.d.ts +15 -12
  61. package/dist/adapter/objects/webgl-renderbuffer.d.ts.map +1 -1
  62. package/dist/adapter/objects/webgl-renderbuffer.js +35 -41
  63. package/dist/adapter/objects/webgl-renderbuffer.js.map +1 -1
  64. package/dist/adapter/objects/webgl-resource.d.ts +6 -9
  65. package/dist/adapter/objects/webgl-resource.d.ts.map +1 -1
  66. package/dist/adapter/objects/webgl-resource.js +19 -75
  67. package/dist/adapter/objects/webgl-resource.js.map +1 -1
  68. package/dist/adapter/objects/webgl-vertex-array-object.d.ts +38 -11
  69. package/dist/adapter/objects/webgl-vertex-array-object.d.ts.map +1 -1
  70. package/dist/adapter/objects/webgl-vertex-array-object.js +122 -32
  71. package/dist/adapter/objects/webgl-vertex-array-object.js.map +1 -1
  72. package/dist/adapter/resources/webgl-buffer.d.ts +18 -10
  73. package/dist/adapter/resources/webgl-buffer.d.ts.map +1 -1
  74. package/dist/adapter/resources/webgl-buffer.js +43 -71
  75. package/dist/adapter/resources/webgl-buffer.js.map +1 -1
  76. package/dist/adapter/resources/webgl-command-buffer.d.ts +15 -9
  77. package/dist/adapter/resources/webgl-command-buffer.d.ts.map +1 -1
  78. package/dist/adapter/resources/webgl-command-buffer.js +169 -41
  79. package/dist/adapter/resources/webgl-command-buffer.js.map +1 -1
  80. package/dist/adapter/resources/webgl-command-encoder.d.ts +7 -6
  81. package/dist/adapter/resources/webgl-command-encoder.d.ts.map +1 -1
  82. package/dist/adapter/resources/webgl-command-encoder.js +8 -17
  83. package/dist/adapter/resources/webgl-command-encoder.js.map +1 -1
  84. package/dist/adapter/resources/webgl-external-texture.js.map +1 -1
  85. package/dist/adapter/resources/webgl-framebuffer.d.ts +21 -24
  86. package/dist/adapter/resources/webgl-framebuffer.d.ts.map +1 -1
  87. package/dist/adapter/resources/webgl-framebuffer.js +41 -149
  88. package/dist/adapter/resources/webgl-framebuffer.js.map +1 -1
  89. package/dist/adapter/resources/webgl-render-pass.d.ts +19 -4
  90. package/dist/adapter/resources/webgl-render-pass.d.ts.map +1 -1
  91. package/dist/adapter/resources/webgl-render-pass.js +88 -9
  92. package/dist/adapter/resources/webgl-render-pass.js.map +1 -1
  93. package/dist/adapter/resources/webgl-render-pipeline.d.ts +44 -11
  94. package/dist/adapter/resources/webgl-render-pipeline.d.ts.map +1 -1
  95. package/dist/adapter/resources/webgl-render-pipeline.js +90 -152
  96. package/dist/adapter/resources/webgl-render-pipeline.js.map +1 -1
  97. package/dist/adapter/resources/webgl-sampler.d.ts +6 -5
  98. package/dist/adapter/resources/webgl-sampler.d.ts.map +1 -1
  99. package/dist/adapter/resources/webgl-sampler.js +7 -15
  100. package/dist/adapter/resources/webgl-sampler.js.map +1 -1
  101. package/dist/adapter/resources/webgl-shader.d.ts +3 -4
  102. package/dist/adapter/resources/webgl-shader.d.ts.map +1 -1
  103. package/dist/adapter/resources/webgl-shader.js +9 -22
  104. package/dist/adapter/resources/webgl-shader.js.map +1 -1
  105. package/dist/adapter/resources/webgl-texture.d.ts +64 -44
  106. package/dist/adapter/resources/webgl-texture.d.ts.map +1 -1
  107. package/dist/adapter/resources/webgl-texture.js +98 -213
  108. package/dist/adapter/resources/webgl-texture.js.map +1 -1
  109. package/dist/adapter/webgl-canvas-context.d.ts +6 -7
  110. package/dist/adapter/webgl-canvas-context.d.ts.map +1 -1
  111. package/dist/adapter/webgl-canvas-context.js +8 -20
  112. package/dist/adapter/webgl-canvas-context.js.map +1 -1
  113. package/dist/adapter/webgl-device.d.ts +64 -41
  114. package/dist/adapter/webgl-device.d.ts.map +1 -1
  115. package/dist/adapter/webgl-device.js +133 -113
  116. package/dist/adapter/webgl-device.js.map +1 -1
  117. package/dist/classic/accessor.d.ts +3 -3
  118. package/dist/classic/accessor.d.ts.map +1 -1
  119. package/dist/classic/accessor.js +14 -38
  120. package/dist/classic/accessor.js.map +1 -1
  121. package/dist/classic/{buffer.d.ts → buffer-with-accessor.d.ts} +16 -28
  122. package/dist/classic/buffer-with-accessor.d.ts.map +1 -0
  123. package/dist/classic/{buffer.js → buffer-with-accessor.js} +54 -122
  124. package/dist/classic/buffer-with-accessor.js.map +1 -0
  125. package/dist/classic/clear.d.ts +22 -0
  126. package/dist/classic/clear.d.ts.map +1 -0
  127. package/dist/classic/clear.js +88 -0
  128. package/dist/classic/clear.js.map +1 -0
  129. package/dist/classic/copy-and-blit.d.ts +62 -0
  130. package/dist/classic/copy-and-blit.d.ts.map +1 -0
  131. package/dist/classic/copy-and-blit.js +202 -0
  132. package/dist/classic/copy-and-blit.js.map +1 -0
  133. package/dist/classic/format-utils.d.ts +3 -0
  134. package/dist/classic/format-utils.d.ts.map +1 -0
  135. package/dist/classic/format-utils.js +38 -0
  136. package/dist/classic/format-utils.js.map +1 -0
  137. package/dist/classic/typed-array-utils.d.ts +15 -17
  138. package/dist/classic/typed-array-utils.d.ts.map +1 -1
  139. package/dist/classic/typed-array-utils.js +1 -21
  140. package/dist/classic/typed-array-utils.js.map +1 -1
  141. package/dist/context/context/create-browser-context.d.ts +40 -0
  142. package/dist/context/context/create-browser-context.d.ts.map +1 -0
  143. package/dist/{esm/context/context/create-context.js → context/context/create-browser-context.js} +23 -19
  144. package/dist/context/context/create-browser-context.js.map +1 -0
  145. package/dist/context/context/create-headless-context.d.ts +9 -0
  146. package/dist/context/context/create-headless-context.d.ts.map +1 -0
  147. package/dist/context/context/create-headless-context.js +42 -0
  148. package/dist/context/context/create-headless-context.js.map +1 -0
  149. package/dist/context/context/webgl-checks.js +1 -4
  150. package/dist/context/context/webgl-checks.js.map +1 -1
  151. package/dist/context/debug/spector.d.ts +1 -2
  152. package/dist/context/debug/spector.d.ts.map +1 -1
  153. package/dist/context/debug/spector.js +8 -20
  154. package/dist/context/debug/spector.js.map +1 -1
  155. package/dist/context/debug/webgl-developer-tools.d.ts +2 -2
  156. package/dist/context/debug/webgl-developer-tools.d.ts.map +1 -1
  157. package/dist/context/debug/webgl-developer-tools.js +11 -34
  158. package/dist/context/debug/webgl-developer-tools.js.map +1 -1
  159. package/dist/context/parameters/unified-parameter-api.d.ts +8 -7
  160. package/dist/context/parameters/unified-parameter-api.d.ts.map +1 -1
  161. package/dist/context/parameters/unified-parameter-api.js +8 -18
  162. package/dist/context/parameters/unified-parameter-api.js.map +1 -1
  163. package/dist/context/parameters/webgl-parameter-tables.d.ts +105 -106
  164. package/dist/context/parameters/webgl-parameter-tables.d.ts.map +1 -1
  165. package/dist/context/parameters/webgl-parameter-tables.js +18 -36
  166. package/dist/context/parameters/webgl-parameter-tables.js.map +1 -1
  167. package/dist/context/polyfill/context-data.d.ts +13 -0
  168. package/dist/context/polyfill/context-data.d.ts.map +1 -0
  169. package/dist/context/polyfill/context-data.js +12 -0
  170. package/dist/context/polyfill/context-data.js.map +1 -0
  171. package/dist/context/polyfill/get-parameter-polyfill.d.ts +1 -1
  172. package/dist/context/polyfill/get-parameter-polyfill.d.ts.map +1 -1
  173. package/dist/context/polyfill/get-parameter-polyfill.js +4 -9
  174. package/dist/context/polyfill/get-parameter-polyfill.js.map +1 -1
  175. package/dist/context/polyfill/polyfill-context.js +21 -29
  176. package/dist/context/polyfill/polyfill-context.js.map +1 -1
  177. package/dist/context/polyfill/polyfill-table.d.ts +8 -8
  178. package/dist/context/polyfill/polyfill-table.d.ts.map +1 -1
  179. package/dist/context/polyfill/polyfill-table.js +10 -32
  180. package/dist/context/polyfill/polyfill-table.js.map +1 -1
  181. package/dist/context/polyfill/polyfill-vertex-array-object.d.ts.map +1 -1
  182. package/dist/context/polyfill/polyfill-vertex-array-object.js +0 -70
  183. package/dist/context/polyfill/polyfill-vertex-array-object.js.map +1 -1
  184. package/dist/context/state-tracker/deep-array-equal.js +0 -4
  185. package/dist/context/state-tracker/deep-array-equal.js.map +1 -1
  186. package/dist/context/state-tracker/track-context-state.d.ts.map +1 -1
  187. package/dist/context/state-tracker/track-context-state.js +16 -51
  188. package/dist/context/state-tracker/track-context-state.js.map +1 -1
  189. package/dist/context/state-tracker/with-parameters.d.ts +2 -1
  190. package/dist/context/state-tracker/with-parameters.d.ts.map +1 -1
  191. package/dist/context/state-tracker/with-parameters.js +7 -9
  192. package/dist/context/state-tracker/with-parameters.js.map +1 -1
  193. package/dist/dist.dev.js +10158 -0
  194. package/dist/index.cjs +6604 -0
  195. package/dist/index.d.ts +25 -22
  196. package/dist/index.d.ts.map +1 -1
  197. package/dist/index.js +27 -26
  198. package/dist/index.js.map +1 -1
  199. package/dist/types.d.ts +1 -1
  200. package/dist/types.d.ts.map +1 -1
  201. package/dist/types.js.map +1 -1
  202. package/dist.min.js +37 -0
  203. package/package.json +21 -9
  204. package/src/adapter/converters/device-parameters.ts +88 -35
  205. package/src/adapter/converters/sampler-parameters.ts +19 -9
  206. package/src/adapter/converters/texture-formats.ts +261 -178
  207. package/src/adapter/converters/vertex-formats.ts +3 -2
  208. package/src/adapter/device-helpers/device-features.ts +10 -3
  209. package/src/adapter/device-helpers/device-limits.ts +3 -3
  210. package/src/adapter/device-helpers/get-device-info.ts +14 -10
  211. package/src/adapter/helpers/attribute-utils.ts +4 -5
  212. package/src/adapter/helpers/get-shader-info.ts +40 -0
  213. package/src/adapter/helpers/get-shader-layout.ts +150 -68
  214. package/src/adapter/helpers/parse-shader-compiler-log.ts +2 -2
  215. package/src/adapter/helpers/set-uniform.ts +7 -6
  216. package/src/adapter/helpers/uniforms.ts +23 -13
  217. package/src/adapter/objects/constants-to-keys.ts +3 -25
  218. package/src/adapter/objects/webgl-renderbuffer.ts +40 -37
  219. package/src/adapter/objects/webgl-resource.ts +14 -23
  220. package/src/adapter/objects/webgl-vertex-array-object.ts +201 -37
  221. package/src/adapter/resources/webgl-buffer.ts +56 -58
  222. package/src/adapter/resources/webgl-command-buffer.ts +332 -25
  223. package/src/adapter/resources/webgl-command-encoder.ts +16 -11
  224. package/src/adapter/resources/webgl-external-texture.ts +2 -2
  225. package/src/adapter/resources/webgl-framebuffer.ts +88 -133
  226. package/src/adapter/resources/webgl-render-pass.ts +155 -4
  227. package/src/adapter/resources/webgl-render-pipeline.ts +161 -104
  228. package/src/adapter/resources/webgl-sampler.ts +13 -8
  229. package/src/adapter/resources/webgl-shader.ts +11 -10
  230. package/src/adapter/resources/webgl-texture.ts +113 -85
  231. package/src/adapter/webgl-canvas-context.ts +14 -14
  232. package/src/adapter/webgl-device.ts +192 -77
  233. package/src/classic/accessor.ts +4 -17
  234. package/src/classic/{buffer.ts → buffer-with-accessor.ts} +67 -75
  235. package/src/classic/clear.ts +110 -0
  236. package/src/classic/copy-and-blit.ts +308 -0
  237. package/src/classic/format-utils.ts +43 -0
  238. package/src/classic/typed-array-utils.ts +18 -27
  239. package/src/context/context/{create-context.ts → create-browser-context.ts} +48 -31
  240. package/src/context/context/create-headless-context.ts +48 -0
  241. package/src/context/context/webgl-checks.ts +1 -1
  242. package/src/context/debug/spector.ts +7 -6
  243. package/src/context/debug/webgl-developer-tools.ts +21 -15
  244. package/src/context/parameters/unified-parameter-api.ts +20 -14
  245. package/src/context/parameters/webgl-parameter-tables.ts +117 -98
  246. package/src/context/polyfill/context-data.ts +27 -0
  247. package/src/context/polyfill/get-parameter-polyfill.ts +8 -7
  248. package/src/context/polyfill/polyfill-context.ts +7 -9
  249. package/src/context/polyfill/polyfill-table.ts +18 -16
  250. package/src/context/polyfill/polyfill-vertex-array-object.ts +2 -0
  251. package/src/context/state-tracker/track-context-state.ts +14 -13
  252. package/src/context/state-tracker/with-parameters.ts +8 -2
  253. package/src/index.ts +42 -33
  254. package/dist/adapter/converters/renderbuffer-formats.d.ts +0 -16
  255. package/dist/adapter/converters/renderbuffer-formats.d.ts.map +0 -1
  256. package/dist/adapter/converters/renderbuffer-formats.js +0 -185
  257. package/dist/adapter/converters/renderbuffer-formats.js.map +0 -1
  258. package/dist/bundle.d.ts +0 -2
  259. package/dist/bundle.d.ts.map +0 -1
  260. package/dist/bundle.js +0 -5
  261. package/dist/bundle.js.map +0 -1
  262. package/dist/classic/buffer.d.ts.map +0 -1
  263. package/dist/classic/buffer.js.map +0 -1
  264. package/dist/context/context/context-state.d.ts +0 -18
  265. package/dist/context/context/context-state.d.ts.map +0 -1
  266. package/dist/context/context/context-state.js +0 -26
  267. package/dist/context/context/context-state.js.map +0 -1
  268. package/dist/context/context/create-context.d.ts +0 -41
  269. package/dist/context/context/create-context.d.ts.map +0 -1
  270. package/dist/context/context/create-context.js +0 -49
  271. package/dist/context/context/create-context.js.map +0 -1
  272. package/dist/context/context/device-pixels.d.ts +0 -25
  273. package/dist/context/context/device-pixels.d.ts.map +0 -1
  274. package/dist/context/context/device-pixels.js +0 -98
  275. package/dist/context/context/device-pixels.js.map +0 -1
  276. package/dist/es5/adapter/converters/device-parameters.js +0 -170
  277. package/dist/es5/adapter/converters/device-parameters.js.map +0 -1
  278. package/dist/es5/adapter/converters/renderbuffer-formats.js +0 -163
  279. package/dist/es5/adapter/converters/renderbuffer-formats.js.map +0 -1
  280. package/dist/es5/adapter/converters/sampler-parameters.js +0 -226
  281. package/dist/es5/adapter/converters/sampler-parameters.js.map +0 -1
  282. package/dist/es5/adapter/converters/texture-formats.js +0 -1031
  283. package/dist/es5/adapter/converters/texture-formats.js.map +0 -1
  284. package/dist/es5/adapter/converters/vertex-formats.js +0 -45
  285. package/dist/es5/adapter/converters/vertex-formats.js.map +0 -1
  286. package/dist/es5/adapter/device-helpers/device-features.js +0 -144
  287. package/dist/es5/adapter/device-helpers/device-features.js.map +0 -1
  288. package/dist/es5/adapter/device-helpers/device-limits.js +0 -64
  289. package/dist/es5/adapter/device-helpers/device-limits.js.map +0 -1
  290. package/dist/es5/adapter/device-helpers/get-device-info.js +0 -55
  291. package/dist/es5/adapter/device-helpers/get-device-info.js.map +0 -1
  292. package/dist/es5/adapter/device-helpers/is-old-ie.js +0 -16
  293. package/dist/es5/adapter/device-helpers/is-old-ie.js.map +0 -1
  294. package/dist/es5/adapter/helpers/attribute-utils.js +0 -91
  295. package/dist/es5/adapter/helpers/attribute-utils.js.map +0 -1
  296. package/dist/es5/adapter/helpers/get-shader-layout.js +0 -371
  297. package/dist/es5/adapter/helpers/get-shader-layout.js.map +0 -1
  298. package/dist/es5/adapter/helpers/parse-shader-compiler-log.js +0 -72
  299. package/dist/es5/adapter/helpers/parse-shader-compiler-log.js.map +0 -1
  300. package/dist/es5/adapter/helpers/set-uniform.js +0 -125
  301. package/dist/es5/adapter/helpers/set-uniform.js.map +0 -1
  302. package/dist/es5/adapter/helpers/uniforms.js +0 -112
  303. package/dist/es5/adapter/helpers/uniforms.js.map +0 -1
  304. package/dist/es5/adapter/objects/constants-to-keys.js +0 -54
  305. package/dist/es5/adapter/objects/constants-to-keys.js.map +0 -1
  306. package/dist/es5/adapter/objects/webgl-renderbuffer.js +0 -150
  307. package/dist/es5/adapter/objects/webgl-renderbuffer.js.map +0 -1
  308. package/dist/es5/adapter/objects/webgl-resource.js +0 -292
  309. package/dist/es5/adapter/objects/webgl-resource.js.map +0 -1
  310. package/dist/es5/adapter/objects/webgl-vertex-array-object.js +0 -137
  311. package/dist/es5/adapter/objects/webgl-vertex-array-object.js.map +0 -1
  312. package/dist/es5/adapter/resources/webgl-buffer.js +0 -243
  313. package/dist/es5/adapter/resources/webgl-buffer.js.map +0 -1
  314. package/dist/es5/adapter/resources/webgl-command-buffer.js +0 -96
  315. package/dist/es5/adapter/resources/webgl-command-buffer.js.map +0 -1
  316. package/dist/es5/adapter/resources/webgl-command-encoder.js +0 -98
  317. package/dist/es5/adapter/resources/webgl-command-encoder.js.map +0 -1
  318. package/dist/es5/adapter/resources/webgl-external-texture.js +0 -2
  319. package/dist/es5/adapter/resources/webgl-external-texture.js.map +0 -1
  320. package/dist/es5/adapter/resources/webgl-framebuffer.js +0 -345
  321. package/dist/es5/adapter/resources/webgl-framebuffer.js.map +0 -1
  322. package/dist/es5/adapter/resources/webgl-render-pass.js +0 -61
  323. package/dist/es5/adapter/resources/webgl-render-pass.js.map +0 -1
  324. package/dist/es5/adapter/resources/webgl-render-pipeline.js +0 -505
  325. package/dist/es5/adapter/resources/webgl-render-pipeline.js.map +0 -1
  326. package/dist/es5/adapter/resources/webgl-sampler.js +0 -96
  327. package/dist/es5/adapter/resources/webgl-sampler.js.map +0 -1
  328. package/dist/es5/adapter/resources/webgl-shader.js +0 -149
  329. package/dist/es5/adapter/resources/webgl-shader.js.map +0 -1
  330. package/dist/es5/adapter/resources/webgl-texture.js +0 -986
  331. package/dist/es5/adapter/resources/webgl-texture.js.map +0 -1
  332. package/dist/es5/adapter/webgl-canvas-context.js +0 -97
  333. package/dist/es5/adapter/webgl-canvas-context.js.map +0 -1
  334. package/dist/es5/adapter/webgl-device.js +0 -399
  335. package/dist/es5/adapter/webgl-device.js.map +0 -1
  336. package/dist/es5/bundle.js +0 -7
  337. package/dist/es5/bundle.js.map +0 -1
  338. package/dist/es5/classic/accessor.js +0 -181
  339. package/dist/es5/classic/accessor.js.map +0 -1
  340. package/dist/es5/classic/buffer.js +0 -470
  341. package/dist/es5/classic/buffer.js.map +0 -1
  342. package/dist/es5/classic/typed-array-utils.js +0 -126
  343. package/dist/es5/classic/typed-array-utils.js.map +0 -1
  344. package/dist/es5/context/context/context-state.js +0 -31
  345. package/dist/es5/context/context/context-state.js.map +0 -1
  346. package/dist/es5/context/context/create-context.js +0 -69
  347. package/dist/es5/context/context/create-context.js.map +0 -1
  348. package/dist/es5/context/context/device-pixels.js +0 -115
  349. package/dist/es5/context/context/device-pixels.js.map +0 -1
  350. package/dist/es5/context/context/webgl-checks.js +0 -54
  351. package/dist/es5/context/context/webgl-checks.js.map +0 -1
  352. package/dist/es5/context/debug/spector.js +0 -133
  353. package/dist/es5/context/debug/spector.js.map +0 -1
  354. package/dist/es5/context/debug/webgl-developer-tools.js +0 -198
  355. package/dist/es5/context/debug/webgl-developer-tools.js.map +0 -1
  356. package/dist/es5/context/parameters/unified-parameter-api.js +0 -97
  357. package/dist/es5/context/parameters/unified-parameter-api.js.map +0 -1
  358. package/dist/es5/context/parameters/webgl-parameter-tables.js +0 -392
  359. package/dist/es5/context/parameters/webgl-parameter-tables.js.map +0 -1
  360. package/dist/es5/context/polyfill/get-parameter-polyfill.js +0 -81
  361. package/dist/es5/context/polyfill/get-parameter-polyfill.js.map +0 -1
  362. package/dist/es5/context/polyfill/polyfill-context.js +0 -135
  363. package/dist/es5/context/polyfill/polyfill-context.js.map +0 -1
  364. package/dist/es5/context/polyfill/polyfill-table.js +0 -166
  365. package/dist/es5/context/polyfill/polyfill-table.js.map +0 -1
  366. package/dist/es5/context/polyfill/polyfill-vertex-array-object.js +0 -341
  367. package/dist/es5/context/polyfill/polyfill-vertex-array-object.js.map +0 -1
  368. package/dist/es5/context/state-tracker/deep-array-equal.js +0 -28
  369. package/dist/es5/context/state-tracker/deep-array-equal.js.map +0 -1
  370. package/dist/es5/context/state-tracker/track-context-state.js +0 -211
  371. package/dist/es5/context/state-tracker/track-context-state.js.map +0 -1
  372. package/dist/es5/context/state-tracker/with-parameters.js +0 -44
  373. package/dist/es5/context/state-tracker/with-parameters.js.map +0 -1
  374. package/dist/es5/index.js +0 -276
  375. package/dist/es5/index.js.map +0 -1
  376. package/dist/es5/init.js +0 -10
  377. package/dist/es5/init.js.map +0 -1
  378. package/dist/es5/types/webgl.js +0 -6
  379. package/dist/es5/types/webgl.js.map +0 -1
  380. package/dist/es5/types.js +0 -2
  381. package/dist/es5/types.js.map +0 -1
  382. package/dist/esm/adapter/converters/device-parameters.js +0 -155
  383. package/dist/esm/adapter/converters/device-parameters.js.map +0 -1
  384. package/dist/esm/adapter/converters/renderbuffer-formats.js +0 -185
  385. package/dist/esm/adapter/converters/renderbuffer-formats.js.map +0 -1
  386. package/dist/esm/adapter/converters/sampler-parameters.js +0 -208
  387. package/dist/esm/adapter/converters/sampler-parameters.js.map +0 -1
  388. package/dist/esm/adapter/converters/texture-formats.js +0 -954
  389. package/dist/esm/adapter/converters/texture-formats.js.map +0 -1
  390. package/dist/esm/adapter/converters/vertex-formats.js +0 -35
  391. package/dist/esm/adapter/converters/vertex-formats.js.map +0 -1
  392. package/dist/esm/adapter/device-helpers/device-features.js +0 -102
  393. package/dist/esm/adapter/device-helpers/device-features.js.map +0 -1
  394. package/dist/esm/adapter/device-helpers/device-limits.js +0 -91
  395. package/dist/esm/adapter/device-helpers/device-limits.js.map +0 -1
  396. package/dist/esm/adapter/device-helpers/get-device-info.js +0 -44
  397. package/dist/esm/adapter/device-helpers/get-device-info.js.map +0 -1
  398. package/dist/esm/adapter/device-helpers/is-old-ie.js +0 -8
  399. package/dist/esm/adapter/device-helpers/is-old-ie.js.map +0 -1
  400. package/dist/esm/adapter/helpers/attribute-utils.js +0 -81
  401. package/dist/esm/adapter/helpers/attribute-utils.js.map +0 -1
  402. package/dist/esm/adapter/helpers/get-shader-layout.js +0 -306
  403. package/dist/esm/adapter/helpers/get-shader-layout.js.map +0 -1
  404. package/dist/esm/adapter/helpers/parse-shader-compiler-log.js +0 -37
  405. package/dist/esm/adapter/helpers/parse-shader-compiler-log.js.map +0 -1
  406. package/dist/esm/adapter/helpers/set-uniform.js +0 -115
  407. package/dist/esm/adapter/helpers/set-uniform.js.map +0 -1
  408. package/dist/esm/adapter/helpers/uniforms.js +0 -99
  409. package/dist/esm/adapter/helpers/uniforms.js.map +0 -1
  410. package/dist/esm/adapter/objects/constants-to-keys.js +0 -42
  411. package/dist/esm/adapter/objects/constants-to-keys.js.map +0 -1
  412. package/dist/esm/adapter/objects/webgl-renderbuffer.js +0 -94
  413. package/dist/esm/adapter/objects/webgl-renderbuffer.js.map +0 -1
  414. package/dist/esm/adapter/objects/webgl-resource.js +0 -216
  415. package/dist/esm/adapter/objects/webgl-resource.js.map +0 -1
  416. package/dist/esm/adapter/objects/webgl-vertex-array-object.js +0 -84
  417. package/dist/esm/adapter/objects/webgl-vertex-array-object.js.map +0 -1
  418. package/dist/esm/adapter/resources/webgl-buffer.js +0 -164
  419. package/dist/esm/adapter/resources/webgl-buffer.js.map +0 -1
  420. package/dist/esm/adapter/resources/webgl-command-buffer.js +0 -65
  421. package/dist/esm/adapter/resources/webgl-command-buffer.js.map +0 -1
  422. package/dist/esm/adapter/resources/webgl-command-encoder.js +0 -53
  423. package/dist/esm/adapter/resources/webgl-command-encoder.js.map +0 -1
  424. package/dist/esm/adapter/resources/webgl-external-texture.js +0 -2
  425. package/dist/esm/adapter/resources/webgl-external-texture.js.map +0 -1
  426. package/dist/esm/adapter/resources/webgl-framebuffer.js +0 -265
  427. package/dist/esm/adapter/resources/webgl-framebuffer.js.map +0 -1
  428. package/dist/esm/adapter/resources/webgl-render-pass.js +0 -19
  429. package/dist/esm/adapter/resources/webgl-render-pass.js.map +0 -1
  430. package/dist/esm/adapter/resources/webgl-render-pipeline.js +0 -400
  431. package/dist/esm/adapter/resources/webgl-render-pipeline.js.map +0 -1
  432. package/dist/esm/adapter/resources/webgl-sampler.js +0 -50
  433. package/dist/esm/adapter/resources/webgl-sampler.js.map +0 -1
  434. package/dist/esm/adapter/resources/webgl-shader.js +0 -75
  435. package/dist/esm/adapter/resources/webgl-shader.js.map +0 -1
  436. package/dist/esm/adapter/resources/webgl-texture.js +0 -831
  437. package/dist/esm/adapter/resources/webgl-texture.js.map +0 -1
  438. package/dist/esm/adapter/webgl-canvas-context.js +0 -54
  439. package/dist/esm/adapter/webgl-canvas-context.js.map +0 -1
  440. package/dist/esm/adapter/webgl-device.js +0 -280
  441. package/dist/esm/adapter/webgl-device.js.map +0 -1
  442. package/dist/esm/bundle.js +0 -5
  443. package/dist/esm/bundle.js.map +0 -1
  444. package/dist/esm/classic/accessor.js +0 -144
  445. package/dist/esm/classic/accessor.js.map +0 -1
  446. package/dist/esm/classic/buffer.js +0 -384
  447. package/dist/esm/classic/buffer.js.map +0 -1
  448. package/dist/esm/classic/typed-array-utils.js +0 -112
  449. package/dist/esm/classic/typed-array-utils.js.map +0 -1
  450. package/dist/esm/context/context/context-state.js +0 -26
  451. package/dist/esm/context/context/context-state.js.map +0 -1
  452. package/dist/esm/context/context/create-context.js.map +0 -1
  453. package/dist/esm/context/context/device-pixels.js +0 -98
  454. package/dist/esm/context/context/device-pixels.js.map +0 -1
  455. package/dist/esm/context/context/webgl-checks.js +0 -34
  456. package/dist/esm/context/context/webgl-checks.js.map +0 -1
  457. package/dist/esm/context/debug/spector.js +0 -76
  458. package/dist/esm/context/debug/spector.js.map +0 -1
  459. package/dist/esm/context/debug/webgl-developer-tools.js +0 -121
  460. package/dist/esm/context/debug/webgl-developer-tools.js.map +0 -1
  461. package/dist/esm/context/parameters/unified-parameter-api.js +0 -65
  462. package/dist/esm/context/parameters/unified-parameter-api.js.map +0 -1
  463. package/dist/esm/context/parameters/webgl-parameter-tables.js +0 -445
  464. package/dist/esm/context/parameters/webgl-parameter-tables.js.map +0 -1
  465. package/dist/esm/context/polyfill/get-parameter-polyfill.js +0 -91
  466. package/dist/esm/context/polyfill/get-parameter-polyfill.js.map +0 -1
  467. package/dist/esm/context/polyfill/polyfill-context.js +0 -92
  468. package/dist/esm/context/polyfill/polyfill-context.js.map +0 -1
  469. package/dist/esm/context/polyfill/polyfill-table.js +0 -160
  470. package/dist/esm/context/polyfill/polyfill-table.js.map +0 -1
  471. package/dist/esm/context/polyfill/polyfill-vertex-array-object.js +0 -335
  472. package/dist/esm/context/polyfill/polyfill-vertex-array-object.js.map +0 -1
  473. package/dist/esm/context/state-tracker/deep-array-equal.js +0 -21
  474. package/dist/esm/context/state-tracker/deep-array-equal.js.map +0 -1
  475. package/dist/esm/context/state-tracker/track-context-state.js +0 -183
  476. package/dist/esm/context/state-tracker/track-context-state.js.map +0 -1
  477. package/dist/esm/context/state-tracker/with-parameters.js +0 -36
  478. package/dist/esm/context/state-tracker/with-parameters.js.map +0 -1
  479. package/dist/esm/index.js +0 -27
  480. package/dist/esm/index.js.map +0 -1
  481. package/dist/esm/init.js +0 -4
  482. package/dist/esm/init.js.map +0 -1
  483. package/dist/esm/types/webgl.js +0 -2
  484. package/dist/esm/types/webgl.js.map +0 -1
  485. package/dist/esm/types.js +0 -2
  486. package/dist/esm/types.js.map +0 -1
  487. package/dist/init.d.ts +0 -2
  488. package/dist/init.d.ts.map +0 -1
  489. package/dist/init.js +0 -4
  490. package/dist/init.js.map +0 -1
  491. package/dist/types/webgl.d.ts +0 -144
  492. package/dist/types/webgl.d.ts.map +0 -1
  493. package/dist/types/webgl.js +0 -2
  494. package/dist/types/webgl.js.map +0 -1
  495. package/src/adapter/converters/renderbuffer-formats.ts +0 -92
  496. package/src/bundle.ts +0 -4
  497. package/src/context/context/context-state.ts +0 -41
  498. package/src/context/context/device-pixels.ts +0 -152
  499. package/src/init.ts +0 -4
  500. 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
  });