@lightningjs/renderer 3.0.0-beta4 → 3.0.0-beta6

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 (359) hide show
  1. package/LICENSE +202 -202
  2. package/NOTICE +3 -3
  3. package/README.md +147 -147
  4. package/dist/exports/core-api.d.ts +74 -0
  5. package/dist/exports/core-api.js +96 -0
  6. package/dist/exports/core-api.js.map +1 -0
  7. package/dist/exports/main-api.d.ts +30 -0
  8. package/dist/exports/main-api.js +45 -0
  9. package/dist/exports/main-api.js.map +1 -0
  10. package/dist/src/core/CoreExtension.d.ts +12 -0
  11. package/dist/src/core/CoreExtension.js +29 -0
  12. package/dist/src/core/CoreExtension.js.map +1 -0
  13. package/dist/src/core/CoreNode.d.ts +6 -16
  14. package/dist/src/core/CoreNode.js +25 -38
  15. package/dist/src/core/CoreNode.js.map +1 -1
  16. package/dist/src/core/CoreStuff.js +138 -0
  17. package/dist/src/core/CoreStuff.js.map +1 -0
  18. package/dist/src/core/CoreTextNode.js +1 -1
  19. package/dist/src/core/CoreTextNode.js.map +1 -1
  20. package/dist/src/core/CoreTextureManager.js +4 -5
  21. package/dist/src/core/CoreTextureManager.js.map +1 -1
  22. package/dist/src/core/CoreTexturizer.d.ts +14 -0
  23. package/dist/src/core/CoreTexturizer.js +47 -0
  24. package/dist/src/core/CoreTexturizer.js.map +1 -0
  25. package/dist/src/core/LngNode.d.ts +736 -0
  26. package/dist/src/core/LngNode.js +1174 -0
  27. package/dist/src/core/LngNode.js.map +1 -0
  28. package/dist/src/core/Matrix2DContext.d.ts +15 -0
  29. package/dist/src/core/Matrix2DContext.js +45 -0
  30. package/dist/src/core/Matrix2DContext.js.map +1 -0
  31. package/dist/src/core/ShaderNode.d.ts +10 -0
  32. package/dist/src/core/ShaderNode.js +30 -0
  33. package/dist/src/core/ShaderNode.js.map +1 -0
  34. package/dist/src/core/Stage.js +0 -3
  35. package/dist/src/core/Stage.js.map +1 -1
  36. package/dist/src/core/TextNode.d.ts +103 -0
  37. package/dist/src/core/TextNode.js +331 -0
  38. package/dist/src/core/TextNode.js.map +1 -0
  39. package/dist/src/core/TextureMemoryManager.js +3 -4
  40. package/dist/src/core/TextureMemoryManager.js.map +1 -1
  41. package/dist/src/core/lib/Coords.d.ts +14 -0
  42. package/dist/src/core/lib/Coords.js +55 -0
  43. package/dist/src/core/lib/Coords.js.map +1 -0
  44. package/dist/src/core/lib/glm/common.d.ts +162 -0
  45. package/dist/src/core/lib/glm/common.js +81 -0
  46. package/dist/src/core/lib/glm/common.js.map +1 -0
  47. package/dist/src/core/lib/glm/index.d.ts +11 -0
  48. package/dist/src/core/lib/glm/index.js +30 -0
  49. package/dist/src/core/lib/glm/index.js.map +1 -0
  50. package/dist/src/core/lib/glm/mat2.d.ts +219 -0
  51. package/dist/src/core/lib/glm/mat2.js +396 -0
  52. package/dist/src/core/lib/glm/mat2.js.map +1 -0
  53. package/dist/src/core/lib/glm/mat2d.d.ts +237 -0
  54. package/dist/src/core/lib/glm/mat2d.js +442 -0
  55. package/dist/src/core/lib/glm/mat2d.js.map +1 -0
  56. package/dist/src/core/lib/glm/mat3.d.ts +283 -0
  57. package/dist/src/core/lib/glm/mat3.js +680 -0
  58. package/dist/src/core/lib/glm/mat3.js.map +1 -0
  59. package/dist/src/core/lib/glm/mat4.d.ts +550 -0
  60. package/dist/src/core/lib/glm/mat4.js +1802 -0
  61. package/dist/src/core/lib/glm/mat4.js.map +1 -0
  62. package/dist/src/core/lib/glm/quat.d.ts +363 -0
  63. package/dist/src/core/lib/glm/quat.js +693 -0
  64. package/dist/src/core/lib/glm/quat.js.map +1 -0
  65. package/dist/src/core/lib/glm/quat2.d.ts +356 -0
  66. package/dist/src/core/lib/glm/quat2.js +754 -0
  67. package/dist/src/core/lib/glm/quat2.js.map +1 -0
  68. package/dist/src/core/lib/glm/vec2.d.ts +365 -0
  69. package/dist/src/core/lib/glm/vec2.js +569 -0
  70. package/dist/src/core/lib/glm/vec2.js.map +1 -0
  71. package/dist/src/core/lib/glm/vec3.d.ts +406 -0
  72. package/dist/src/core/lib/glm/vec3.js +720 -0
  73. package/dist/src/core/lib/glm/vec3.js.map +1 -0
  74. package/dist/src/core/lib/glm/vec4.d.ts +330 -0
  75. package/dist/src/core/lib/glm/vec4.js +608 -0
  76. package/dist/src/core/lib/glm/vec4.js.map +1 -0
  77. package/dist/src/core/renderers/CoreRenderer.d.ts +1 -1
  78. package/dist/src/core/renderers/CoreShaderManager.d.ts +19 -0
  79. package/dist/src/core/renderers/CoreShaderManager.js +33 -0
  80. package/dist/src/core/renderers/CoreShaderManager.js.map +1 -0
  81. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.d.ts +27 -0
  82. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js +82 -0
  83. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js.map +1 -0
  84. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.d.ts +11 -0
  85. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js +34 -0
  86. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js.map +1 -0
  87. package/dist/src/core/renderers/webgl/WebGlRenderOp.d.ts +1 -1
  88. package/dist/src/core/renderers/webgl/WebGlRenderOp.js.map +1 -1
  89. package/dist/src/core/renderers/webgl/internal/ShaderUtils.js +35 -35
  90. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  91. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  92. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  93. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  94. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  95. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  96. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  97. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  98. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  99. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  100. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  101. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  102. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  103. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  104. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  105. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  106. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  107. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  108. package/dist/src/core/scene/Scene.d.ts +59 -0
  109. package/dist/src/core/scene/Scene.js +106 -0
  110. package/dist/src/core/scene/Scene.js.map +1 -0
  111. package/dist/src/core/shaders/canvas/RoundedWithBorder.js +8 -2
  112. package/dist/src/core/shaders/canvas/RoundedWithBorder.js.map +1 -1
  113. package/dist/src/core/shaders/webgl/Border.js +86 -63
  114. package/dist/src/core/shaders/webgl/Border.js.map +1 -1
  115. package/dist/src/core/shaders/webgl/Default.js +47 -47
  116. package/dist/src/core/shaders/webgl/DefaultBatched.js +61 -61
  117. package/dist/src/core/shaders/webgl/HolePunch.js +32 -32
  118. package/dist/src/core/shaders/webgl/LinearGradient.js +36 -36
  119. package/dist/src/core/shaders/webgl/RadialGradient.js +33 -33
  120. package/dist/src/core/shaders/webgl/Rounded.js +71 -71
  121. package/dist/src/core/shaders/webgl/RoundedWithBorder.js +104 -72
  122. package/dist/src/core/shaders/webgl/RoundedWithBorder.js.map +1 -1
  123. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js +123 -86
  124. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js.map +1 -1
  125. package/dist/src/core/shaders/webgl/RoundedWithShadow.js +54 -54
  126. package/dist/src/core/shaders/webgl/SdfShader.js +62 -62
  127. package/dist/src/core/shaders/webgl/Shadow.js +83 -83
  128. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js +3 -1
  129. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js.map +1 -1
  130. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.d.ts +20 -0
  131. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js +55 -0
  132. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js.map +1 -0
  133. package/dist/src/main-api/ICoreDriver.d.ts +27 -0
  134. package/dist/src/main-api/ICoreDriver.js +20 -0
  135. package/dist/src/main-api/ICoreDriver.js.map +1 -0
  136. package/dist/src/main-api/IRenderDriver.d.ts +20 -0
  137. package/dist/src/main-api/IRenderDriver.js +20 -0
  138. package/dist/src/main-api/IRenderDriver.js.map +1 -0
  139. package/dist/src/main-api/IShaderController.d.ts +14 -0
  140. package/dist/src/main-api/IShaderController.js +30 -0
  141. package/dist/src/main-api/IShaderController.js.map +1 -0
  142. package/dist/src/main-api/IShaderNode.d.ts +17 -0
  143. package/dist/src/main-api/IShaderNode.js +19 -0
  144. package/dist/src/main-api/IShaderNode.js.map +1 -0
  145. package/dist/src/main-api/Inspector.js +1 -1
  146. package/dist/src/main-api/Inspector.js.map +1 -1
  147. package/dist/src/main-api/Renderer.js +2 -3
  148. package/dist/src/main-api/Renderer.js.map +1 -1
  149. package/dist/src/main-api/RendererMain.d.ts +375 -0
  150. package/dist/src/main-api/RendererMain.js +365 -0
  151. package/dist/src/main-api/RendererMain.js.map +1 -0
  152. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +9 -0
  153. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +38 -0
  154. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +1 -0
  155. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +56 -0
  156. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +101 -0
  157. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +1 -0
  158. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +32 -0
  159. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +28 -0
  160. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +1 -0
  161. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +24 -0
  162. package/dist/src/render-drivers/main/MainCoreDriver.js +118 -0
  163. package/dist/src/render-drivers/main/MainCoreDriver.js.map +1 -0
  164. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +99 -0
  165. package/dist/src/render-drivers/main/MainOnlyNode.js +396 -0
  166. package/dist/src/render-drivers/main/MainOnlyNode.js.map +1 -0
  167. package/dist/src/render-drivers/main/MainOnlyShaderController.d.ts +6 -0
  168. package/dist/src/render-drivers/main/MainOnlyShaderController.js +15 -0
  169. package/dist/src/render-drivers/main/MainOnlyShaderController.js.map +1 -0
  170. package/dist/src/render-drivers/main/MainOnlyShaderNode.d.ts +7 -0
  171. package/dist/src/render-drivers/main/MainOnlyShaderNode.js +34 -0
  172. package/dist/src/render-drivers/main/MainOnlyShaderNode.js.map +1 -0
  173. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +47 -0
  174. package/dist/src/render-drivers/main/MainOnlyTextNode.js +205 -0
  175. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +1 -0
  176. package/dist/src/render-drivers/main/MainRenderDriver.d.ts +17 -0
  177. package/dist/src/render-drivers/main/MainRenderDriver.js +88 -0
  178. package/dist/src/render-drivers/main/MainRenderDriver.js.map +1 -0
  179. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +90 -0
  180. package/dist/src/render-drivers/threadx/NodeStruct.js +281 -0
  181. package/dist/src/render-drivers/threadx/NodeStruct.js.map +1 -0
  182. package/dist/src/render-drivers/threadx/SharedNode.d.ts +39 -0
  183. package/dist/src/render-drivers/threadx/SharedNode.js +60 -0
  184. package/dist/src/render-drivers/threadx/SharedNode.js.map +1 -0
  185. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +44 -0
  186. package/dist/src/render-drivers/threadx/TextNodeStruct.js +201 -0
  187. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +1 -0
  188. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +28 -0
  189. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +234 -0
  190. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +1 -0
  191. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +20 -0
  192. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +84 -0
  193. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +1 -0
  194. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +44 -0
  195. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +154 -0
  196. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +1 -0
  197. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.d.ts +6 -0
  198. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js +16 -0
  199. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js.map +1 -0
  200. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.d.ts +7 -0
  201. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js +15 -0
  202. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js.map +1 -0
  203. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +28 -0
  204. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +55 -0
  205. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +1 -0
  206. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.d.ts +21 -0
  207. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js +198 -0
  208. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js.map +1 -0
  209. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +70 -0
  210. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +32 -0
  211. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +1 -0
  212. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +19 -0
  213. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +177 -0
  214. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +1 -0
  215. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +27 -0
  216. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +108 -0
  217. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +1 -0
  218. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +1 -0
  219. package/dist/src/render-drivers/threadx/worker/renderer.js +145 -0
  220. package/dist/src/render-drivers/threadx/worker/renderer.js.map +1 -0
  221. package/dist/src/render-drivers/utils.d.ts +12 -0
  222. package/dist/src/render-drivers/utils.js +69 -0
  223. package/dist/src/render-drivers/utils.js.map +1 -0
  224. package/dist/src/utils.d.ts +1 -6
  225. package/dist/src/utils.js +2 -9
  226. package/dist/src/utils.js.map +1 -1
  227. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  228. package/exports/canvas-shaders.ts +28 -28
  229. package/exports/canvas.ts +45 -45
  230. package/exports/index.ts +90 -90
  231. package/exports/inspector.ts +24 -24
  232. package/exports/utils.ts +44 -44
  233. package/exports/webgl-shaders.ts +28 -28
  234. package/exports/webgl.ts +50 -50
  235. package/package.json +2 -2
  236. package/src/common/CommonTypes.ts +146 -146
  237. package/src/common/EventEmitter.ts +77 -77
  238. package/src/common/IAnimationController.ts +92 -92
  239. package/src/common/IEventEmitter.ts +28 -28
  240. package/src/core/CoreNode.test.ts +202 -203
  241. package/src/core/CoreNode.ts +2469 -2494
  242. package/src/core/CoreShaderManager.ts +188 -188
  243. package/src/core/CoreTextNode.ts +448 -448
  244. package/src/core/CoreTextureManager.ts +600 -601
  245. package/src/core/Stage.ts +751 -754
  246. package/src/core/TextureMemoryManager.ts +394 -395
  247. package/src/core/animations/AnimationManager.ts +38 -38
  248. package/src/core/animations/CoreAnimation.ts +284 -284
  249. package/src/core/animations/CoreAnimationController.ts +157 -157
  250. package/src/core/lib/ContextSpy.ts +41 -41
  251. package/src/core/lib/ImageWorker.ts +280 -280
  252. package/src/core/lib/Matrix3d.ts +244 -244
  253. package/src/core/lib/RenderCoords.ts +71 -71
  254. package/src/core/lib/WebGlContextWrapper.ts +1374 -1374
  255. package/src/core/lib/textureCompression.ts +152 -152
  256. package/src/core/lib/textureSvg.ts +78 -78
  257. package/src/core/lib/utils.ts +386 -386
  258. package/src/core/lib/validateImageBitmap.ts +87 -87
  259. package/src/core/platforms/Platform.ts +77 -77
  260. package/src/core/platforms/web/WebPlatform.ts +84 -84
  261. package/src/core/renderers/CoreContextTexture.ts +43 -43
  262. package/src/core/renderers/CoreRenderOp.ts +22 -22
  263. package/src/core/renderers/CoreRenderer.ts +109 -109
  264. package/src/core/renderers/CoreShaderNode.ts +165 -165
  265. package/src/core/renderers/CoreShaderProgram.ts +23 -23
  266. package/src/core/renderers/canvas/CanvasRenderer.ts +298 -298
  267. package/src/core/renderers/canvas/CanvasShaderNode.ts +99 -99
  268. package/src/core/renderers/canvas/CanvasTexture.ts +156 -156
  269. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +220 -220
  270. package/src/core/renderers/canvas/internal/ColorUtils.ts +85 -85
  271. package/src/core/renderers/webgl/WebGlCtxRenderTexture.ts +86 -86
  272. package/src/core/renderers/webgl/WebGlCtxSubTexture.ts +50 -50
  273. package/src/core/renderers/webgl/WebGlCtxTexture.ts +301 -301
  274. package/src/core/renderers/webgl/WebGlRenderOp.ts +161 -161
  275. package/src/core/renderers/webgl/WebGlRenderer.ts +750 -750
  276. package/src/core/renderers/webgl/WebGlShaderNode.ts +437 -437
  277. package/src/core/renderers/webgl/WebGlShaderProgram.ts +318 -318
  278. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  279. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  280. package/src/core/renderers/webgl/internal/ShaderUtils.ts +281 -281
  281. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  282. package/src/core/shaders/canvas/Border.ts +78 -78
  283. package/src/core/shaders/canvas/HolePunch.ts +62 -62
  284. package/src/core/shaders/canvas/LinearGradient.ts +69 -69
  285. package/src/core/shaders/canvas/RadialGradient.ts +113 -113
  286. package/src/core/shaders/canvas/Rounded.ts +55 -55
  287. package/src/core/shaders/canvas/RoundedWithBorder.ts +72 -68
  288. package/src/core/shaders/canvas/RoundedWithBorderAndShadow.ts +88 -88
  289. package/src/core/shaders/canvas/RoundedWithShadow.ts +69 -69
  290. package/src/core/shaders/canvas/Shadow.ts +52 -52
  291. package/src/core/shaders/canvas/utils/render.ts +151 -151
  292. package/src/core/shaders/templates/BorderTemplate.ts +115 -115
  293. package/src/core/shaders/templates/HolePunchTemplate.ts +82 -82
  294. package/src/core/shaders/templates/LinearGradientTemplate.ts +71 -71
  295. package/src/core/shaders/templates/RadialGradientTemplate.ts +81 -81
  296. package/src/core/shaders/templates/RoundedTemplate.ts +98 -98
  297. package/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.ts +38 -38
  298. package/src/core/shaders/templates/RoundedWithBorderTemplate.ts +35 -35
  299. package/src/core/shaders/templates/RoundedWithShadowTemplate.ts +35 -35
  300. package/src/core/shaders/templates/ShadowTemplate.ts +106 -106
  301. package/src/core/shaders/templates/shaderUtils.ts +47 -47
  302. package/src/core/shaders/webgl/Border.ts +116 -96
  303. package/src/core/shaders/webgl/Default.ts +89 -89
  304. package/src/core/shaders/webgl/DefaultBatched.ts +129 -129
  305. package/src/core/shaders/webgl/HolePunch.ts +78 -78
  306. package/src/core/shaders/webgl/LinearGradient.ts +81 -81
  307. package/src/core/shaders/webgl/RadialGradient.ts +84 -84
  308. package/src/core/shaders/webgl/Rounded.ts +117 -117
  309. package/src/core/shaders/webgl/RoundedWithBorder.ts +144 -114
  310. package/src/core/shaders/webgl/RoundedWithBorderAndShadow.ts +166 -133
  311. package/src/core/shaders/webgl/RoundedWithShadow.ts +98 -98
  312. package/src/core/shaders/webgl/SdfShader.ts +134 -134
  313. package/src/core/shaders/webgl/Shadow.ts +115 -115
  314. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  315. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  316. package/src/core/text-rendering/TrFontManager.ts +183 -183
  317. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  318. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  319. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  320. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  321. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  322. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -94
  323. package/src/core/text-rendering/font-face-types/utils.ts +39 -39
  324. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +514 -514
  325. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +863 -863
  326. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +849 -846
  327. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  328. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  329. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  330. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  331. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  332. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  333. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  334. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +497 -497
  335. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  336. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  337. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  338. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  339. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  340. package/src/core/text-rendering/renderers/TextRenderer.ts +567 -567
  341. package/src/core/textures/ColorTexture.ts +102 -102
  342. package/src/core/textures/ImageTexture.ts +410 -410
  343. package/src/core/textures/NoiseTexture.ts +104 -104
  344. package/src/core/textures/RenderTexture.ts +85 -85
  345. package/src/core/textures/SubTexture.ts +205 -205
  346. package/src/core/textures/Texture.ts +358 -358
  347. package/src/core/utils.ts +227 -227
  348. package/src/env.d.ts +7 -7
  349. package/src/main-api/INode.ts +100 -100
  350. package/src/main-api/Inspector.ts +522 -522
  351. package/src/main-api/Renderer.ts +673 -675
  352. package/src/main-api/utils.ts +45 -45
  353. package/src/utils.ts +267 -267
  354. package/COPYING +0 -1
  355. package/dist/src/core/temp.js +0 -77
  356. package/dist/src/core/temp.js.map +0 -1
  357. package/scripts/please-use-pnpm.js +0 -13
  358. package/src/core/platform.ts +0 -64
  359. /package/dist/src/core/{temp.d.ts → CoreStuff.d.ts} +0 -0
