@lightningjs/renderer 3.0.0-beta4 → 3.0.0-beta5

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 (335) 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.js +1 -1
  14. package/dist/src/core/CoreNode.js.map +1 -1
  15. package/dist/src/core/CoreStuff.js +138 -0
  16. package/dist/src/core/CoreStuff.js.map +1 -0
  17. package/dist/src/core/CoreTextNode.js +1 -0
  18. package/dist/src/core/CoreTextNode.js.map +1 -1
  19. package/dist/src/core/CoreTexturizer.d.ts +14 -0
  20. package/dist/src/core/CoreTexturizer.js +47 -0
  21. package/dist/src/core/CoreTexturizer.js.map +1 -0
  22. package/dist/src/core/LngNode.d.ts +736 -0
  23. package/dist/src/core/LngNode.js +1174 -0
  24. package/dist/src/core/LngNode.js.map +1 -0
  25. package/dist/src/core/Matrix2DContext.d.ts +15 -0
  26. package/dist/src/core/Matrix2DContext.js +45 -0
  27. package/dist/src/core/Matrix2DContext.js.map +1 -0
  28. package/dist/src/core/ShaderNode.d.ts +10 -0
  29. package/dist/src/core/ShaderNode.js +30 -0
  30. package/dist/src/core/ShaderNode.js.map +1 -0
  31. package/dist/src/core/TextNode.d.ts +103 -0
  32. package/dist/src/core/TextNode.js +331 -0
  33. package/dist/src/core/TextNode.js.map +1 -0
  34. package/dist/src/core/lib/Coords.d.ts +14 -0
  35. package/dist/src/core/lib/Coords.js +55 -0
  36. package/dist/src/core/lib/Coords.js.map +1 -0
  37. package/dist/src/core/lib/glm/common.d.ts +162 -0
  38. package/dist/src/core/lib/glm/common.js +81 -0
  39. package/dist/src/core/lib/glm/common.js.map +1 -0
  40. package/dist/src/core/lib/glm/index.d.ts +11 -0
  41. package/dist/src/core/lib/glm/index.js +30 -0
  42. package/dist/src/core/lib/glm/index.js.map +1 -0
  43. package/dist/src/core/lib/glm/mat2.d.ts +219 -0
  44. package/dist/src/core/lib/glm/mat2.js +396 -0
  45. package/dist/src/core/lib/glm/mat2.js.map +1 -0
  46. package/dist/src/core/lib/glm/mat2d.d.ts +237 -0
  47. package/dist/src/core/lib/glm/mat2d.js +442 -0
  48. package/dist/src/core/lib/glm/mat2d.js.map +1 -0
  49. package/dist/src/core/lib/glm/mat3.d.ts +283 -0
  50. package/dist/src/core/lib/glm/mat3.js +680 -0
  51. package/dist/src/core/lib/glm/mat3.js.map +1 -0
  52. package/dist/src/core/lib/glm/mat4.d.ts +550 -0
  53. package/dist/src/core/lib/glm/mat4.js +1802 -0
  54. package/dist/src/core/lib/glm/mat4.js.map +1 -0
  55. package/dist/src/core/lib/glm/quat.d.ts +363 -0
  56. package/dist/src/core/lib/glm/quat.js +693 -0
  57. package/dist/src/core/lib/glm/quat.js.map +1 -0
  58. package/dist/src/core/lib/glm/quat2.d.ts +356 -0
  59. package/dist/src/core/lib/glm/quat2.js +754 -0
  60. package/dist/src/core/lib/glm/quat2.js.map +1 -0
  61. package/dist/src/core/lib/glm/vec2.d.ts +365 -0
  62. package/dist/src/core/lib/glm/vec2.js +569 -0
  63. package/dist/src/core/lib/glm/vec2.js.map +1 -0
  64. package/dist/src/core/lib/glm/vec3.d.ts +406 -0
  65. package/dist/src/core/lib/glm/vec3.js +720 -0
  66. package/dist/src/core/lib/glm/vec3.js.map +1 -0
  67. package/dist/src/core/lib/glm/vec4.d.ts +330 -0
  68. package/dist/src/core/lib/glm/vec4.js +608 -0
  69. package/dist/src/core/lib/glm/vec4.js.map +1 -0
  70. package/dist/src/core/renderers/CoreShaderManager.d.ts +19 -0
  71. package/dist/src/core/renderers/CoreShaderManager.js +33 -0
  72. package/dist/src/core/renderers/CoreShaderManager.js.map +1 -0
  73. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.d.ts +27 -0
  74. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js +82 -0
  75. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js.map +1 -0
  76. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.d.ts +11 -0
  77. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js +34 -0
  78. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js.map +1 -0
  79. package/dist/src/core/renderers/webgl/internal/ShaderUtils.js +35 -35
  80. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  81. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  82. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  83. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  84. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  85. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  86. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  87. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  88. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  89. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  90. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  91. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  92. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  93. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  94. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  95. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  96. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  97. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  98. package/dist/src/core/scene/Scene.d.ts +59 -0
  99. package/dist/src/core/scene/Scene.js +106 -0
  100. package/dist/src/core/scene/Scene.js.map +1 -0
  101. package/dist/src/core/shaders/webgl/Border.js +59 -59
  102. package/dist/src/core/shaders/webgl/Default.js +47 -47
  103. package/dist/src/core/shaders/webgl/DefaultBatched.js +61 -61
  104. package/dist/src/core/shaders/webgl/HolePunch.js +32 -32
  105. package/dist/src/core/shaders/webgl/LinearGradient.js +36 -36
  106. package/dist/src/core/shaders/webgl/RadialGradient.js +33 -33
  107. package/dist/src/core/shaders/webgl/Rounded.js +71 -71
  108. package/dist/src/core/shaders/webgl/RoundedWithBorder.js +66 -66
  109. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js +79 -79
  110. package/dist/src/core/shaders/webgl/RoundedWithShadow.js +54 -54
  111. package/dist/src/core/shaders/webgl/SdfShader.js +62 -62
  112. package/dist/src/core/shaders/webgl/Shadow.js +83 -83
  113. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.d.ts +20 -0
  114. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js +55 -0
  115. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js.map +1 -0
  116. package/dist/src/main-api/ICoreDriver.d.ts +27 -0
  117. package/dist/src/main-api/ICoreDriver.js +20 -0
  118. package/dist/src/main-api/ICoreDriver.js.map +1 -0
  119. package/dist/src/main-api/IRenderDriver.d.ts +20 -0
  120. package/dist/src/main-api/IRenderDriver.js +20 -0
  121. package/dist/src/main-api/IRenderDriver.js.map +1 -0
  122. package/dist/src/main-api/IShaderController.d.ts +14 -0
  123. package/dist/src/main-api/IShaderController.js +30 -0
  124. package/dist/src/main-api/IShaderController.js.map +1 -0
  125. package/dist/src/main-api/IShaderNode.d.ts +17 -0
  126. package/dist/src/main-api/IShaderNode.js +19 -0
  127. package/dist/src/main-api/IShaderNode.js.map +1 -0
  128. package/dist/src/main-api/RendererMain.d.ts +375 -0
  129. package/dist/src/main-api/RendererMain.js +365 -0
  130. package/dist/src/main-api/RendererMain.js.map +1 -0
  131. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +9 -0
  132. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +38 -0
  133. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +1 -0
  134. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +56 -0
  135. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +101 -0
  136. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +1 -0
  137. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +32 -0
  138. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +28 -0
  139. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +1 -0
  140. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +24 -0
  141. package/dist/src/render-drivers/main/MainCoreDriver.js +118 -0
  142. package/dist/src/render-drivers/main/MainCoreDriver.js.map +1 -0
  143. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +99 -0
  144. package/dist/src/render-drivers/main/MainOnlyNode.js +396 -0
  145. package/dist/src/render-drivers/main/MainOnlyNode.js.map +1 -0
  146. package/dist/src/render-drivers/main/MainOnlyShaderController.d.ts +6 -0
  147. package/dist/src/render-drivers/main/MainOnlyShaderController.js +15 -0
  148. package/dist/src/render-drivers/main/MainOnlyShaderController.js.map +1 -0
  149. package/dist/src/render-drivers/main/MainOnlyShaderNode.d.ts +7 -0
  150. package/dist/src/render-drivers/main/MainOnlyShaderNode.js +34 -0
  151. package/dist/src/render-drivers/main/MainOnlyShaderNode.js.map +1 -0
  152. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +47 -0
  153. package/dist/src/render-drivers/main/MainOnlyTextNode.js +205 -0
  154. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +1 -0
  155. package/dist/src/render-drivers/main/MainRenderDriver.d.ts +17 -0
  156. package/dist/src/render-drivers/main/MainRenderDriver.js +88 -0
  157. package/dist/src/render-drivers/main/MainRenderDriver.js.map +1 -0
  158. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +90 -0
  159. package/dist/src/render-drivers/threadx/NodeStruct.js +281 -0
  160. package/dist/src/render-drivers/threadx/NodeStruct.js.map +1 -0
  161. package/dist/src/render-drivers/threadx/SharedNode.d.ts +39 -0
  162. package/dist/src/render-drivers/threadx/SharedNode.js +60 -0
  163. package/dist/src/render-drivers/threadx/SharedNode.js.map +1 -0
  164. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +44 -0
  165. package/dist/src/render-drivers/threadx/TextNodeStruct.js +201 -0
  166. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +1 -0
  167. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +28 -0
  168. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +234 -0
  169. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +1 -0
  170. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +20 -0
  171. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +84 -0
  172. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +1 -0
  173. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +44 -0
  174. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +154 -0
  175. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +1 -0
  176. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.d.ts +6 -0
  177. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js +16 -0
  178. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js.map +1 -0
  179. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.d.ts +7 -0
  180. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js +15 -0
  181. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js.map +1 -0
  182. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +28 -0
  183. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +55 -0
  184. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +1 -0
  185. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.d.ts +21 -0
  186. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js +198 -0
  187. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js.map +1 -0
  188. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +70 -0
  189. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +32 -0
  190. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +1 -0
  191. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +19 -0
  192. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +177 -0
  193. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +1 -0
  194. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +27 -0
  195. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +108 -0
  196. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +1 -0
  197. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +1 -0
  198. package/dist/src/render-drivers/threadx/worker/renderer.js +145 -0
  199. package/dist/src/render-drivers/threadx/worker/renderer.js.map +1 -0
  200. package/dist/src/render-drivers/utils.d.ts +12 -0
  201. package/dist/src/render-drivers/utils.js +69 -0
  202. package/dist/src/render-drivers/utils.js.map +1 -0
  203. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  204. package/exports/canvas-shaders.ts +28 -28
  205. package/exports/canvas.ts +45 -45
  206. package/exports/index.ts +90 -90
  207. package/exports/inspector.ts +24 -24
  208. package/exports/utils.ts +44 -44
  209. package/exports/webgl-shaders.ts +28 -28
  210. package/exports/webgl.ts +50 -50
  211. package/package.json +2 -1
  212. package/scripts/please-use-pnpm.js +13 -13
  213. package/src/common/CommonTypes.ts +146 -146
  214. package/src/common/EventEmitter.ts +77 -77
  215. package/src/common/IAnimationController.ts +92 -92
  216. package/src/common/IEventEmitter.ts +28 -28
  217. package/src/core/CoreNode.test.ts +203 -203
  218. package/src/core/CoreNode.ts +2494 -2494
  219. package/src/core/CoreShaderManager.ts +188 -188
  220. package/src/core/CoreTextNode.ts +449 -448
  221. package/src/core/CoreTextureManager.ts +601 -601
  222. package/src/core/Stage.ts +754 -754
  223. package/src/core/TextureMemoryManager.ts +395 -395
  224. package/src/core/animations/AnimationManager.ts +38 -38
  225. package/src/core/animations/CoreAnimation.ts +284 -284
  226. package/src/core/animations/CoreAnimationController.ts +157 -157
  227. package/src/core/lib/ContextSpy.ts +41 -41
  228. package/src/core/lib/ImageWorker.ts +280 -280
  229. package/src/core/lib/Matrix3d.ts +244 -244
  230. package/src/core/lib/RenderCoords.ts +71 -71
  231. package/src/core/lib/WebGlContextWrapper.ts +1374 -1374
  232. package/src/core/lib/textureCompression.ts +152 -152
  233. package/src/core/lib/textureSvg.ts +78 -78
  234. package/src/core/lib/utils.ts +386 -386
  235. package/src/core/lib/validateImageBitmap.ts +87 -87
  236. package/src/core/platform.ts +64 -64
  237. package/src/core/platforms/Platform.ts +77 -77
  238. package/src/core/platforms/web/WebPlatform.ts +84 -84
  239. package/src/core/renderers/CoreContextTexture.ts +43 -43
  240. package/src/core/renderers/CoreRenderOp.ts +22 -22
  241. package/src/core/renderers/CoreRenderer.ts +109 -109
  242. package/src/core/renderers/CoreShaderNode.ts +165 -165
  243. package/src/core/renderers/CoreShaderProgram.ts +23 -23
  244. package/src/core/renderers/canvas/CanvasRenderer.ts +298 -298
  245. package/src/core/renderers/canvas/CanvasShaderNode.ts +99 -99
  246. package/src/core/renderers/canvas/CanvasTexture.ts +156 -156
  247. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +220 -220
  248. package/src/core/renderers/canvas/internal/ColorUtils.ts +85 -85
  249. package/src/core/renderers/webgl/WebGlCtxRenderTexture.ts +86 -86
  250. package/src/core/renderers/webgl/WebGlCtxSubTexture.ts +50 -50
  251. package/src/core/renderers/webgl/WebGlCtxTexture.ts +301 -301
  252. package/src/core/renderers/webgl/WebGlRenderOp.ts +161 -161
  253. package/src/core/renderers/webgl/WebGlRenderer.ts +750 -750
  254. package/src/core/renderers/webgl/WebGlShaderNode.ts +437 -437
  255. package/src/core/renderers/webgl/WebGlShaderProgram.ts +318 -318
  256. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  257. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  258. package/src/core/renderers/webgl/internal/ShaderUtils.ts +281 -281
  259. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  260. package/src/core/shaders/canvas/Border.ts +78 -78
  261. package/src/core/shaders/canvas/HolePunch.ts +62 -62
  262. package/src/core/shaders/canvas/LinearGradient.ts +69 -69
  263. package/src/core/shaders/canvas/RadialGradient.ts +113 -113
  264. package/src/core/shaders/canvas/Rounded.ts +55 -55
  265. package/src/core/shaders/canvas/RoundedWithBorder.ts +68 -68
  266. package/src/core/shaders/canvas/RoundedWithBorderAndShadow.ts +88 -88
  267. package/src/core/shaders/canvas/RoundedWithShadow.ts +69 -69
  268. package/src/core/shaders/canvas/Shadow.ts +52 -52
  269. package/src/core/shaders/canvas/utils/render.ts +151 -151
  270. package/src/core/shaders/templates/BorderTemplate.ts +115 -115
  271. package/src/core/shaders/templates/HolePunchTemplate.ts +82 -82
  272. package/src/core/shaders/templates/LinearGradientTemplate.ts +71 -71
  273. package/src/core/shaders/templates/RadialGradientTemplate.ts +81 -81
  274. package/src/core/shaders/templates/RoundedTemplate.ts +98 -98
  275. package/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.ts +38 -38
  276. package/src/core/shaders/templates/RoundedWithBorderTemplate.ts +35 -35
  277. package/src/core/shaders/templates/RoundedWithShadowTemplate.ts +35 -35
  278. package/src/core/shaders/templates/ShadowTemplate.ts +106 -106
  279. package/src/core/shaders/templates/shaderUtils.ts +47 -47
  280. package/src/core/shaders/webgl/Border.ts +96 -96
  281. package/src/core/shaders/webgl/Default.ts +89 -89
  282. package/src/core/shaders/webgl/DefaultBatched.ts +129 -129
  283. package/src/core/shaders/webgl/HolePunch.ts +78 -78
  284. package/src/core/shaders/webgl/LinearGradient.ts +81 -81
  285. package/src/core/shaders/webgl/RadialGradient.ts +84 -84
  286. package/src/core/shaders/webgl/Rounded.ts +117 -117
  287. package/src/core/shaders/webgl/RoundedWithBorder.ts +114 -114
  288. package/src/core/shaders/webgl/RoundedWithBorderAndShadow.ts +133 -133
  289. package/src/core/shaders/webgl/RoundedWithShadow.ts +98 -98
  290. package/src/core/shaders/webgl/SdfShader.ts +134 -134
  291. package/src/core/shaders/webgl/Shadow.ts +115 -115
  292. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  293. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  294. package/src/core/text-rendering/TrFontManager.ts +183 -183
  295. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  296. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  297. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  298. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  299. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  300. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -94
  301. package/src/core/text-rendering/font-face-types/utils.ts +39 -39
  302. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +514 -514
  303. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +863 -863
  304. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +846 -846
  305. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  306. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  307. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  308. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  309. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  310. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  311. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  312. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +497 -497
  313. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  314. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  315. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  316. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  317. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  318. package/src/core/text-rendering/renderers/TextRenderer.ts +567 -567
  319. package/src/core/textures/ColorTexture.ts +102 -102
  320. package/src/core/textures/ImageTexture.ts +410 -410
  321. package/src/core/textures/NoiseTexture.ts +104 -104
  322. package/src/core/textures/RenderTexture.ts +85 -85
  323. package/src/core/textures/SubTexture.ts +205 -205
  324. package/src/core/textures/Texture.ts +358 -358
  325. package/src/core/utils.ts +227 -227
  326. package/src/env.d.ts +7 -7
  327. package/src/main-api/INode.ts +100 -100
  328. package/src/main-api/Inspector.ts +522 -522
  329. package/src/main-api/Renderer.ts +675 -675
  330. package/src/main-api/utils.ts +45 -45
  331. package/src/utils.ts +267 -267
  332. package/COPYING +0 -1
  333. package/dist/src/core/temp.js +0 -77
  334. package/dist/src/core/temp.js.map +0 -1
  335. /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
+ }