@lightningjs/renderer 2.13.1 → 2.13.2

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 (344) hide show
  1. package/COPYING +1 -0
  2. package/LICENSE +202 -202
  3. package/NOTICE +3 -3
  4. package/README.md +147 -147
  5. package/dist/exports/canvas-shaders.d.ts +10 -0
  6. package/dist/exports/canvas-shaders.js +27 -0
  7. package/dist/exports/canvas-shaders.js.map +1 -0
  8. package/dist/exports/webgl-shaders.d.ts +11 -0
  9. package/dist/exports/webgl-shaders.js +28 -0
  10. package/dist/exports/webgl-shaders.js.map +1 -0
  11. package/dist/src/core/renderers/CoreShaderNode.d.ts +59 -0
  12. package/dist/src/core/renderers/CoreShaderNode.js +107 -0
  13. package/dist/src/core/renderers/CoreShaderNode.js.map +1 -0
  14. package/dist/src/core/renderers/CoreShaderProgram.d.ts +4 -0
  15. package/dist/src/{main-api/ICoreDriver.js → core/renderers/CoreShaderProgram.js} +1 -1
  16. package/dist/src/core/renderers/CoreShaderProgram.js.map +1 -0
  17. package/dist/src/core/renderers/canvas/CanvasRenderer.d.ts +36 -0
  18. package/dist/src/core/renderers/canvas/CanvasRenderer.js +212 -0
  19. package/dist/src/core/renderers/canvas/CanvasRenderer.js.map +1 -0
  20. package/dist/src/core/renderers/canvas/CanvasShaderNode.d.ts +21 -0
  21. package/dist/src/core/renderers/canvas/CanvasShaderNode.js +60 -0
  22. package/dist/src/core/renderers/canvas/CanvasShaderNode.js.map +1 -0
  23. package/dist/src/core/renderers/canvas/CanvasTexture.d.ts +16 -0
  24. package/dist/src/core/renderers/canvas/CanvasTexture.js +123 -0
  25. package/dist/src/core/renderers/canvas/CanvasTexture.js.map +1 -0
  26. package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.d.ts +12 -0
  27. package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js +55 -0
  28. package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js.map +1 -0
  29. package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.d.ts +9 -0
  30. package/dist/src/{main-api/texture-usage-trackers/TextureUsageTracker.js → core/renderers/webgl/WebGlCtxSubTexture.js} +18 -8
  31. package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js.map +1 -0
  32. package/dist/src/core/renderers/webgl/WebGlCtxTexture.d.ts +57 -0
  33. package/dist/src/core/renderers/webgl/WebGlCtxTexture.js +227 -0
  34. package/dist/src/core/renderers/webgl/WebGlCtxTexture.js.map +1 -0
  35. package/dist/src/core/renderers/webgl/WebGlRenderOp.d.ts +36 -0
  36. package/dist/src/core/renderers/webgl/WebGlRenderOp.js +107 -0
  37. package/dist/src/core/renderers/webgl/WebGlRenderOp.js.map +1 -0
  38. package/dist/src/core/renderers/webgl/WebGlRenderer.d.ts +134 -0
  39. package/dist/src/core/renderers/webgl/WebGlRenderer.js +546 -0
  40. package/dist/src/core/renderers/webgl/WebGlRenderer.js.map +1 -0
  41. package/dist/src/core/renderers/webgl/WebGlShaderNode.d.ts +221 -0
  42. package/dist/src/core/renderers/webgl/WebGlShaderNode.js +334 -0
  43. package/dist/src/core/renderers/webgl/WebGlShaderNode.js.map +1 -0
  44. package/dist/src/core/renderers/webgl/WebGlShaderProgram.d.ts +35 -0
  45. package/dist/src/core/renderers/webgl/WebGlShaderProgram.js +195 -0
  46. package/dist/src/core/renderers/webgl/WebGlShaderProgram.js.map +1 -0
  47. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  48. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  49. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  50. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  51. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  52. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  53. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  54. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  55. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  56. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  57. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  58. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  59. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  60. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  61. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  62. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  63. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  64. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  65. package/dist/src/core/shaders/canvas/Border.d.ts +9 -0
  66. package/dist/src/core/shaders/canvas/Border.js +57 -0
  67. package/dist/src/core/shaders/canvas/Border.js.map +1 -0
  68. package/dist/src/core/shaders/canvas/HolePunch.d.ts +7 -0
  69. package/dist/src/core/shaders/canvas/HolePunch.js +38 -0
  70. package/dist/src/core/shaders/canvas/HolePunch.js.map +1 -0
  71. package/dist/src/core/shaders/canvas/LinearGradient.d.ts +10 -0
  72. package/dist/src/core/shaders/canvas/LinearGradient.js +46 -0
  73. package/dist/src/core/shaders/canvas/LinearGradient.js.map +1 -0
  74. package/dist/src/core/shaders/canvas/RadialGradient.d.ts +11 -0
  75. package/dist/src/core/shaders/canvas/RadialGradient.js +68 -0
  76. package/dist/src/core/shaders/canvas/RadialGradient.js.map +1 -0
  77. package/dist/src/core/shaders/canvas/Rounded.d.ts +7 -0
  78. package/dist/src/core/shaders/canvas/Rounded.js +33 -0
  79. package/dist/src/core/shaders/canvas/Rounded.js.map +1 -0
  80. package/dist/src/core/shaders/canvas/RoundedWithBorder.d.ts +7 -0
  81. package/dist/src/core/shaders/canvas/RoundedWithBorder.js +35 -0
  82. package/dist/src/core/shaders/canvas/RoundedWithBorder.js.map +1 -0
  83. package/dist/src/core/shaders/canvas/RoundedWithBorderAndShadow.d.ts +8 -0
  84. package/dist/src/core/shaders/canvas/RoundedWithBorderAndShadow.js +39 -0
  85. package/dist/src/core/shaders/canvas/RoundedWithBorderAndShadow.js.map +1 -0
  86. package/dist/src/core/shaders/canvas/RoundedWithShadow.d.ts +7 -0
  87. package/dist/src/core/shaders/canvas/RoundedWithShadow.js +38 -0
  88. package/dist/src/core/shaders/canvas/RoundedWithShadow.js.map +1 -0
  89. package/dist/src/core/shaders/canvas/Shadow.d.ts +8 -0
  90. package/dist/src/core/shaders/canvas/Shadow.js +31 -0
  91. package/dist/src/core/shaders/canvas/Shadow.js.map +1 -0
  92. package/dist/src/core/shaders/canvas/utils/render.d.ts +5 -0
  93. package/dist/src/core/shaders/canvas/utils/render.js +84 -0
  94. package/dist/src/core/shaders/canvas/utils/render.js.map +1 -0
  95. package/dist/src/core/shaders/templates/BorderTemplate.d.ts +37 -0
  96. package/dist/src/core/shaders/templates/BorderTemplate.js +73 -0
  97. package/dist/src/core/shaders/templates/BorderTemplate.js.map +1 -0
  98. package/dist/src/core/shaders/templates/HolePunchTemplate.d.ts +46 -0
  99. package/dist/src/core/shaders/templates/HolePunchTemplate.js +35 -0
  100. package/dist/src/core/shaders/templates/HolePunchTemplate.js.map +1 -0
  101. package/dist/src/core/shaders/templates/LinearGradientTemplate.d.ts +23 -0
  102. package/dist/src/core/shaders/templates/LinearGradientTemplate.js +47 -0
  103. package/dist/src/core/shaders/templates/LinearGradientTemplate.js.map +1 -0
  104. package/dist/src/core/shaders/templates/RadialGradientTemplate.d.ts +31 -0
  105. package/dist/src/core/shaders/templates/RadialGradientTemplate.js +49 -0
  106. package/dist/src/core/shaders/templates/RadialGradientTemplate.js.map +1 -0
  107. package/dist/src/core/shaders/templates/RoundedTemplate.d.ts +29 -0
  108. package/dist/src/core/shaders/templates/RoundedTemplate.js +67 -0
  109. package/dist/src/core/shaders/templates/RoundedTemplate.js.map +1 -0
  110. package/dist/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.d.ts +7 -0
  111. package/dist/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.js +24 -0
  112. package/dist/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.js.map +1 -0
  113. package/dist/src/core/shaders/templates/RoundedWithBorderTemplate.d.ts +6 -0
  114. package/dist/src/core/shaders/templates/RoundedWithBorderTemplate.js +23 -0
  115. package/dist/src/core/shaders/templates/RoundedWithBorderTemplate.js.map +1 -0
  116. package/dist/src/core/shaders/templates/RoundedWithShadowTemplate.d.ts +6 -0
  117. package/dist/src/core/shaders/templates/RoundedWithShadowTemplate.js +23 -0
  118. package/dist/src/core/shaders/templates/RoundedWithShadowTemplate.js.map +1 -0
  119. package/dist/src/core/shaders/templates/ShadowTemplate.d.ts +34 -0
  120. package/dist/src/core/shaders/templates/ShadowTemplate.js +66 -0
  121. package/dist/src/core/shaders/templates/ShadowTemplate.js.map +1 -0
  122. package/dist/src/core/shaders/templates/shaderUtils.d.ts +5 -0
  123. package/dist/src/core/shaders/templates/shaderUtils.js +41 -0
  124. package/dist/src/core/shaders/templates/shaderUtils.js.map +1 -0
  125. package/dist/src/core/shaders/webgl/Border.d.ts +3 -0
  126. package/dist/src/core/shaders/webgl/Border.js +87 -0
  127. package/dist/src/core/shaders/webgl/Border.js.map +1 -0
  128. package/dist/src/core/shaders/webgl/Default.d.ts +2 -0
  129. package/dist/src/core/shaders/webgl/Default.js +86 -0
  130. package/dist/src/core/shaders/webgl/Default.js.map +1 -0
  131. package/dist/src/core/shaders/webgl/DefaultBatched.d.ts +2 -0
  132. package/dist/src/core/shaders/webgl/DefaultBatched.js +104 -0
  133. package/dist/src/core/shaders/webgl/DefaultBatched.js.map +1 -0
  134. package/dist/src/core/shaders/webgl/HolePunch.d.ts +3 -0
  135. package/dist/src/core/shaders/webgl/HolePunch.js +64 -0
  136. package/dist/src/core/shaders/webgl/HolePunch.js.map +1 -0
  137. package/dist/src/core/shaders/webgl/LinearGradient.d.ts +3 -0
  138. package/dist/src/core/shaders/webgl/LinearGradient.js +75 -0
  139. package/dist/src/core/shaders/webgl/LinearGradient.js.map +1 -0
  140. package/dist/src/core/shaders/webgl/RadialGradient.d.ts +3 -0
  141. package/dist/src/core/shaders/webgl/RadialGradient.js +73 -0
  142. package/dist/src/core/shaders/webgl/RadialGradient.js.map +1 -0
  143. package/dist/src/core/shaders/webgl/Rounded.d.ts +7 -0
  144. package/dist/src/core/shaders/webgl/Rounded.js +86 -0
  145. package/dist/src/core/shaders/webgl/Rounded.js.map +1 -0
  146. package/dist/src/core/shaders/webgl/RoundedWithBorder.d.ts +3 -0
  147. package/dist/src/core/shaders/webgl/RoundedWithBorder.js +97 -0
  148. package/dist/src/core/shaders/webgl/RoundedWithBorder.js.map +1 -0
  149. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.d.ts +3 -0
  150. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js +112 -0
  151. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js.map +1 -0
  152. package/dist/src/core/shaders/webgl/RoundedWithShadow.d.ts +3 -0
  153. package/dist/src/core/shaders/webgl/RoundedWithShadow.js +84 -0
  154. package/dist/src/core/shaders/webgl/RoundedWithShadow.js.map +1 -0
  155. package/dist/src/core/shaders/webgl/SdfShader.d.ts +32 -0
  156. package/dist/src/core/shaders/webgl/SdfShader.js +116 -0
  157. package/dist/src/core/shaders/webgl/SdfShader.js.map +1 -0
  158. package/dist/src/core/shaders/webgl/Shadow.d.ts +3 -0
  159. package/dist/src/core/shaders/webgl/Shadow.js +110 -0
  160. package/dist/src/core/shaders/webgl/Shadow.js.map +1 -0
  161. package/dist/src/core/textures/Texture.d.ts +4 -2
  162. package/dist/src/core/textures/Texture.js +18 -6
  163. package/dist/src/core/textures/Texture.js.map +1 -1
  164. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  165. package/exports/canvas.ts +39 -39
  166. package/exports/index.ts +89 -89
  167. package/exports/inspector.ts +24 -24
  168. package/exports/utils.ts +44 -44
  169. package/exports/webgl.ts +38 -38
  170. package/package.json +1 -2
  171. package/scripts/please-use-pnpm.js +13 -13
  172. package/src/common/CommonTypes.ts +146 -146
  173. package/src/common/EventEmitter.ts +77 -77
  174. package/src/common/IAnimationController.ts +92 -92
  175. package/src/common/IEventEmitter.ts +28 -28
  176. package/src/core/CoreNode.test.ts +202 -202
  177. package/src/core/CoreNode.ts +2455 -2455
  178. package/src/core/CoreShaderManager.ts +292 -292
  179. package/src/core/CoreTextNode.ts +455 -455
  180. package/src/core/CoreTextureManager.ts +597 -597
  181. package/src/core/Stage.ts +743 -743
  182. package/src/core/TextureMemoryManager.ts +395 -395
  183. package/src/core/animations/AnimationManager.ts +38 -38
  184. package/src/core/animations/CoreAnimation.ts +340 -340
  185. package/src/core/animations/CoreAnimationController.ts +157 -157
  186. package/src/core/lib/ContextSpy.ts +41 -41
  187. package/src/core/lib/ImageWorker.ts +280 -280
  188. package/src/core/lib/Matrix3d.ts +244 -244
  189. package/src/core/lib/RenderCoords.ts +86 -86
  190. package/src/core/lib/WebGlContextWrapper.ts +1332 -1332
  191. package/src/core/lib/textureCompression.ts +152 -152
  192. package/src/core/lib/textureSvg.ts +78 -78
  193. package/src/core/lib/utils.ts +384 -384
  194. package/src/core/lib/validateImageBitmap.ts +76 -76
  195. package/src/core/platform.ts +63 -63
  196. package/src/core/renderers/CoreContextTexture.ts +43 -43
  197. package/src/core/renderers/CoreRenderOp.ts +22 -22
  198. package/src/core/renderers/CoreRenderer.ts +115 -115
  199. package/src/core/renderers/CoreShader.ts +41 -41
  200. package/src/core/renderers/canvas/CanvasCoreRenderer.ts +375 -375
  201. package/src/core/renderers/canvas/CanvasCoreTexture.ts +153 -153
  202. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +231 -231
  203. package/src/core/renderers/canvas/internal/ColorUtils.ts +69 -69
  204. package/src/core/renderers/canvas/shaders/UnsupportedShader.ts +48 -48
  205. package/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.ts +86 -86
  206. package/src/core/renderers/webgl/WebGlCoreCtxSubTexture.ts +50 -50
  207. package/src/core/renderers/webgl/WebGlCoreCtxTexture.ts +301 -301
  208. package/src/core/renderers/webgl/WebGlCoreRenderOp.ts +125 -125
  209. package/src/core/renderers/webgl/WebGlCoreRenderer.ts +815 -815
  210. package/src/core/renderers/webgl/WebGlCoreShader.ts +362 -362
  211. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  212. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  213. package/src/core/renderers/webgl/internal/ShaderUtils.ts +143 -143
  214. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  215. package/src/core/renderers/webgl/shaders/DefaultShader.ts +93 -93
  216. package/src/core/renderers/webgl/shaders/DefaultShaderBatched.ts +132 -132
  217. package/src/core/renderers/webgl/shaders/DynamicShader.ts +580 -580
  218. package/src/core/renderers/webgl/shaders/RoundedRectangle.ts +167 -167
  219. package/src/core/renderers/webgl/shaders/SdfShader.ts +204 -204
  220. package/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.ts +101 -101
  221. package/src/core/renderers/webgl/shaders/effects/BorderEffect.ts +87 -87
  222. package/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.ts +101 -101
  223. package/src/core/renderers/webgl/shaders/effects/BorderRightEffect.ts +101 -101
  224. package/src/core/renderers/webgl/shaders/effects/BorderTopEffect.ts +101 -101
  225. package/src/core/renderers/webgl/shaders/effects/EffectUtils.ts +159 -159
  226. package/src/core/renderers/webgl/shaders/effects/FadeOutEffect.ts +127 -127
  227. package/src/core/renderers/webgl/shaders/effects/GlitchEffect.ts +148 -148
  228. package/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts +67 -67
  229. package/src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts +157 -157
  230. package/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts +171 -171
  231. package/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts +168 -168
  232. package/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.ts +187 -187
  233. package/src/core/renderers/webgl/shaders/effects/RadiusEffect.ts +110 -110
  234. package/src/core/renderers/webgl/shaders/effects/ShaderEffect.ts +196 -196
  235. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  236. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  237. package/src/core/text-rendering/TrFontManager.ts +183 -183
  238. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  239. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  240. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  241. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  242. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  243. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -94
  244. package/src/core/text-rendering/font-face-types/utils.ts +39 -39
  245. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +509 -509
  246. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +808 -808
  247. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +853 -853
  248. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  249. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  250. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  251. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  252. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  253. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  254. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  255. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +408 -408
  256. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  257. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  258. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  259. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  260. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  261. package/src/core/text-rendering/renderers/TextRenderer.ts +557 -557
  262. package/src/core/textures/ColorTexture.ts +102 -102
  263. package/src/core/textures/ImageTexture.ts +399 -399
  264. package/src/core/textures/NoiseTexture.ts +104 -104
  265. package/src/core/textures/RenderTexture.ts +85 -85
  266. package/src/core/textures/SubTexture.ts +205 -205
  267. package/src/core/textures/Texture.ts +353 -337
  268. package/src/core/utils.ts +227 -227
  269. package/src/env.d.ts +7 -7
  270. package/src/main-api/DynamicShaderController.ts +104 -104
  271. package/src/main-api/INode.ts +101 -101
  272. package/src/main-api/Inspector.ts +522 -522
  273. package/src/main-api/Renderer.ts +751 -751
  274. package/src/main-api/ShaderController.ts +80 -80
  275. package/src/main-api/utils.ts +45 -45
  276. package/src/utils.ts +248 -248
  277. package/dist/exports/core-api.d.ts +0 -74
  278. package/dist/exports/core-api.js +0 -96
  279. package/dist/exports/core-api.js.map +0 -1
  280. package/dist/exports/main-api.d.ts +0 -30
  281. package/dist/exports/main-api.js +0 -45
  282. package/dist/exports/main-api.js.map +0 -1
  283. package/dist/src/core/CoreExtension.d.ts +0 -12
  284. package/dist/src/core/CoreExtension.js +0 -29
  285. package/dist/src/core/CoreExtension.js.map +0 -1
  286. package/dist/src/main-api/ICoreDriver.d.ts +0 -24
  287. package/dist/src/main-api/ICoreDriver.js.map +0 -1
  288. package/dist/src/main-api/RendererMain.d.ts +0 -378
  289. package/dist/src/main-api/RendererMain.js +0 -367
  290. package/dist/src/main-api/RendererMain.js.map +0 -1
  291. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +0 -9
  292. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +0 -38
  293. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +0 -1
  294. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +0 -56
  295. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +0 -101
  296. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +0 -1
  297. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +0 -32
  298. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +0 -1
  299. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +0 -21
  300. package/dist/src/render-drivers/main/MainCoreDriver.js +0 -115
  301. package/dist/src/render-drivers/main/MainCoreDriver.js.map +0 -1
  302. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +0 -101
  303. package/dist/src/render-drivers/main/MainOnlyNode.js +0 -425
  304. package/dist/src/render-drivers/main/MainOnlyNode.js.map +0 -1
  305. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +0 -47
  306. package/dist/src/render-drivers/main/MainOnlyTextNode.js +0 -204
  307. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +0 -1
  308. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +0 -93
  309. package/dist/src/render-drivers/threadx/NodeStruct.js +0 -290
  310. package/dist/src/render-drivers/threadx/NodeStruct.js.map +0 -1
  311. package/dist/src/render-drivers/threadx/SharedNode.d.ts +0 -40
  312. package/dist/src/render-drivers/threadx/SharedNode.js +0 -61
  313. package/dist/src/render-drivers/threadx/SharedNode.js.map +0 -1
  314. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +0 -44
  315. package/dist/src/render-drivers/threadx/TextNodeStruct.js +0 -203
  316. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +0 -1
  317. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +0 -25
  318. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +0 -232
  319. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +0 -1
  320. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +0 -24
  321. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +0 -113
  322. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +0 -1
  323. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +0 -46
  324. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +0 -160
  325. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +0 -1
  326. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +0 -28
  327. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +0 -55
  328. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +0 -1
  329. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +0 -70
  330. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +0 -32
  331. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +0 -1
  332. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +0 -19
  333. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +0 -184
  334. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +0 -1
  335. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +0 -27
  336. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +0 -109
  337. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +0 -1
  338. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +0 -1
  339. package/dist/src/render-drivers/threadx/worker/renderer.js +0 -147
  340. package/dist/src/render-drivers/threadx/worker/renderer.js.map +0 -1
  341. package/dist/src/render-drivers/utils.d.ts +0 -12
  342. package/dist/src/render-drivers/utils.js +0 -74
  343. package/dist/src/render-drivers/utils.js.map +0 -1
  344. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -1,455 +1,455 @@
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 {
21
- TextRenderer,
22
- TextRendererMap,
23
- TrProps,
24
- TextRendererState,
25
- TrFailedEventHandler,
26
- TrLoadedEventHandler,
27
- } from './text-rendering/renderers/TextRenderer.js';
28
- import { CoreNode, UpdateType, type CoreNodeProps } from './CoreNode.js';
29
- import type { Stage } from './Stage.js';
30
- import type { CoreRenderer } from './renderers/CoreRenderer.js';
31
- import type {
32
- NodeTextFailedPayload,
33
- NodeTextLoadedPayload,
34
- } from '../common/CommonTypes.js';
35
- import type { RectWithValid } from './lib/utils.js';
36
- import { assertTruthy } from '../utils.js';
37
- import { Matrix3d } from './lib/Matrix3d.js';
38
-
39
- export interface CoreTextNodeProps extends CoreNodeProps, TrProps {
40
- /**
41
- * Force Text Node to use a specific Text Renderer
42
- *
43
- * @remarks
44
- * By default, Text Nodes resolve the Text Renderer to use based on the font
45
- * that is matched using the font family and other font selection properties.
46
- *
47
- * If two fonts supported by two separate Text Renderers are matched setting
48
- * this override forces the Text Node to resolve to the Text Renderer defined
49
- * here.
50
- *
51
- * @default null
52
- */
53
- textRendererOverride: keyof TextRendererMap | null;
54
- }
55
-
56
- /**
57
- * An CoreNode in the Renderer scene graph that renders text.
58
- *
59
- * @remarks
60
- * A Text Node is the second graphical building block of the Renderer scene
61
- * graph. It renders text using a specific text renderer that is automatically
62
- * chosen based on the font requested and what type of fonts are installed
63
- * into an app.
64
- *
65
- * The text renderer can be overridden by setting the `textRendererOverride`
66
- *
67
- * The `texture` and `shader` properties are managed by loaded text renderer and
68
- * should not be set directly.
69
- *
70
- * For non-text rendering, see {@link CoreNode}.
71
- */
72
- export class CoreTextNode extends CoreNode implements CoreTextNodeProps {
73
- textRenderer: TextRenderer;
74
- trState: TextRendererState;
75
- private _textRendererOverride: CoreTextNodeProps['textRendererOverride'] =
76
- null;
77
-
78
- constructor(
79
- stage: Stage,
80
- props: CoreTextNodeProps,
81
- textRenderer: TextRenderer,
82
- ) {
83
- super(stage, props);
84
- this._textRendererOverride = props.textRendererOverride;
85
- this.textRenderer = textRenderer;
86
- const textRendererState = this.createState({
87
- x: this.absX,
88
- y: this.absY,
89
- width: props.width,
90
- height: props.height,
91
- textAlign: props.textAlign,
92
- color: props.color,
93
- zIndex: props.zIndex,
94
- contain: props.contain,
95
- scrollable: props.scrollable,
96
- scrollY: props.scrollY,
97
- offsetY: props.offsetY,
98
- letterSpacing: props.letterSpacing,
99
- debug: props.debug,
100
- fontFamily: props.fontFamily,
101
- fontSize: props.fontSize,
102
- fontStretch: props.fontStretch,
103
- fontStyle: props.fontStyle,
104
- fontWeight: props.fontWeight,
105
- text: props.text,
106
- lineHeight: props.lineHeight,
107
- maxLines: props.maxLines,
108
- textBaseline: props.textBaseline,
109
- verticalAlign: props.verticalAlign,
110
- overflowSuffix: props.overflowSuffix,
111
- });
112
-
113
- this.trState = textRendererState;
114
- }
115
-
116
- private onTextLoaded: TrLoadedEventHandler = () => {
117
- const { contain } = this;
118
- const setWidth = this.trState.props.width;
119
- const setHeight = this.trState.props.height;
120
- const calcWidth = this.trState.textW || 0;
121
- const calcHeight = this.trState.textH || 0;
122
-
123
- if (contain === 'both') {
124
- this.props.width = setWidth;
125
- this.props.height = setHeight;
126
- } else if (contain === 'width') {
127
- this.props.width = setWidth;
128
- this.props.height = calcHeight;
129
- } else if (contain === 'none') {
130
- this.props.width = calcWidth;
131
- this.props.height = calcHeight;
132
- }
133
- this.updateLocalTransform();
134
-
135
- // Incase the RAF loop has been stopped already before text was loaded,
136
- // we request a render so it can be drawn.
137
- this.stage.requestRender();
138
- this.emit('loaded', {
139
- type: 'text',
140
- dimensions: {
141
- width: this.trState.textW || 0,
142
- height: this.trState.textH || 0,
143
- },
144
- } satisfies NodeTextLoadedPayload);
145
- };
146
-
147
- private onTextFailed: TrFailedEventHandler = (target, error) => {
148
- this.emit('failed', {
149
- type: 'text',
150
- error,
151
- } satisfies NodeTextFailedPayload);
152
- };
153
-
154
- override get width(): number {
155
- return this.props.width;
156
- }
157
-
158
- override set width(value: number) {
159
- this.props.width = value;
160
- this.textRenderer.set.width(this.trState, value);
161
-
162
- // If not containing, we must update the local transform to account for the
163
- // new width
164
- if (this.contain === 'none') {
165
- this.setUpdateType(UpdateType.Local);
166
- }
167
- }
168
-
169
- override get height(): number {
170
- return this.props.height;
171
- }
172
-
173
- override set height(value: number) {
174
- this.props.height = value;
175
- this.textRenderer.set.height(this.trState, value);
176
-
177
- // If not containing in the horizontal direction, we must update the local
178
- // transform to account for the new height
179
- if (this.contain !== 'both') {
180
- this.setUpdateType(UpdateType.Local);
181
- }
182
- }
183
-
184
- override get color(): number {
185
- return this.trState.props.color;
186
- }
187
-
188
- override set color(value: number) {
189
- this.textRenderer.set.color(this.trState, value);
190
- }
191
-
192
- get text(): string {
193
- return this.trState.props.text;
194
- }
195
-
196
- set text(value: string) {
197
- this.textRenderer.set.text(this.trState, value);
198
- }
199
-
200
- get textRendererOverride(): CoreTextNodeProps['textRendererOverride'] {
201
- return this._textRendererOverride;
202
- }
203
-
204
- set textRendererOverride(value: CoreTextNodeProps['textRendererOverride']) {
205
- this._textRendererOverride = value;
206
- this.textRenderer.destroyState(this.trState);
207
-
208
- const textRenderer = this.stage.resolveTextRenderer(
209
- this.trState.props,
210
- this._textRendererOverride,
211
- );
212
-
213
- if (!textRenderer) {
214
- console.warn(
215
- 'Text Renderer not found for font',
216
- this.trState.props.fontFamily,
217
- );
218
- return;
219
- }
220
-
221
- this.textRenderer = textRenderer;
222
- this.trState = this.createState(this.trState.props);
223
- }
224
-
225
- get fontSize(): CoreTextNodeProps['fontSize'] {
226
- return this.trState.props.fontSize;
227
- }
228
-
229
- set fontSize(value: CoreTextNodeProps['fontSize']) {
230
- this.textRenderer.set.fontSize(this.trState, value);
231
- }
232
-
233
- get fontFamily(): CoreTextNodeProps['fontFamily'] {
234
- return this.trState.props.fontFamily;
235
- }
236
-
237
- set fontFamily(value: CoreTextNodeProps['fontFamily']) {
238
- this.textRenderer.set.fontFamily(this.trState, value);
239
- }
240
-
241
- get fontStretch(): CoreTextNodeProps['fontStretch'] {
242
- return this.trState.props.fontStretch;
243
- }
244
-
245
- set fontStretch(value: CoreTextNodeProps['fontStretch']) {
246
- this.textRenderer.set.fontStretch(this.trState, value);
247
- }
248
-
249
- get fontStyle(): CoreTextNodeProps['fontStyle'] {
250
- return this.trState.props.fontStyle;
251
- }
252
-
253
- set fontStyle(value: CoreTextNodeProps['fontStyle']) {
254
- this.textRenderer.set.fontStyle(this.trState, value);
255
- }
256
-
257
- get fontWeight(): CoreTextNodeProps['fontWeight'] {
258
- return this.trState.props.fontWeight;
259
- }
260
-
261
- set fontWeight(value: CoreTextNodeProps['fontWeight']) {
262
- this.textRenderer.set.fontWeight(this.trState, value);
263
- }
264
-
265
- get textAlign(): CoreTextNodeProps['textAlign'] {
266
- return this.trState.props.textAlign;
267
- }
268
-
269
- set textAlign(value: CoreTextNodeProps['textAlign']) {
270
- this.textRenderer.set.textAlign(this.trState, value);
271
- }
272
-
273
- get contain(): CoreTextNodeProps['contain'] {
274
- return this.trState.props.contain;
275
- }
276
-
277
- set contain(value: CoreTextNodeProps['contain']) {
278
- this.textRenderer.set.contain(this.trState, value);
279
- }
280
-
281
- get scrollable(): CoreTextNodeProps['scrollable'] {
282
- return this.trState.props.scrollable;
283
- }
284
-
285
- set scrollable(value: CoreTextNodeProps['scrollable']) {
286
- this.textRenderer.set.scrollable(this.trState, value);
287
- }
288
-
289
- get scrollY(): CoreTextNodeProps['scrollY'] {
290
- return this.trState.props.scrollY;
291
- }
292
-
293
- set scrollY(value: CoreTextNodeProps['scrollY']) {
294
- this.textRenderer.set.scrollY(this.trState, value);
295
- }
296
-
297
- get offsetY(): CoreTextNodeProps['offsetY'] {
298
- return this.trState.props.offsetY;
299
- }
300
-
301
- set offsetY(value: CoreTextNodeProps['offsetY']) {
302
- this.textRenderer.set.offsetY(this.trState, value);
303
- }
304
-
305
- get letterSpacing(): CoreTextNodeProps['letterSpacing'] {
306
- return this.trState.props.letterSpacing;
307
- }
308
-
309
- set letterSpacing(value: CoreTextNodeProps['letterSpacing']) {
310
- this.textRenderer.set.letterSpacing(this.trState, value);
311
- }
312
-
313
- get lineHeight(): CoreTextNodeProps['lineHeight'] {
314
- return this.trState.props.lineHeight;
315
- }
316
-
317
- set lineHeight(value: CoreTextNodeProps['lineHeight']) {
318
- this.textRenderer.set.lineHeight(this.trState, value);
319
- }
320
-
321
- get maxLines(): CoreTextNodeProps['maxLines'] {
322
- return this.trState.props.maxLines;
323
- }
324
-
325
- set maxLines(value: CoreTextNodeProps['maxLines']) {
326
- this.textRenderer.set.maxLines(this.trState, value);
327
- }
328
-
329
- get textBaseline(): CoreTextNodeProps['textBaseline'] {
330
- return this.trState.props.textBaseline;
331
- }
332
-
333
- set textBaseline(value: CoreTextNodeProps['textBaseline']) {
334
- this.textRenderer.set.textBaseline(this.trState, value);
335
- }
336
-
337
- get verticalAlign(): CoreTextNodeProps['verticalAlign'] {
338
- return this.trState.props.verticalAlign;
339
- }
340
-
341
- set verticalAlign(value: CoreTextNodeProps['verticalAlign']) {
342
- this.textRenderer.set.verticalAlign(this.trState, value);
343
- }
344
-
345
- get overflowSuffix(): CoreTextNodeProps['overflowSuffix'] {
346
- return this.trState.props.overflowSuffix;
347
- }
348
-
349
- set overflowSuffix(value: CoreTextNodeProps['overflowSuffix']) {
350
- this.textRenderer.set.overflowSuffix(this.trState, value);
351
- }
352
-
353
- get debug(): CoreTextNodeProps['debug'] {
354
- return this.trState.props.debug;
355
- }
356
-
357
- set debug(value: CoreTextNodeProps['debug']) {
358
- this.textRenderer.set.debug(this.trState, value);
359
- }
360
-
361
- override update(delta: number, parentClippingRect: RectWithValid) {
362
- super.update(delta, parentClippingRect);
363
-
364
- assertTruthy(this.globalTransform);
365
-
366
- // globalTransform is updated in super.update(delta)
367
- this.textRenderer.set.x(this.trState, this.globalTransform.tx);
368
- this.textRenderer.set.y(this.trState, this.globalTransform.ty);
369
- }
370
-
371
- override checkBasicRenderability() {
372
- if (this.worldAlpha === 0 || this.isOutOfBounds() === true) {
373
- return false;
374
- }
375
-
376
- if (this.trState && this.trState.props.text !== '') {
377
- return true;
378
- }
379
-
380
- return false;
381
- }
382
-
383
- override setRenderable(isRenderable: boolean) {
384
- super.setRenderable(isRenderable);
385
- this.textRenderer.setIsRenderable(this.trState, isRenderable);
386
- }
387
-
388
- override renderQuads(renderer: CoreRenderer) {
389
- assertTruthy(this.globalTransform);
390
-
391
- // If the text renderer does not support rendering quads, fallback to the
392
- // default renderQuads method
393
- if (!this.textRenderer.renderQuads) {
394
- super.renderQuads(renderer);
395
- return;
396
- }
397
-
398
- // If the text renderer does support rendering quads, use it...
399
-
400
- // Prevent quad rendering if parent has a render texture
401
- // and this node is not the render texture
402
- if (this.parentHasRenderTexture) {
403
- if (!renderer.renderToTextureActive) {
404
- return;
405
- }
406
- // Prevent quad rendering if parent render texture is not the active render texture
407
- if (this.parentRenderTexture !== renderer.activeRttNode) {
408
- return;
409
- }
410
- }
411
-
412
- if (this.parentHasRenderTexture && this.props.parent?.rtt) {
413
- this.globalTransform = Matrix3d.identity();
414
- if (this.localTransform) {
415
- this.globalTransform.multiply(this.localTransform);
416
- }
417
- }
418
-
419
- assertTruthy(this.globalTransform);
420
-
421
- this.textRenderer.renderQuads(
422
- this.trState,
423
- this.globalTransform,
424
- this.clippingRect,
425
- this.worldAlpha,
426
- this.parentHasRenderTexture,
427
- this.framebufferDimensions,
428
- );
429
- }
430
-
431
- /**
432
- * Destroy the node and cleanup all resources
433
- */
434
- override destroy(): void {
435
- super.destroy();
436
-
437
- this.textRenderer.destroyState(this.trState);
438
- }
439
-
440
- /**
441
- * Resolve a text renderer and a new state based on the current text renderer props provided
442
- * @param props
443
- * @returns
444
- */
445
- private createState(props: TrProps) {
446
- const textRendererState = this.textRenderer.createState(props, this);
447
-
448
- textRendererState.emitter.on('loaded', this.onTextLoaded);
449
- textRendererState.emitter.on('failed', this.onTextFailed);
450
-
451
- this.textRenderer.scheduleUpdateState(textRendererState);
452
-
453
- return textRendererState;
454
- }
455
- }
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 {
21
+ TextRenderer,
22
+ TextRendererMap,
23
+ TrProps,
24
+ TextRendererState,
25
+ TrFailedEventHandler,
26
+ TrLoadedEventHandler,
27
+ } from './text-rendering/renderers/TextRenderer.js';
28
+ import { CoreNode, UpdateType, type CoreNodeProps } from './CoreNode.js';
29
+ import type { Stage } from './Stage.js';
30
+ import type { CoreRenderer } from './renderers/CoreRenderer.js';
31
+ import type {
32
+ NodeTextFailedPayload,
33
+ NodeTextLoadedPayload,
34
+ } from '../common/CommonTypes.js';
35
+ import type { RectWithValid } from './lib/utils.js';
36
+ import { assertTruthy } from '../utils.js';
37
+ import { Matrix3d } from './lib/Matrix3d.js';
38
+
39
+ export interface CoreTextNodeProps extends CoreNodeProps, TrProps {
40
+ /**
41
+ * Force Text Node to use a specific Text Renderer
42
+ *
43
+ * @remarks
44
+ * By default, Text Nodes resolve the Text Renderer to use based on the font
45
+ * that is matched using the font family and other font selection properties.
46
+ *
47
+ * If two fonts supported by two separate Text Renderers are matched setting
48
+ * this override forces the Text Node to resolve to the Text Renderer defined
49
+ * here.
50
+ *
51
+ * @default null
52
+ */
53
+ textRendererOverride: keyof TextRendererMap | null;
54
+ }
55
+
56
+ /**
57
+ * An CoreNode in the Renderer scene graph that renders text.
58
+ *
59
+ * @remarks
60
+ * A Text Node is the second graphical building block of the Renderer scene
61
+ * graph. It renders text using a specific text renderer that is automatically
62
+ * chosen based on the font requested and what type of fonts are installed
63
+ * into an app.
64
+ *
65
+ * The text renderer can be overridden by setting the `textRendererOverride`
66
+ *
67
+ * The `texture` and `shader` properties are managed by loaded text renderer and
68
+ * should not be set directly.
69
+ *
70
+ * For non-text rendering, see {@link CoreNode}.
71
+ */
72
+ export class CoreTextNode extends CoreNode implements CoreTextNodeProps {
73
+ textRenderer: TextRenderer;
74
+ trState: TextRendererState;
75
+ private _textRendererOverride: CoreTextNodeProps['textRendererOverride'] =
76
+ null;
77
+
78
+ constructor(
79
+ stage: Stage,
80
+ props: CoreTextNodeProps,
81
+ textRenderer: TextRenderer,
82
+ ) {
83
+ super(stage, props);
84
+ this._textRendererOverride = props.textRendererOverride;
85
+ this.textRenderer = textRenderer;
86
+ const textRendererState = this.createState({
87
+ x: this.absX,
88
+ y: this.absY,
89
+ width: props.width,
90
+ height: props.height,
91
+ textAlign: props.textAlign,
92
+ color: props.color,
93
+ zIndex: props.zIndex,
94
+ contain: props.contain,
95
+ scrollable: props.scrollable,
96
+ scrollY: props.scrollY,
97
+ offsetY: props.offsetY,
98
+ letterSpacing: props.letterSpacing,
99
+ debug: props.debug,
100
+ fontFamily: props.fontFamily,
101
+ fontSize: props.fontSize,
102
+ fontStretch: props.fontStretch,
103
+ fontStyle: props.fontStyle,
104
+ fontWeight: props.fontWeight,
105
+ text: props.text,
106
+ lineHeight: props.lineHeight,
107
+ maxLines: props.maxLines,
108
+ textBaseline: props.textBaseline,
109
+ verticalAlign: props.verticalAlign,
110
+ overflowSuffix: props.overflowSuffix,
111
+ });
112
+
113
+ this.trState = textRendererState;
114
+ }
115
+
116
+ private onTextLoaded: TrLoadedEventHandler = () => {
117
+ const { contain } = this;
118
+ const setWidth = this.trState.props.width;
119
+ const setHeight = this.trState.props.height;
120
+ const calcWidth = this.trState.textW || 0;
121
+ const calcHeight = this.trState.textH || 0;
122
+
123
+ if (contain === 'both') {
124
+ this.props.width = setWidth;
125
+ this.props.height = setHeight;
126
+ } else if (contain === 'width') {
127
+ this.props.width = setWidth;
128
+ this.props.height = calcHeight;
129
+ } else if (contain === 'none') {
130
+ this.props.width = calcWidth;
131
+ this.props.height = calcHeight;
132
+ }
133
+ this.updateLocalTransform();
134
+
135
+ // Incase the RAF loop has been stopped already before text was loaded,
136
+ // we request a render so it can be drawn.
137
+ this.stage.requestRender();
138
+ this.emit('loaded', {
139
+ type: 'text',
140
+ dimensions: {
141
+ width: this.trState.textW || 0,
142
+ height: this.trState.textH || 0,
143
+ },
144
+ } satisfies NodeTextLoadedPayload);
145
+ };
146
+
147
+ private onTextFailed: TrFailedEventHandler = (target, error) => {
148
+ this.emit('failed', {
149
+ type: 'text',
150
+ error,
151
+ } satisfies NodeTextFailedPayload);
152
+ };
153
+
154
+ override get width(): number {
155
+ return this.props.width;
156
+ }
157
+
158
+ override set width(value: number) {
159
+ this.props.width = value;
160
+ this.textRenderer.set.width(this.trState, value);
161
+
162
+ // If not containing, we must update the local transform to account for the
163
+ // new width
164
+ if (this.contain === 'none') {
165
+ this.setUpdateType(UpdateType.Local);
166
+ }
167
+ }
168
+
169
+ override get height(): number {
170
+ return this.props.height;
171
+ }
172
+
173
+ override set height(value: number) {
174
+ this.props.height = value;
175
+ this.textRenderer.set.height(this.trState, value);
176
+
177
+ // If not containing in the horizontal direction, we must update the local
178
+ // transform to account for the new height
179
+ if (this.contain !== 'both') {
180
+ this.setUpdateType(UpdateType.Local);
181
+ }
182
+ }
183
+
184
+ override get color(): number {
185
+ return this.trState.props.color;
186
+ }
187
+
188
+ override set color(value: number) {
189
+ this.textRenderer.set.color(this.trState, value);
190
+ }
191
+
192
+ get text(): string {
193
+ return this.trState.props.text;
194
+ }
195
+
196
+ set text(value: string) {
197
+ this.textRenderer.set.text(this.trState, value);
198
+ }
199
+
200
+ get textRendererOverride(): CoreTextNodeProps['textRendererOverride'] {
201
+ return this._textRendererOverride;
202
+ }
203
+
204
+ set textRendererOverride(value: CoreTextNodeProps['textRendererOverride']) {
205
+ this._textRendererOverride = value;
206
+ this.textRenderer.destroyState(this.trState);
207
+
208
+ const textRenderer = this.stage.resolveTextRenderer(
209
+ this.trState.props,
210
+ this._textRendererOverride,
211
+ );
212
+
213
+ if (!textRenderer) {
214
+ console.warn(
215
+ 'Text Renderer not found for font',
216
+ this.trState.props.fontFamily,
217
+ );
218
+ return;
219
+ }
220
+
221
+ this.textRenderer = textRenderer;
222
+ this.trState = this.createState(this.trState.props);
223
+ }
224
+
225
+ get fontSize(): CoreTextNodeProps['fontSize'] {
226
+ return this.trState.props.fontSize;
227
+ }
228
+
229
+ set fontSize(value: CoreTextNodeProps['fontSize']) {
230
+ this.textRenderer.set.fontSize(this.trState, value);
231
+ }
232
+
233
+ get fontFamily(): CoreTextNodeProps['fontFamily'] {
234
+ return this.trState.props.fontFamily;
235
+ }
236
+
237
+ set fontFamily(value: CoreTextNodeProps['fontFamily']) {
238
+ this.textRenderer.set.fontFamily(this.trState, value);
239
+ }
240
+
241
+ get fontStretch(): CoreTextNodeProps['fontStretch'] {
242
+ return this.trState.props.fontStretch;
243
+ }
244
+
245
+ set fontStretch(value: CoreTextNodeProps['fontStretch']) {
246
+ this.textRenderer.set.fontStretch(this.trState, value);
247
+ }
248
+
249
+ get fontStyle(): CoreTextNodeProps['fontStyle'] {
250
+ return this.trState.props.fontStyle;
251
+ }
252
+
253
+ set fontStyle(value: CoreTextNodeProps['fontStyle']) {
254
+ this.textRenderer.set.fontStyle(this.trState, value);
255
+ }
256
+
257
+ get fontWeight(): CoreTextNodeProps['fontWeight'] {
258
+ return this.trState.props.fontWeight;
259
+ }
260
+
261
+ set fontWeight(value: CoreTextNodeProps['fontWeight']) {
262
+ this.textRenderer.set.fontWeight(this.trState, value);
263
+ }
264
+
265
+ get textAlign(): CoreTextNodeProps['textAlign'] {
266
+ return this.trState.props.textAlign;
267
+ }
268
+
269
+ set textAlign(value: CoreTextNodeProps['textAlign']) {
270
+ this.textRenderer.set.textAlign(this.trState, value);
271
+ }
272
+
273
+ get contain(): CoreTextNodeProps['contain'] {
274
+ return this.trState.props.contain;
275
+ }
276
+
277
+ set contain(value: CoreTextNodeProps['contain']) {
278
+ this.textRenderer.set.contain(this.trState, value);
279
+ }
280
+
281
+ get scrollable(): CoreTextNodeProps['scrollable'] {
282
+ return this.trState.props.scrollable;
283
+ }
284
+
285
+ set scrollable(value: CoreTextNodeProps['scrollable']) {
286
+ this.textRenderer.set.scrollable(this.trState, value);
287
+ }
288
+
289
+ get scrollY(): CoreTextNodeProps['scrollY'] {
290
+ return this.trState.props.scrollY;
291
+ }
292
+
293
+ set scrollY(value: CoreTextNodeProps['scrollY']) {
294
+ this.textRenderer.set.scrollY(this.trState, value);
295
+ }
296
+
297
+ get offsetY(): CoreTextNodeProps['offsetY'] {
298
+ return this.trState.props.offsetY;
299
+ }
300
+
301
+ set offsetY(value: CoreTextNodeProps['offsetY']) {
302
+ this.textRenderer.set.offsetY(this.trState, value);
303
+ }
304
+
305
+ get letterSpacing(): CoreTextNodeProps['letterSpacing'] {
306
+ return this.trState.props.letterSpacing;
307
+ }
308
+
309
+ set letterSpacing(value: CoreTextNodeProps['letterSpacing']) {
310
+ this.textRenderer.set.letterSpacing(this.trState, value);
311
+ }
312
+
313
+ get lineHeight(): CoreTextNodeProps['lineHeight'] {
314
+ return this.trState.props.lineHeight;
315
+ }
316
+
317
+ set lineHeight(value: CoreTextNodeProps['lineHeight']) {
318
+ this.textRenderer.set.lineHeight(this.trState, value);
319
+ }
320
+
321
+ get maxLines(): CoreTextNodeProps['maxLines'] {
322
+ return this.trState.props.maxLines;
323
+ }
324
+
325
+ set maxLines(value: CoreTextNodeProps['maxLines']) {
326
+ this.textRenderer.set.maxLines(this.trState, value);
327
+ }
328
+
329
+ get textBaseline(): CoreTextNodeProps['textBaseline'] {
330
+ return this.trState.props.textBaseline;
331
+ }
332
+
333
+ set textBaseline(value: CoreTextNodeProps['textBaseline']) {
334
+ this.textRenderer.set.textBaseline(this.trState, value);
335
+ }
336
+
337
+ get verticalAlign(): CoreTextNodeProps['verticalAlign'] {
338
+ return this.trState.props.verticalAlign;
339
+ }
340
+
341
+ set verticalAlign(value: CoreTextNodeProps['verticalAlign']) {
342
+ this.textRenderer.set.verticalAlign(this.trState, value);
343
+ }
344
+
345
+ get overflowSuffix(): CoreTextNodeProps['overflowSuffix'] {
346
+ return this.trState.props.overflowSuffix;
347
+ }
348
+
349
+ set overflowSuffix(value: CoreTextNodeProps['overflowSuffix']) {
350
+ this.textRenderer.set.overflowSuffix(this.trState, value);
351
+ }
352
+
353
+ get debug(): CoreTextNodeProps['debug'] {
354
+ return this.trState.props.debug;
355
+ }
356
+
357
+ set debug(value: CoreTextNodeProps['debug']) {
358
+ this.textRenderer.set.debug(this.trState, value);
359
+ }
360
+
361
+ override update(delta: number, parentClippingRect: RectWithValid) {
362
+ super.update(delta, parentClippingRect);
363
+
364
+ assertTruthy(this.globalTransform);
365
+
366
+ // globalTransform is updated in super.update(delta)
367
+ this.textRenderer.set.x(this.trState, this.globalTransform.tx);
368
+ this.textRenderer.set.y(this.trState, this.globalTransform.ty);
369
+ }
370
+
371
+ override checkBasicRenderability() {
372
+ if (this.worldAlpha === 0 || this.isOutOfBounds() === true) {
373
+ return false;
374
+ }
375
+
376
+ if (this.trState && this.trState.props.text !== '') {
377
+ return true;
378
+ }
379
+
380
+ return false;
381
+ }
382
+
383
+ override setRenderable(isRenderable: boolean) {
384
+ super.setRenderable(isRenderable);
385
+ this.textRenderer.setIsRenderable(this.trState, isRenderable);
386
+ }
387
+
388
+ override renderQuads(renderer: CoreRenderer) {
389
+ assertTruthy(this.globalTransform);
390
+
391
+ // If the text renderer does not support rendering quads, fallback to the
392
+ // default renderQuads method
393
+ if (!this.textRenderer.renderQuads) {
394
+ super.renderQuads(renderer);
395
+ return;
396
+ }
397
+
398
+ // If the text renderer does support rendering quads, use it...
399
+
400
+ // Prevent quad rendering if parent has a render texture
401
+ // and this node is not the render texture
402
+ if (this.parentHasRenderTexture) {
403
+ if (!renderer.renderToTextureActive) {
404
+ return;
405
+ }
406
+ // Prevent quad rendering if parent render texture is not the active render texture
407
+ if (this.parentRenderTexture !== renderer.activeRttNode) {
408
+ return;
409
+ }
410
+ }
411
+
412
+ if (this.parentHasRenderTexture && this.props.parent?.rtt) {
413
+ this.globalTransform = Matrix3d.identity();
414
+ if (this.localTransform) {
415
+ this.globalTransform.multiply(this.localTransform);
416
+ }
417
+ }
418
+
419
+ assertTruthy(this.globalTransform);
420
+
421
+ this.textRenderer.renderQuads(
422
+ this.trState,
423
+ this.globalTransform,
424
+ this.clippingRect,
425
+ this.worldAlpha,
426
+ this.parentHasRenderTexture,
427
+ this.framebufferDimensions,
428
+ );
429
+ }
430
+
431
+ /**
432
+ * Destroy the node and cleanup all resources
433
+ */
434
+ override destroy(): void {
435
+ super.destroy();
436
+
437
+ this.textRenderer.destroyState(this.trState);
438
+ }
439
+
440
+ /**
441
+ * Resolve a text renderer and a new state based on the current text renderer props provided
442
+ * @param props
443
+ * @returns
444
+ */
445
+ private createState(props: TrProps) {
446
+ const textRendererState = this.textRenderer.createState(props, this);
447
+
448
+ textRendererState.emitter.on('loaded', this.onTextLoaded);
449
+ textRendererState.emitter.on('failed', this.onTextFailed);
450
+
451
+ this.textRenderer.scheduleUpdateState(textRendererState);
452
+
453
+ return textRendererState;
454
+ }
455
+ }