@@ -1,410 +1,410 @@
1
- /*
2
- * If not stated otherwise in this file or this component's LICENSE file the
3
- * following copyright and licenses apply:
4
- *
5
- * Copyright 2023 Comcast Cable Communications Management, LLC.
6
- *
7
- * Licensed under the Apache License, Version 2.0 (the License);
8
- * you may not use this file except in compliance with the License.
9
- * You may obtain a copy of the License at
10
- *
11
- * http://www.apache.org/licenses/LICENSE-2.0
12
- *
13
- * Unless required by applicable law or agreed to in writing, software
14
- * distributed under the License is distributed on an "AS IS" BASIS,
15
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
- * See the License for the specific language governing permissions and
17
- * limitations under the License.
18
- */
19
-
20
- import type { CoreTextureManager } from '../CoreTextureManager.js';
21
- import { Texture, TextureType, type TextureData } from './Texture.js';
22
- import {
23
- isCompressedTextureContainer,
24
- loadCompressedTexture,
25
- } from '../lib/textureCompression.js';
26
- import {
27
- convertUrlToAbsolute,
28
- dataURIToBlob,
29
- isBase64Image,
30
- } from '../lib/utils.js';
31
- import { isSvgImage, loadSvg } from '../lib/textureSvg.js';
32
- import { fetchJson } from '../text-rendering/font-face-types/utils.js';
33
- import type { Platform } from '../platforms/Platform.js';
34
-
35
- /**
36
- * Properties of the {@link ImageTexture}
37
- */
38
- export interface ImageTextureProps {
39
- /**
40
- * Source URL or ImageData for the image to be used as a texture.
41
- *
42
- * @remarks
43
- * The ImageData type is currently only supported internally. End users should
44
- * only set this property to a URL string.
45
- *
46
- * @default ''
47
- */
48
- src?: string | Blob | ImageData | (() => ImageData | null);
49
- /**
50
- * Whether to premultiply the alpha channel into the color channels of the
51
- * image.
52
- *
53
- * @remarks
54
- * Generally this should be set to `true` (the default). However, if the
55
- * texture's associated Shader expects straight (non-premultiplied) colors,
56
- * this should be set to `false`.
57
- *
58
- * @default true
59
- */
60
- premultiplyAlpha?: boolean | null;
61
- /**
62
- * `ImageData` textures are not cached unless a `key` is provided
63
- */
64
- key?: string | null;
65
- /**
66
- * Width of the image to be used as a texture. If not provided, the image's
67
- * natural width will be used.
68
- */
69
- width?: number | null;
70
- /**
71
- * Height of the image to be used as a texture. If not provided, the image's
72
- * natural height will be used.
73
- */
74
- height?: number | null;
75
- /**
76
- * Type, indicate an image type for overriding type detection
77
- *
78
- * @default null
79
- */
80
- type?: 'regular' | 'compressed' | 'svg' | null;
81
- /**
82
- * The width of the rectangle from which the ImageBitmap will be extracted. This value
83
- * can be negative. Only works when createImageBitmap is supported on the browser.
84
- *
85
- * @default null
86
- */
87
- sw?: number | null;
88
- /**
89
- * The height of the rectangle from which the ImageBitmap will be extracted. This value
90
- * can be negative. Only works when createImageBitmap is supported on the browser.
91
- *
92
- * @default null
93
- */
94
- sh?: number | null;
95
- /**
96
- * The y coordinate of the reference point of the rectangle from which the ImageBitmap
97
- * will be extracted. Only used when `sw` and `sh` are provided. And only works when
98
- * createImageBitmap is available.
99
- *
100
- * @default null
101
- */
102
- sx?: number | null;
103
- /**
104
- * The x coordinate of the reference point of the rectangle from which the
105
- * ImageBitmap will be extracted. Only used when source `sw` width and `sh` height
106
- * are provided. Only works when createImageBitmap is supported on the browser.
107
- *
108
- * @default null
109
- */
110
- sy?: number | null;
111
- }
112
-
113
- /**
114
- * Texture consisting of an image loaded from a URL
115
- *
116
- * @remarks
117
- * The ImageTexture's {@link ImageTextureProps.src} prop defines the image URL
118
- * to be downloaded.
119
- *
120
- * By default, the texture's alpha values will be premultiplied into its color
121
- * values which is generally the desired setting before they are sent to the
122
- * texture's associated {@link Shader}. However, in special cases you may want
123
- * the Shader to receive straight (non-premultiplied) values. In that case you
124
- * can disable the default behavior by setting the
125
- * {@link ImageTextureProps.premultiplyAlpha} prop to `false`.
126
- */
127
- export class ImageTexture extends Texture {
128
- private platform: Platform;
129
-
130
- public props: Required<ImageTextureProps>;
131
- public override type: TextureType = TextureType.image;
132
-
133
- constructor(txManager: CoreTextureManager, props: ImageTextureProps) {
134
- super(txManager);
135
-
136
- this.platform = txManager.platform;
137
- this.props = ImageTexture.resolveDefaults(props);
138
- }
139
-
140
- hasAlphaChannel(mimeType: string) {
141
- return mimeType.indexOf('image/png') !== -1;
142
- }
143
-
144
- async loadImageFallback(src: string | Blob, hasAlpha: boolean) {
145
- const img = new Image();
146
-
147
- if (typeof src === 'string' && isBase64Image(src) === false) {
148
- img.crossOrigin = 'anonymous';
149
- }
150
-
151
- return new Promise<{ data: HTMLImageElement; premultiplyAlpha: boolean }>(
152
- (resolve) => {
153
- img.onload = () => {
154
- resolve({ data: img, premultiplyAlpha: hasAlpha });
155
- };
156
-
157
- img.onerror = () => {
158
- console.warn('Image loading failed, returning fallback object.');
159
- resolve({ data: img, premultiplyAlpha: hasAlpha });
160
- };
161
-
162
- if (src instanceof Blob) {
163
- img.src = URL.createObjectURL(src);
164
- } else {
165
- img.src = src;
166
- }
167
- },
168
- );
169
- }
170
-
171
- async createImageBitmap(
172
- blob: Blob,
173
- premultiplyAlpha: boolean | null,
174
- sx: number | null,
175
- sy: number | null,
176
- sw: number | null,
177
- sh: number | null,
178
- ): Promise<{
179
- data: ImageBitmap | HTMLImageElement;
180
- premultiplyAlpha: boolean;
181
- }> {
182
- const hasAlphaChannel = premultiplyAlpha ?? blob.type.includes('image/png');
183
- const imageBitmapSupported = this.txManager.imageBitmapSupported;
184
-
185
- if (imageBitmapSupported.full === true && sw !== null && sh !== null) {
186
- // createImageBitmap with crop
187
- const bitmap = await this.platform.createImageBitmap(
188
- blob,
189
- sx || 0,
190
- sy || 0,
191
- sw,
192
- sh,
193
- {
194
- premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
195
- colorSpaceConversion: 'none',
196
- imageOrientation: 'none',
197
- },
198
- );
199
- return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
200
- } else if (imageBitmapSupported.basic === true) {
201
- // basic createImageBitmap without options or crop
202
- // this is supported for Chrome v50 to v52/54 that doesn't support options
203
- return {
204
- data: await this.platform.createImageBitmap(blob),
205
- premultiplyAlpha: hasAlphaChannel,
206
- };
207
- }
208
-
209
- // default createImageBitmap without crop but with options
210
- const bitmap = await this.platform.createImageBitmap(blob, {
211
- premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
212
- colorSpaceConversion: 'none',
213
- imageOrientation: 'none',
214
- });
215
- return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
216
- }
217
-
218
- async loadImage(src: string) {
219
- const { premultiplyAlpha, sx, sy, sw, sh } = this.props;
220
-
221
- if (this.txManager.hasCreateImageBitmap === true) {
222
- if (
223
- isBase64Image(src) === false &&
224
- this.txManager.hasWorker === true &&
225
- this.txManager.imageWorkerManager !== null
226
- ) {
227
- return this.txManager.imageWorkerManager.getImage(
228
- src,
229
- premultiplyAlpha,
230
- sx,
231
- sy,
232
- sw,
233
- sh,
234
- );
235
- }
236
-
237
- let blob;
238
-
239
- if (isBase64Image(src) === true) {
240
- blob = dataURIToBlob(src);
241
- } else {
242
- blob = await fetchJson(src, 'blob').then(
243
- (response) => response as Blob,
244
- );
245
- }
246
-
247
- return this.createImageBitmap(blob, premultiplyAlpha, sx, sy, sw, sh);
248
- }
249
-
250
- return this.loadImageFallback(src, premultiplyAlpha ?? true);
251
- }
252
-
253
- override async getTextureSource(): Promise<TextureData> {
254
- let resp;
255
- try {
256
- resp = await this.determineImageTypeAndLoadImage();
257
- } catch (e) {
258
- this.setState('failed', e as Error);
259
- return {
260
- data: null,
261
- };
262
- }
263
-
264
- if (resp.data === null) {
265
- this.setState('failed', Error('ImageTexture: No image data'));
266
- return {
267
- data: null,
268
- };
269
- }
270
-
271
- let width, height;
272
- // check if resp.data is typeof Uint8ClampedArray else
273
- // use resp.data.width and resp.data.height
274
- if (resp.data instanceof Uint8Array) {
275
- width = this.props.width ?? 0;
276
- height = this.props.height ?? 0;
277
- } else {
278
- width = resp.data?.width ?? (this.props.width || 0);
279
- height = resp.data?.height ?? (this.props.height || 0);
280
- }
281
-
282
- // we're loaded!
283
- this.setState('fetched', {
284
- width,
285
- height,
286
- });
287
-
288
- return {
289
- data: resp.data,
290
- premultiplyAlpha: this.props.premultiplyAlpha ?? true,
291
- };
292
- }
293
-
294
- determineImageTypeAndLoadImage() {
295
- const { src, premultiplyAlpha, type } = this.props;
296
- if (src === null) {
297
- return {
298
- data: null,
299
- };
300
- }
301
-
302
- if (typeof src !== 'string') {
303
- if (src instanceof Blob) {
304
- if (this.txManager.hasCreateImageBitmap === true) {
305
- const { sx, sy, sw, sh } = this.props;
306
- return this.createImageBitmap(src, premultiplyAlpha, sx, sy, sw, sh);
307
- } else {
308
- return this.loadImageFallback(src, premultiplyAlpha ?? true);
309
- }
310
- }
311
- if (src instanceof ImageData) {
312
- return {
313
- data: src,
314
- premultiplyAlpha,
315
- };
316
- }
317
- return {
318
- data: src(),
319
- premultiplyAlpha,
320
- };
321
- }
322
-
323
- const absoluteSrc = convertUrlToAbsolute(src);
324
- if (type === 'regular') {
325
- return this.loadImage(absoluteSrc);
326
- }
327
-
328
- if (type === 'svg') {
329
- return loadSvg(
330
- absoluteSrc,
331
- this.props.width,
332
- this.props.height,
333
- this.props.sx,
334
- this.props.sy,
335
- this.props.sw,
336
- this.props.sh,
337
- );
338
- }
339
-
340
- if (isSvgImage(src) === true) {
341
- return loadSvg(
342
- absoluteSrc,
343
- this.props.width,
344
- this.props.height,
345
- this.props.sx,
346
- this.props.sy,
347
- this.props.sw,
348
- this.props.sh,
349
- );
350
- }
351
-
352
- if (type === 'compressed') {
353
- return loadCompressedTexture(absoluteSrc);
354
- }
355
-
356
- if (isCompressedTextureContainer(src) === true) {
357
- return loadCompressedTexture(absoluteSrc);
358
- }
359
-
360
- // default
361
- return this.loadImage(absoluteSrc);
362
- }
363
-
364
- /**
365
- * Generates a cache key for the ImageTexture based on the provided props.
366
- * @param props - The props used to generate the cache key.
367
- * @returns The cache key as a string, or `false` if the key cannot be generated.
368
- */
369
- static override makeCacheKey(props: ImageTextureProps): string | false {
370
- const resolvedProps = ImageTexture.resolveDefaults(props);
371
- // Only cache key-able textures; prioritise key
372
- const key = resolvedProps.key || resolvedProps.src;
373
- if (typeof key !== 'string') {
374
- return false;
375
- }
376
-
377
- // if we have source dimensions, cache the texture separately
378
- let dimensionProps = '';
379
- if (resolvedProps.sh !== null && resolvedProps.sw !== null) {
380
- dimensionProps += ',';
381
- dimensionProps += resolvedProps.sx ?? '';
382
- dimensionProps += resolvedProps.sy ?? '';
383
- dimensionProps += resolvedProps.sw || '';
384
- dimensionProps += resolvedProps.sh || '';
385
- }
386
-
387
- return `ImageTexture,${key},${
388
- resolvedProps.premultiplyAlpha ?? 'true'
389
- }${dimensionProps}`;
390
- }
391
-
392
- static override resolveDefaults(
393
- props: ImageTextureProps,
394
- ): Required<ImageTextureProps> {
395
- return {
396
- src: props.src ?? '',
397
- premultiplyAlpha: props.premultiplyAlpha ?? true, // null,
398
- key: props.key ?? null,
399
- type: props.type ?? null,
400
- width: props.width ?? null,
401
- height: props.height ?? null,
402
- sx: props.sx ?? null,
403
- sy: props.sy ?? null,
404
- sw: props.sw ?? null,
405
- sh: props.sh ?? null,
406
- };
407
- }
408
-
409
- static z$__type__Props: ImageTextureProps;
410
- }
1
+ /*
2
+ * If not stated otherwise in this file or this component's LICENSE file the
3
+ * following copyright and licenses apply:
4
+ *
5
+ * Copyright 2023 Comcast Cable Communications Management, LLC.
6
+ *
7
+ * Licensed under the Apache License, Version 2.0 (the License);
8
+ * you may not use this file except in compliance with the License.
9
+ * You may obtain a copy of the License at
10
+ *
11
+ * http://www.apache.org/licenses/LICENSE-2.0
12
+ *
13
+ * Unless required by applicable law or agreed to in writing, software
14
+ * distributed under the License is distributed on an "AS IS" BASIS,
15
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ * See the License for the specific language governing permissions and
17
+ * limitations under the License.
18
+ */
19
+
20
+ import type { CoreTextureManager } from '../CoreTextureManager.js';
21
+ import { Texture, TextureType, type TextureData } from './Texture.js';
22
+ import {
23
+ isCompressedTextureContainer,
24
+ loadCompressedTexture,
25
+ } from '../lib/textureCompression.js';
26
+ import {
27
+ convertUrlToAbsolute,
28
+ dataURIToBlob,
29
+ isBase64Image,
30
+ } from '../lib/utils.js';
31
+ import { isSvgImage, loadSvg } from '../lib/textureSvg.js';
32
+ import { fetchJson } from '../text-rendering/font-face-types/utils.js';
33
+ import type { Platform } from '../platforms/Platform.js';
34
+
35
+ /**
36
+ * Properties of the {@link ImageTexture}
37
+ */
38
+ export interface ImageTextureProps {
39
+ /**
40
+ * Source URL or ImageData for the image to be used as a texture.
41
+ *
42
+ * @remarks
43
+ * The ImageData type is currently only supported internally. End users should
44
+ * only set this property to a URL string.
45
+ *
46
+ * @default ''
47
+ */
48
+ src?: string | Blob | ImageData | (() => ImageData | null);
49
+ /**
50
+ * Whether to premultiply the alpha channel into the color channels of the
51
+ * image.
52
+ *
53
+ * @remarks
54
+ * Generally this should be set to `true` (the default). However, if the
55
+ * texture's associated Shader expects straight (non-premultiplied) colors,
56
+ * this should be set to `false`.
57
+ *
58
+ * @default true
59
+ */
60
+ premultiplyAlpha?: boolean | null;
61
+ /**
62
+ * `ImageData` textures are not cached unless a `key` is provided
63
+ */
64
+ key?: string | null;
65
+ /**
66
+ * Width of the image to be used as a texture. If not provided, the image's
67
+ * natural width will be used.
68
+ */
69
+ width?: number | null;
70
+ /**
71
+ * Height of the image to be used as a texture. If not provided, the image's
72
+ * natural height will be used.
73
+ */
74
+ height?: number | null;
75
+ /**
76
+ * Type, indicate an image type for overriding type detection
77
+ *
78
+ * @default null
79
+ */
80
+ type?: 'regular' | 'compressed' | 'svg' | null;
81
+ /**
82
+ * The width of the rectangle from which the ImageBitmap will be extracted. This value
83
+ * can be negative. Only works when createImageBitmap is supported on the browser.
84
+ *
85
+ * @default null
86
+ */
87
+ sw?: number | null;
88
+ /**
89
+ * The height of the rectangle from which the ImageBitmap will be extracted. This value
90
+ * can be negative. Only works when createImageBitmap is supported on the browser.
91
+ *
92
+ * @default null
93
+ */
94
+ sh?: number | null;
95
+ /**
96
+ * The y coordinate of the reference point of the rectangle from which the ImageBitmap
97
+ * will be extracted. Only used when `sw` and `sh` are provided. And only works when
98
+ * createImageBitmap is available.
99
+ *
100
+ * @default null
101
+ */
102
+ sx?: number | null;
103
+ /**
104
+ * The x coordinate of the reference point of the rectangle from which the
105
+ * ImageBitmap will be extracted. Only used when source `sw` width and `sh` height
106
+ * are provided. Only works when createImageBitmap is supported on the browser.
107
+ *
108
+ * @default null
109
+ */
110
+ sy?: number | null;
111
+ }
112
+
113
+ /**
114
+ * Texture consisting of an image loaded from a URL
115
+ *
116
+ * @remarks
117
+ * The ImageTexture's {@link ImageTextureProps.src} prop defines the image URL
118
+ * to be downloaded.
119
+ *
120
+ * By default, the texture's alpha values will be premultiplied into its color
121
+ * values which is generally the desired setting before they are sent to the
122
+ * texture's associated {@link Shader}. However, in special cases you may want
123
+ * the Shader to receive straight (non-premultiplied) values. In that case you
124
+ * can disable the default behavior by setting the
125
+ * {@link ImageTextureProps.premultiplyAlpha} prop to `false`.
126
+ */
127
+ export class ImageTexture extends Texture {
128
+ private platform: Platform;
129
+
130
+ public props: Required<ImageTextureProps>;
131
+ public override type: TextureType = TextureType.image;
132
+
133
+ constructor(txManager: CoreTextureManager, props: ImageTextureProps) {
134
+ super(txManager);
135
+
136
+ this.platform = txManager.platform;
137
+ this.props = ImageTexture.resolveDefaults(props);
138
+ }
139
+
140
+ hasAlphaChannel(mimeType: string) {
141
+ return mimeType.indexOf('image/png') !== -1;
142
+ }
143
+
144
+ async loadImageFallback(src: string | Blob, hasAlpha: boolean) {
145
+ const img = new Image();
146
+
147
+ if (typeof src === 'string' && isBase64Image(src) === false) {
148
+ img.crossOrigin = 'anonymous';
149
+ }
150
+
151
+ return new Promise<{ data: HTMLImageElement; premultiplyAlpha: boolean }>(
152
+ (resolve) => {
153
+ img.onload = () => {
154
+ resolve({ data: img, premultiplyAlpha: hasAlpha });
155
+ };
156
+
157
+ img.onerror = () => {
158
+ console.warn('Image loading failed, returning fallback object.');
159
+ resolve({ data: img, premultiplyAlpha: hasAlpha });
160
+ };
161
+
162
+ if (src instanceof Blob) {
163
+ img.src = URL.createObjectURL(src);
164
+ } else {
165
+ img.src = src;
166
+ }
167
+ },
168
+ );
169
+ }
170
+
171
+ async createImageBitmap(
172
+ blob: Blob,
173
+ premultiplyAlpha: boolean | null,
174
+ sx: number | null,
175
+ sy: number | null,
176
+ sw: number | null,
177
+ sh: number | null,
178
+ ): Promise<{
179
+ data: ImageBitmap | HTMLImageElement;
180
+ premultiplyAlpha: boolean;
181
+ }> {
182
+ const hasAlphaChannel = premultiplyAlpha ?? blob.type.includes('image/png');
183
+ const imageBitmapSupported = this.txManager.imageBitmapSupported;
184
+
185
+ if (imageBitmapSupported.full === true && sw !== null && sh !== null) {
186
+ // createImageBitmap with crop
187
+ const bitmap = await this.platform.createImageBitmap(
188
+ blob,
189
+ sx || 0,
190
+ sy || 0,
191
+ sw,
192
+ sh,
193
+ {
194
+ premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
195
+ colorSpaceConversion: 'none',
196
+ imageOrientation: 'none',
197
+ },
198
+ );
199
+ return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
200
+ } else if (imageBitmapSupported.basic === true) {
201
+ // basic createImageBitmap without options or crop
202
+ // this is supported for Chrome v50 to v52/54 that doesn't support options
203
+ return {
204
+ data: await this.platform.createImageBitmap(blob),
205
+ premultiplyAlpha: hasAlphaChannel,
206
+ };
207
+ }
208
+
209
+ // default createImageBitmap without crop but with options
210
+ const bitmap = await this.platform.createImageBitmap(blob, {
211
+ premultiplyAlpha: hasAlphaChannel ? 'premultiply' : 'none',
212
+ colorSpaceConversion: 'none',
213
+ imageOrientation: 'none',
214
+ });
215
+ return { data: bitmap, premultiplyAlpha: hasAlphaChannel };
216
+ }
217
+
218
+ async loadImage(src: string) {
219
+ const { premultiplyAlpha, sx, sy, sw, sh } = this.props;
220
+
221
+ if (this.txManager.hasCreateImageBitmap === true) {
222
+ if (
223
+ isBase64Image(src) === false &&
224
+ this.txManager.hasWorker === true &&
225
+ this.txManager.imageWorkerManager !== null
226
+ ) {
227
+ return this.txManager.imageWorkerManager.getImage(
228
+ src,
229
+ premultiplyAlpha,
230
+ sx,
231
+ sy,
232
+ sw,
233
+ sh,
234
+ );
235
+ }
236
+
237
+ let blob;
238
+
239
+ if (isBase64Image(src) === true) {
240
+ blob = dataURIToBlob(src);
241
+ } else {
242
+ blob = await fetchJson(src, 'blob').then(
243
+ (response) => response as Blob,
244
+ );
245
+ }
246
+
247
+ return this.createImageBitmap(blob, premultiplyAlpha, sx, sy, sw, sh);
248
+ }
249
+
250
+ return this.loadImageFallback(src, premultiplyAlpha ?? true);
251
+ }
252
+
253
+ override async getTextureSource(): Promise<TextureData> {
254
+ let resp;
255
+ try {
256
+ resp = await this.determineImageTypeAndLoadImage();
257
+ } catch (e) {
258
+ this.setState('failed', e as Error);
259
+ return {
260
+ data: null,
261
+ };
262
+ }
263
+
264
+ if (resp.data === null) {
265
+ this.setState('failed', Error('ImageTexture: No image data'));
266
+ return {
267
+ data: null,
268
+ };
269
+ }
270
+
271
+ let width, height;
272
+ // check if resp.data is typeof Uint8ClampedArray else
273
+ // use resp.data.width and resp.data.height
274
+ if (resp.data instanceof Uint8Array) {
275
+ width = this.props.width ?? 0;
276
+ height = this.props.height ?? 0;
277
+ } else {
278
+ width = resp.data?.width ?? (this.props.width || 0);
279
+ height = resp.data?.height ?? (this.props.height || 0);
280
+ }
281
+
282
+ // we're loaded!
283
+ this.setState('fetched', {
284
+ width,
285
+ height,
286
+ });
287
+
288
+ return {
289
+ data: resp.data,
290
+ premultiplyAlpha: this.props.premultiplyAlpha ?? true,
291
+ };
292
+ }
293
+
294
+ determineImageTypeAndLoadImage() {
295
+ const { src, premultiplyAlpha, type } = this.props;
296
+ if (src === null) {
297
+ return {
298
+ data: null,
299
+ };
300
+ }
301
+
302
+ if (typeof src !== 'string') {
303
+ if (src instanceof Blob) {
304
+ if (this.txManager.hasCreateImageBitmap === true) {
305
+ const { sx, sy, sw, sh } = this.props;
306
+ return this.createImageBitmap(src, premultiplyAlpha, sx, sy, sw, sh);
307
+ } else {
308
+ return this.loadImageFallback(src, premultiplyAlpha ?? true);
309
+ }
310
+ }
311
+ if (src instanceof ImageData) {
312
+ return {
313
+ data: src,
314
+ premultiplyAlpha,
315
+ };
316
+ }
317
+ return {
318
+ data: src(),
319
+ premultiplyAlpha,
320
+ };
321
+ }
322
+
323
+ const absoluteSrc = convertUrlToAbsolute(src);
324
+ if (type === 'regular') {
325
+ return this.loadImage(absoluteSrc);
326
+ }
327
+
328
+ if (type === 'svg') {
329
+ return loadSvg(
330
+ absoluteSrc,
331
+ this.props.width,
332
+ this.props.height,
333
+ this.props.sx,
334
+ this.props.sy,
335
+ this.props.sw,
336
+ this.props.sh,
337
+ );
338
+ }
339
+
340
+ if (isSvgImage(src) === true) {
341
+ return loadSvg(
342
+ absoluteSrc,
343
+ this.props.width,
344
+ this.props.height,
345
+ this.props.sx,
346
+ this.props.sy,
347
+ this.props.sw,
348
+ this.props.sh,
349
+ );
350
+ }
351
+
352
+ if (type === 'compressed') {
353
+ return loadCompressedTexture(absoluteSrc);
354
+ }
355
+
356
+ if (isCompressedTextureContainer(src) === true) {
357
+ return loadCompressedTexture(absoluteSrc);
358
+ }
359
+
360
+ // default
361
+ return this.loadImage(absoluteSrc);
362
+ }
363
+
364
+ /**
365
+ * Generates a cache key for the ImageTexture based on the provided props.
366
+ * @param props - The props used to generate the cache key.
367
+ * @returns The cache key as a string, or `false` if the key cannot be generated.
368
+ */
369
+ static override makeCacheKey(props: ImageTextureProps): string | false {
370
+ const resolvedProps = ImageTexture.resolveDefaults(props);
371
+ // Only cache key-able textures; prioritise key
372
+ const key = resolvedProps.key || resolvedProps.src;
373
+ if (typeof key !== 'string') {
374
+ return false;
375
+ }
376
+
377
+ // if we have source dimensions, cache the texture separately
378
+ let dimensionProps = '';
379
+ if (resolvedProps.sh !== null && resolvedProps.sw !== null) {
380
+ dimensionProps += ',';
381
+ dimensionProps += resolvedProps.sx ?? '';
382
+ dimensionProps += resolvedProps.sy ?? '';
383
+ dimensionProps += resolvedProps.sw || '';
384
+ dimensionProps += resolvedProps.sh || '';
385
+ }
386
+
387
+ return `ImageTexture,${key},${
388
+ resolvedProps.premultiplyAlpha ?? 'true'
389
+ }${dimensionProps}`;
390
+ }
391
+
392
+ static override resolveDefaults(
393
+ props: ImageTextureProps,
394
+ ): Required<ImageTextureProps> {
395
+ return {
396
+ src: props.src ?? '',
397
+ premultiplyAlpha: props.premultiplyAlpha ?? true, // null,
398
+ key: props.key ?? null,
399
+ type: props.type ?? null,
400
+ width: props.width ?? null,
401
+ height: props.height ?? null,
402
+ sx: props.sx ?? null,
403
+ sy: props.sy ?? null,
404
+ sw: props.sw ?? null,
405
+ sh: props.sh ?? null,
406
+ };
407
+ }
408
+
409
+ static z$__type__Props: ImageTextureProps;
410
+ }