@lightningjs/renderer 3.0.0-beta10 → 3.0.0-beta12

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 (355) hide show
  1. package/LICENSE +202 -202
  2. package/NOTICE +3 -3
  3. package/README.md +133 -133
  4. package/dist/src/common/CommonTypes.d.ts +2 -2
  5. package/dist/src/core/CoreNode.d.ts +8 -7
  6. package/dist/src/core/CoreNode.js +57 -61
  7. package/dist/src/core/CoreNode.js.map +1 -1
  8. package/dist/src/core/CoreTextNode.d.ts +3 -0
  9. package/dist/src/core/CoreTextNode.js +54 -19
  10. package/dist/src/core/CoreTextNode.js.map +1 -1
  11. package/dist/src/core/Stage.js +4 -4
  12. package/dist/src/core/Stage.js.map +1 -1
  13. package/dist/src/core/lib/textureCompression.js +4 -4
  14. package/dist/src/core/lib/textureCompression.js.map +1 -1
  15. package/dist/src/core/platform.d.ts +10 -0
  16. package/dist/src/core/platform.js +81 -0
  17. package/dist/src/core/platform.js.map +1 -0
  18. package/dist/src/core/renderers/CoreShader.d.ts +9 -0
  19. package/dist/src/core/renderers/CoreShader.js +28 -0
  20. package/dist/src/core/renderers/CoreShader.js.map +1 -0
  21. package/dist/src/core/renderers/CoreShaderNode.js +2 -2
  22. package/dist/src/core/renderers/CoreShaderNode.js.map +1 -1
  23. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.d.ts +33 -0
  24. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js +250 -0
  25. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js.map +1 -0
  26. package/dist/src/core/renderers/canvas/CanvasCoreTexture.d.ts +16 -0
  27. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js +124 -0
  28. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js.map +1 -0
  29. package/dist/src/core/renderers/canvas/CanvasRenderer.js +1 -1
  30. package/dist/src/core/renderers/canvas/CanvasRenderer.js.map +1 -1
  31. package/dist/src/core/renderers/canvas/CanvasTexture.js +5 -5
  32. package/dist/src/core/renderers/canvas/CanvasTexture.js.map +1 -1
  33. package/dist/src/core/renderers/canvas/internal/C2DShaderUtils.d.ts +13 -0
  34. package/dist/src/core/renderers/canvas/internal/C2DShaderUtils.js +113 -192
  35. package/dist/src/core/renderers/canvas/internal/C2DShaderUtils.js.map +1 -1
  36. package/dist/src/core/renderers/canvas/internal/ColorUtils.d.ts +0 -2
  37. package/dist/src/core/renderers/canvas/internal/ColorUtils.js +0 -14
  38. package/dist/src/core/renderers/canvas/internal/ColorUtils.js.map +1 -1
  39. package/dist/src/core/renderers/canvas/shaders/UnsupportedShader.d.ts +10 -0
  40. package/dist/src/core/renderers/canvas/shaders/UnsupportedShader.js +43 -0
  41. package/dist/src/core/renderers/canvas/shaders/UnsupportedShader.js.map +1 -0
  42. package/dist/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.d.ts +12 -0
  43. package/dist/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.js +58 -0
  44. package/dist/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.js.map +1 -0
  45. package/dist/src/core/renderers/webgl/WebGlCoreCtxSubTexture.d.ts +9 -0
  46. package/dist/src/core/renderers/webgl/WebGlCoreCtxSubTexture.js +38 -0
  47. package/dist/src/core/renderers/webgl/WebGlCoreCtxSubTexture.js.map +1 -0
  48. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.d.ts +56 -0
  49. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js +239 -0
  50. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js.map +1 -0
  51. package/dist/src/core/renderers/webgl/WebGlCoreRenderOp.d.ts +34 -0
  52. package/dist/src/core/renderers/webgl/WebGlCoreRenderOp.js +114 -0
  53. package/dist/src/core/renderers/webgl/WebGlCoreRenderOp.js.map +1 -0
  54. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.d.ts +133 -0
  55. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.js +616 -0
  56. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.js.map +1 -0
  57. package/dist/src/core/renderers/webgl/WebGlCoreShader.d.ts +83 -0
  58. package/dist/src/core/renderers/webgl/WebGlCoreShader.js +233 -0
  59. package/dist/src/core/renderers/webgl/WebGlCoreShader.js.map +1 -0
  60. package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js +5 -6
  61. package/dist/src/core/renderers/webgl/WebGlCtxRenderTexture.js.map +1 -1
  62. package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.d.ts +13 -0
  63. package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js +34 -5
  64. package/dist/src/core/renderers/webgl/WebGlCtxSubTexture.js.map +1 -1
  65. package/dist/src/core/renderers/webgl/WebGlCtxTexture.js +21 -21
  66. package/dist/src/core/renderers/webgl/WebGlCtxTexture.js.map +1 -1
  67. package/dist/src/core/renderers/webgl/WebGlRenderOp.js +1 -1
  68. package/dist/src/core/renderers/webgl/WebGlRenderOp.js.map +1 -1
  69. package/dist/src/core/renderers/webgl/WebGlRenderer.js +12 -11
  70. package/dist/src/core/renderers/webgl/WebGlRenderer.js.map +1 -1
  71. package/dist/src/core/renderers/webgl/WebGlShaderProgram.js +2 -2
  72. package/dist/src/core/renderers/webgl/WebGlShaderProgram.js.map +1 -1
  73. package/dist/src/core/renderers/webgl/internal/ShaderUtils.js +35 -35
  74. package/dist/src/core/renderers/webgl/shaders/DefaultShader.d.ts +9 -0
  75. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +87 -0
  76. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js.map +1 -0
  77. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.d.ts +10 -0
  78. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +119 -0
  79. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js.map +1 -0
  80. package/dist/src/core/renderers/webgl/shaders/DynamicShader.d.ts +29 -0
  81. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +413 -0
  82. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js.map +1 -0
  83. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.d.ts +28 -0
  84. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +131 -0
  85. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js.map +1 -0
  86. package/dist/src/core/renderers/webgl/shaders/SdfShader.d.ts +47 -0
  87. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +160 -0
  88. package/dist/src/core/renderers/webgl/shaders/SdfShader.js.map +1 -0
  89. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.d.ts +31 -0
  90. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +71 -0
  91. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js.map +1 -0
  92. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.d.ts +30 -0
  93. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +58 -0
  94. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js.map +1 -0
  95. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.d.ts +31 -0
  96. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +71 -0
  97. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js.map +1 -0
  98. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.d.ts +31 -0
  99. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +71 -0
  100. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js.map +1 -0
  101. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.d.ts +31 -0
  102. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +71 -0
  103. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js.map +1 -0
  104. package/dist/src/core/renderers/webgl/shaders/effects/EffectUtils.d.ts +9 -0
  105. package/dist/src/core/renderers/webgl/shaders/effects/EffectUtils.js +136 -0
  106. package/dist/src/core/renderers/webgl/shaders/effects/EffectUtils.js.map +1 -0
  107. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.d.ts +36 -0
  108. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +85 -0
  109. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js.map +1 -0
  110. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.d.ts +45 -0
  111. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +104 -0
  112. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js.map +1 -0
  113. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.d.ts +22 -0
  114. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +45 -0
  115. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js.map +1 -0
  116. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.d.ts +58 -0
  117. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +80 -0
  118. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js.map +1 -0
  119. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.d.ts +35 -0
  120. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +129 -0
  121. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js.map +1 -0
  122. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.d.ts +39 -0
  123. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +116 -0
  124. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js.map +1 -0
  125. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.d.ts +61 -0
  126. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +127 -0
  127. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js.map +1 -0
  128. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.d.ts +40 -0
  129. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +71 -0
  130. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js.map +1 -0
  131. package/dist/src/core/renderers/webgl/shaders/effects/ShaderEffect.d.ts +115 -0
  132. package/dist/src/core/renderers/webgl/shaders/effects/ShaderEffect.js +61 -0
  133. package/dist/src/core/renderers/webgl/shaders/effects/ShaderEffect.js.map +1 -0
  134. package/dist/src/core/shaders/canvas/Border.js +4 -4
  135. package/dist/src/core/shaders/canvas/Border.js.map +1 -1
  136. package/dist/src/core/shaders/canvas/HolePunch.js +3 -3
  137. package/dist/src/core/shaders/canvas/HolePunch.js.map +1 -1
  138. package/dist/src/core/shaders/canvas/LinearGradient.js +2 -2
  139. package/dist/src/core/shaders/canvas/LinearGradient.js.map +1 -1
  140. package/dist/src/core/shaders/canvas/RadialGradient.js +4 -4
  141. package/dist/src/core/shaders/canvas/RadialGradient.js.map +1 -1
  142. package/dist/src/core/shaders/canvas/Rounded.js +1 -1
  143. package/dist/src/core/shaders/canvas/Rounded.js.map +1 -1
  144. package/dist/src/core/shaders/canvas/RoundedWithBorder.js +3 -3
  145. package/dist/src/core/shaders/canvas/RoundedWithBorder.js.map +1 -1
  146. package/dist/src/core/shaders/canvas/RoundedWithBorderAndShadow.js +3 -3
  147. package/dist/src/core/shaders/canvas/RoundedWithBorderAndShadow.js.map +1 -1
  148. package/dist/src/core/shaders/canvas/RoundedWithShadow.js +1 -1
  149. package/dist/src/core/shaders/canvas/RoundedWithShadow.js.map +1 -1
  150. package/dist/src/core/shaders/templates/BorderTemplate.d.ts +1 -1
  151. package/dist/src/core/shaders/templates/BorderTemplate.js +10 -10
  152. package/dist/src/core/shaders/templates/BorderTemplate.js.map +1 -1
  153. package/dist/src/core/shaders/templates/HolePunchTemplate.d.ts +2 -2
  154. package/dist/src/core/shaders/templates/HolePunchTemplate.js +2 -2
  155. package/dist/src/core/shaders/templates/HolePunchTemplate.js.map +1 -1
  156. package/dist/src/core/shaders/templates/RadialGradientTemplate.d.ts +2 -2
  157. package/dist/src/core/shaders/templates/RadialGradientTemplate.js +2 -2
  158. package/dist/src/core/shaders/templates/RadialGradientTemplate.js.map +1 -1
  159. package/dist/src/core/shaders/templates/shaderUtils.d.ts +5 -0
  160. package/dist/src/core/shaders/templates/shaderUtils.js +41 -0
  161. package/dist/src/core/shaders/templates/shaderUtils.js.map +1 -0
  162. package/dist/src/core/shaders/webgl/Border.js +83 -83
  163. package/dist/src/core/shaders/webgl/Border.js.map +1 -1
  164. package/dist/src/core/shaders/webgl/Default.js +47 -47
  165. package/dist/src/core/shaders/webgl/DefaultBatched.js +61 -61
  166. package/dist/src/core/shaders/webgl/HolePunch.js +34 -34
  167. package/dist/src/core/shaders/webgl/HolePunch.js.map +1 -1
  168. package/dist/src/core/shaders/webgl/LinearGradient.js +36 -36
  169. package/dist/src/core/shaders/webgl/RadialGradient.js +35 -35
  170. package/dist/src/core/shaders/webgl/RadialGradient.js.map +1 -1
  171. package/dist/src/core/shaders/webgl/Rounded.js +72 -72
  172. package/dist/src/core/shaders/webgl/Rounded.js.map +1 -1
  173. package/dist/src/core/shaders/webgl/RoundedWithBorder.js +113 -113
  174. package/dist/src/core/shaders/webgl/RoundedWithBorder.js.map +1 -1
  175. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js +132 -132
  176. package/dist/src/core/shaders/webgl/RoundedWithBorderAndShadow.js.map +1 -1
  177. package/dist/src/core/shaders/webgl/RoundedWithShadow.js +55 -55
  178. package/dist/src/core/shaders/webgl/RoundedWithShadow.js.map +1 -1
  179. package/dist/src/core/shaders/webgl/SdfShader.js +62 -62
  180. package/dist/src/core/shaders/webgl/Shadow.js +83 -83
  181. package/dist/src/core/shaders/webgl/Spinner.d.ts +1 -0
  182. package/dist/src/core/shaders/webgl/Spinner.js +2 -0
  183. package/dist/src/core/shaders/webgl/Spinner.js.map +1 -0
  184. package/dist/src/core/text-rendering/CanvasFontHandler.d.ts +16 -0
  185. package/dist/src/core/text-rendering/CanvasFontHandler.js +29 -0
  186. package/dist/src/core/text-rendering/CanvasFontHandler.js.map +1 -1
  187. package/dist/src/core/text-rendering/SdfFontHandler.d.ts +15 -0
  188. package/dist/src/core/text-rendering/SdfFontHandler.js +34 -2
  189. package/dist/src/core/text-rendering/SdfFontHandler.js.map +1 -1
  190. package/dist/src/core/text-rendering/TextRenderer.d.ts +2 -0
  191. package/dist/src/core/text-rendering/TextTextureRendererUtils.js.map +1 -1
  192. package/dist/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js +2 -2
  193. package/dist/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js.map +1 -1
  194. package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js +0 -5
  195. package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js.map +1 -1
  196. package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.d.ts +1 -7
  197. package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.js +2 -50
  198. package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.js.map +1 -1
  199. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.d.ts +3 -2
  200. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js +83 -42
  201. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.js.map +1 -1
  202. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.d.ts +1 -1
  203. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.js +8 -66
  204. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.js.map +1 -1
  205. package/dist/src/core/text-rendering/renderers/TextRenderer.d.ts +4 -14
  206. package/dist/src/core/text-rendering/renderers/TextRenderer.js +0 -3
  207. package/dist/src/core/text-rendering/renderers/TextRenderer.js.map +1 -1
  208. package/dist/src/core/text-rendering/sdf/PeekableGenerator.d.ts +12 -0
  209. package/dist/src/core/text-rendering/sdf/PeekableGenerator.js +61 -0
  210. package/dist/src/core/text-rendering/sdf/PeekableGenerator.js.map +1 -0
  211. package/dist/src/core/text-rendering/sdf/SimpleFontShaper.d.ts +45 -0
  212. package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js +69 -0
  213. package/dist/src/core/text-rendering/sdf/SimpleFontShaper.js.map +1 -0
  214. package/dist/src/core/textures/ColorTexture.js +1 -1
  215. package/dist/src/core/textures/ColorTexture.js.map +1 -1
  216. package/dist/src/core/textures/ImageTexture.d.ts +2 -2
  217. package/dist/src/core/textures/ImageTexture.js +11 -11
  218. package/dist/src/core/textures/ImageTexture.js.map +1 -1
  219. package/dist/src/core/textures/NoiseTexture.d.ts +2 -2
  220. package/dist/src/core/textures/NoiseTexture.js +6 -6
  221. package/dist/src/core/textures/NoiseTexture.js.map +1 -1
  222. package/dist/src/core/textures/RenderTexture.d.ts +6 -6
  223. package/dist/src/core/textures/RenderTexture.js +10 -10
  224. package/dist/src/core/textures/RenderTexture.js.map +1 -1
  225. package/dist/src/core/textures/SubTexture.d.ts +4 -4
  226. package/dist/src/core/textures/SubTexture.js +8 -8
  227. package/dist/src/core/textures/SubTexture.js.map +1 -1
  228. package/dist/src/core/textures/Texture.d.ts +3 -4
  229. package/dist/src/core/textures/Texture.js +4 -4
  230. package/dist/src/core/textures/Texture.js.map +1 -1
  231. package/dist/src/main-api/DynamicShaderController.d.ts +29 -0
  232. package/dist/src/main-api/DynamicShaderController.js +58 -0
  233. package/dist/src/main-api/DynamicShaderController.js.map +1 -0
  234. package/dist/src/main-api/Inspector.js +7 -7
  235. package/dist/src/main-api/Inspector.js.map +1 -1
  236. package/dist/src/main-api/Renderer.js +2 -2
  237. package/dist/src/main-api/Renderer.js.map +1 -1
  238. package/dist/src/main-api/ShaderController.d.ts +31 -0
  239. package/dist/src/main-api/ShaderController.js +37 -0
  240. package/dist/src/main-api/ShaderController.js.map +1 -0
  241. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  242. package/exports/canvas-shaders.ts +28 -28
  243. package/exports/canvas.ts +45 -45
  244. package/exports/index.ts +82 -82
  245. package/exports/inspector.ts +24 -24
  246. package/exports/utils.ts +50 -50
  247. package/exports/webgl-shaders.ts +28 -28
  248. package/exports/webgl.ts +52 -52
  249. package/package.json +2 -1
  250. package/src/common/CommonTypes.ts +146 -146
  251. package/src/common/EventEmitter.ts +77 -77
  252. package/src/common/IAnimationController.ts +92 -92
  253. package/src/common/IEventEmitter.ts +28 -28
  254. package/src/core/CoreNode.test.ts +202 -202
  255. package/src/core/CoreNode.ts +2481 -2491
  256. package/src/core/CoreShaderManager.ts +188 -188
  257. package/src/core/CoreTextNode.ts +483 -443
  258. package/src/core/CoreTextureManager.ts +565 -565
  259. package/src/core/Stage.ts +906 -906
  260. package/src/core/TextureMemoryManager.ts +445 -445
  261. package/src/core/animations/AnimationManager.ts +38 -38
  262. package/src/core/animations/CoreAnimation.ts +291 -291
  263. package/src/core/animations/CoreAnimationController.ts +166 -166
  264. package/src/core/lib/ContextSpy.ts +41 -41
  265. package/src/core/lib/ImageWorker.ts +286 -286
  266. package/src/core/lib/Matrix3d.ts +244 -244
  267. package/src/core/lib/RenderCoords.ts +71 -71
  268. package/src/core/lib/WebGlContextWrapper.ts +1381 -1381
  269. package/src/core/lib/colorCache.ts +20 -20
  270. package/src/core/lib/colorParser.ts +85 -85
  271. package/src/core/lib/textureCompression.ts +152 -152
  272. package/src/core/lib/textureSvg.ts +78 -78
  273. package/src/core/lib/utils.ts +412 -412
  274. package/src/core/lib/validateImageBitmap.ts +87 -87
  275. package/src/core/platforms/Platform.ts +77 -77
  276. package/src/core/platforms/web/WebPlatform.ts +121 -121
  277. package/src/core/renderers/CoreContextTexture.ts +43 -43
  278. package/src/core/renderers/CoreRenderOp.ts +22 -22
  279. package/src/core/renderers/CoreRenderer.ts +110 -110
  280. package/src/core/renderers/CoreShaderNode.ts +175 -175
  281. package/src/core/renderers/CoreShaderProgram.ts +23 -23
  282. package/src/core/renderers/canvas/CanvasRenderer.ts +283 -283
  283. package/src/core/renderers/canvas/CanvasShaderNode.ts +96 -96
  284. package/src/core/renderers/canvas/CanvasTexture.ts +156 -156
  285. package/src/core/renderers/webgl/WebGlCtxRenderTexture.ts +81 -91
  286. package/src/core/renderers/webgl/WebGlCtxSubTexture.ts +95 -50
  287. package/src/core/renderers/webgl/WebGlCtxTexture.ts +301 -310
  288. package/src/core/renderers/webgl/WebGlRenderOp.ts +167 -167
  289. package/src/core/renderers/webgl/WebGlRenderer.ts +746 -747
  290. package/src/core/renderers/webgl/WebGlShaderNode.ts +435 -435
  291. package/src/core/renderers/webgl/WebGlShaderProgram.ts +341 -341
  292. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  293. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  294. package/src/core/renderers/webgl/internal/ShaderUtils.ts +281 -281
  295. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  296. package/src/core/shaders/canvas/Border.ts +75 -75
  297. package/src/core/shaders/canvas/HolePunch.ts +55 -62
  298. package/src/core/shaders/canvas/LinearGradient.ts +71 -71
  299. package/src/core/shaders/canvas/RadialGradient.ts +99 -99
  300. package/src/core/shaders/canvas/Rounded.ts +55 -55
  301. package/src/core/shaders/canvas/RoundedWithBorder.ts +72 -74
  302. package/src/core/shaders/canvas/RoundedWithBorderAndShadow.ts +88 -90
  303. package/src/core/shaders/canvas/RoundedWithShadow.ts +70 -70
  304. package/src/core/shaders/canvas/Shadow.ts +52 -52
  305. package/src/core/shaders/canvas/utils/render.ts +151 -151
  306. package/src/core/shaders/templates/BorderTemplate.ts +115 -115
  307. package/src/core/shaders/templates/HolePunchTemplate.ts +82 -82
  308. package/src/core/shaders/templates/LinearGradientTemplate.ts +71 -71
  309. package/src/core/shaders/templates/RadialGradientTemplate.ts +81 -81
  310. package/src/core/shaders/templates/RoundedTemplate.ts +98 -98
  311. package/src/core/shaders/templates/RoundedWithBorderAndShadowTemplate.ts +38 -38
  312. package/src/core/shaders/templates/RoundedWithBorderTemplate.ts +35 -35
  313. package/src/core/shaders/templates/RoundedWithShadowTemplate.ts +35 -35
  314. package/src/core/shaders/templates/ShadowTemplate.ts +106 -106
  315. package/src/core/shaders/utils.ts +46 -46
  316. package/src/core/shaders/webgl/Border.ts +116 -116
  317. package/src/core/shaders/webgl/Default.ts +89 -89
  318. package/src/core/shaders/webgl/DefaultBatched.ts +129 -129
  319. package/src/core/shaders/webgl/HolePunch.ts +75 -75
  320. package/src/core/shaders/webgl/LinearGradient.ts +82 -82
  321. package/src/core/shaders/webgl/RadialGradient.ts +85 -85
  322. package/src/core/shaders/webgl/Rounded.ts +113 -117
  323. package/src/core/shaders/webgl/RoundedWithBorder.ts +151 -155
  324. package/src/core/shaders/webgl/RoundedWithBorderAndShadow.ts +175 -175
  325. package/src/core/shaders/webgl/RoundedWithShadow.ts +94 -98
  326. package/src/core/shaders/webgl/SdfShader.ts +134 -134
  327. package/src/core/shaders/webgl/Shadow.ts +115 -115
  328. package/src/core/text-rendering/CanvasFontHandler.ts +210 -176
  329. package/src/core/text-rendering/CanvasTextRenderer.ts +622 -622
  330. package/src/core/text-rendering/SdfFontHandler.ts +554 -517
  331. package/src/core/text-rendering/SdfTextRenderer.ts +466 -466
  332. package/src/core/text-rendering/TextRenderer.ts +406 -404
  333. package/src/core/text-rendering/Utils.ts +257 -257
  334. package/src/core/text-rendering/canvas/Settings.ts +99 -99
  335. package/src/core/text-rendering/canvas/Utils.test.ts +206 -206
  336. package/src/core/text-rendering/canvas/Utils.ts +178 -178
  337. package/src/core/text-rendering/canvas/calculateRenderInfo.ts +299 -299
  338. package/src/core/text-rendering/canvas/draw.ts +165 -165
  339. package/src/core/text-rendering/sdf/Utils.test.ts +402 -402
  340. package/src/core/text-rendering/sdf/Utils.ts +436 -436
  341. package/src/core/text-rendering/sdf/index.ts +20 -20
  342. package/src/core/textures/ColorTexture.ts +102 -102
  343. package/src/core/textures/ImageTexture.ts +418 -418
  344. package/src/core/textures/NoiseTexture.ts +104 -104
  345. package/src/core/textures/RenderTexture.ts +85 -85
  346. package/src/core/textures/SubTexture.ts +205 -205
  347. package/src/core/textures/Texture.ts +381 -381
  348. package/src/core/utils.ts +227 -227
  349. package/src/env.d.ts +7 -7
  350. package/src/main-api/INode.ts +100 -100
  351. package/src/main-api/Inspector.ts +567 -567
  352. package/src/main-api/Renderer.ts +873 -873
  353. package/src/main-api/utils.ts +45 -45
  354. package/src/utils.ts +267 -267
  355. package/COPYING +0 -1
@@ -1,443 +1,483 @@
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
- FontHandler,
22
- TextRenderer,
23
- TrProps,
24
- TextLayout,
25
- TextRenderInfo,
26
- } from './text-rendering/TextRenderer.js';
27
- import {
28
- CoreNode,
29
- CoreNodeRenderState,
30
- UpdateType,
31
- type CoreNodeProps,
32
- } from './CoreNode.js';
33
- import type { Stage } from './Stage.js';
34
- import type {
35
- NodeTextFailedPayload,
36
- NodeTextLoadedPayload,
37
- NodeTextureLoadedPayload,
38
- } from '../common/CommonTypes.js';
39
- import type { RectWithValid } from './lib/utils.js';
40
- import type { CoreRenderer } from './renderers/CoreRenderer.js';
41
- import type { TextureLoadedEventHandler } from './textures/Texture.js';
42
- export interface CoreTextNodeProps extends CoreNodeProps, TrProps {
43
- /**
44
- * Force Text Node to use a specific Text Renderer
45
- */
46
- textRendererOverride?: string | null;
47
- forceLoad: boolean;
48
- }
49
-
50
- export class CoreTextNode extends CoreNode implements CoreTextNodeProps {
51
- private textRenderer: TextRenderer;
52
- private fontHandler: FontHandler;
53
-
54
- private _layoutGenerated = false;
55
-
56
- // SDF layout caching for performance
57
- private _cachedLayout: TextLayout | null = null;
58
- private _lastVertexBuffer: Float32Array | null = null;
59
-
60
- // Text renderer properties - stored directly on the node
61
- private textProps: CoreTextNodeProps;
62
-
63
- private _renderInfo: TextRenderInfo = {
64
- width: 0,
65
- height: 0,
66
- };
67
-
68
- private _type: 'sdf' | 'canvas' = 'sdf'; // Default to SDF renderer
69
-
70
- constructor(
71
- stage: Stage,
72
- props: CoreTextNodeProps,
73
- textRenderer: TextRenderer,
74
- ) {
75
- super(stage, props);
76
- this.textRenderer = textRenderer;
77
- this.fontHandler = textRenderer.font;
78
- this._type = textRenderer.type;
79
-
80
- // Initialize text properties from props
81
- // Props are guaranteed to have all defaults resolved by Stage.createTextNode
82
- this.textProps = props;
83
-
84
- this.setUpdateType(UpdateType.All);
85
- }
86
-
87
- protected override onTextureLoaded: TextureLoadedEventHandler = (
88
- _,
89
- dimensions,
90
- ) => {
91
- // If parent has a render texture, flag that we need to update
92
- if (this.parentHasRenderTexture) {
93
- this.notifyParentRTTOfUpdate();
94
- }
95
-
96
- // ignore 1x1 pixel textures
97
- if (dimensions.width > 1 && dimensions.height > 1) {
98
- this.emit('loaded', {
99
- type: 'texture',
100
- dimensions,
101
- } satisfies NodeTextureLoadedPayload);
102
- }
103
-
104
- this.width = this._renderInfo.width;
105
- this.height = this._renderInfo.height;
106
-
107
- // Texture was loaded. In case the RAF loop has already stopped, we request
108
- // a render to ensure the texture is rendered.
109
- this.stage.requestRender();
110
- };
111
-
112
- /**
113
- * Override CoreNode's update method to handle text-specific updates
114
- */
115
- override update(delta: number, parentClippingRect: RectWithValid): void {
116
- if (
117
- (this.props.parent?.isRenderable === true &&
118
- this._layoutGenerated === false) ||
119
- (this.textProps.forceLoad === true &&
120
- this._layoutGenerated === false &&
121
- this.fontHandler.isFontLoaded(this.textProps.fontFamily) === true)
122
- ) {
123
- this._cachedLayout = null; // Invalidate cached layout
124
- this._lastVertexBuffer = null; // Invalidate last vertex buffer
125
- const resp = this.textRenderer.renderText(this.stage, this.textProps);
126
- this.handleRenderResult(resp);
127
- this._layoutGenerated = true;
128
- }
129
-
130
- // First run the standard CoreNode update
131
- super.update(delta, parentClippingRect);
132
- }
133
-
134
- /**
135
- * Override is renderable check for SDF text nodes
136
- */
137
- override updateIsRenderable(): void {
138
- // SDF text nodes are always renderable if they have a valid layout
139
- if (this._type === 'canvas') {
140
- super.updateIsRenderable();
141
- return;
142
- }
143
-
144
- // For SDF, check if we have a cached layout
145
- this.setRenderable(this._cachedLayout !== null);
146
- }
147
-
148
- /**
149
- * Handle the result of text rendering for both Canvas and SDF renderers
150
- */
151
- private handleRenderResult(result: TextRenderInfo): void {
152
- // Host paths on top
153
- const textRendererType = this._type;
154
- let width = result.width;
155
- let height = result.height;
156
-
157
- // Handle Canvas renderer (uses ImageData)
158
- if (textRendererType === 'canvas') {
159
- if (result.imageData === undefined) {
160
- this.emit('failed', {
161
- type: 'text',
162
- error: new Error(
163
- 'Canvas text rendering failed, no image data returned',
164
- ),
165
- } satisfies NodeTextFailedPayload);
166
- return;
167
- }
168
-
169
- this.texture = this.stage.txManager.createTexture('ImageTexture', {
170
- premultiplyAlpha: true,
171
- src: result.imageData as ImageData,
172
- });
173
-
174
- // It isn't renderable until the texture is loaded we have to set it to false here to avoid it
175
- // being detected as a renderable default color node in the next frame
176
- // it will be corrected once the texture is loaded
177
- this.setRenderable(false);
178
-
179
- if (this.renderState > CoreNodeRenderState.OutOfBounds) {
180
- // We do want the texture to load immediately
181
- this.texture.setRenderableOwner(this, true);
182
- }
183
- }
184
-
185
- // Handle SDF renderer (uses layout caching)
186
- if (textRendererType === 'sdf') {
187
- this._cachedLayout = result.layout || null;
188
- this.setRenderable(true);
189
- this.props.width = width;
190
- this.props.height = height;
191
- this.setUpdateType(UpdateType.Local);
192
- }
193
-
194
- this._renderInfo = result;
195
- this.emit('loaded', {
196
- type: 'text',
197
- dimensions: {
198
- width: width,
199
- height: height,
200
- },
201
- } satisfies NodeTextLoadedPayload);
202
- }
203
-
204
- /**
205
- * Override renderQuads to handle SDF vs Canvas rendering
206
- */
207
- override renderQuads(renderer: CoreRenderer): void {
208
- // Canvas renderer: use standard texture rendering via CoreNode
209
- if (this._type === 'canvas') {
210
- super.renderQuads(renderer);
211
- return;
212
- }
213
-
214
- // Early return if no cached data
215
- if (!this._cachedLayout) {
216
- return;
217
- }
218
-
219
- if (this._lastVertexBuffer === null) {
220
- this._lastVertexBuffer = this.textRenderer.addQuads(this._cachedLayout);
221
- }
222
-
223
- const props = this.textProps;
224
- this.textRenderer.renderQuads(
225
- renderer,
226
- this._cachedLayout as TextLayout,
227
- this._lastVertexBuffer!,
228
- {
229
- fontFamily: this.textProps.fontFamily,
230
- fontSize: props.fontSize,
231
- color: this.props.color || 0xffffffff,
232
- offsetY: props.offsetY,
233
- worldAlpha: this.worldAlpha,
234
- globalTransform: this.globalTransform!.getFloatArr(),
235
- clippingRect: this.clippingRect,
236
- width: this.props.width,
237
- height: this.props.height,
238
- parentHasRenderTexture: this.parentHasRenderTexture,
239
- framebufferDimensions:
240
- this.parentHasRenderTexture === true
241
- ? this.parentFramebufferDimensions
242
- : null,
243
- stage: this.stage,
244
- },
245
- );
246
- }
247
-
248
- get maxWidth() {
249
- return this.textProps.maxWidth;
250
- }
251
-
252
- set maxWidth(value: number) {
253
- if (this.textProps.maxWidth !== value) {
254
- this.textProps.maxWidth = value;
255
- this._layoutGenerated = false;
256
- this.setUpdateType(UpdateType.Local);
257
- }
258
- }
259
-
260
- // Property getters and setters
261
- get maxHeight() {
262
- return this.textProps.maxHeight;
263
- }
264
-
265
- set maxHeight(value: number) {
266
- if (this.textProps.maxHeight !== value) {
267
- this.textProps.maxHeight = value;
268
- this._layoutGenerated = false;
269
- this.setUpdateType(UpdateType.Local);
270
- }
271
- }
272
-
273
- get text(): string {
274
- return this.textProps.text;
275
- }
276
-
277
- set text(value: string) {
278
- if (this.textProps.text !== value) {
279
- this.textProps.text = value;
280
- this._layoutGenerated = false;
281
- this.setUpdateType(UpdateType.Local);
282
- }
283
- }
284
-
285
- get fontSize(): number {
286
- return this.textProps.fontSize;
287
- }
288
-
289
- set fontSize(value: number) {
290
- if (this.textProps.fontSize !== value) {
291
- this.textProps.fontSize = value;
292
- this._layoutGenerated = false;
293
- this.setUpdateType(UpdateType.Local);
294
- }
295
- }
296
-
297
- get fontFamily(): string {
298
- return this.textProps.fontFamily;
299
- }
300
-
301
- set fontFamily(value: string) {
302
- if (this.textProps.fontFamily !== value) {
303
- this.textProps.fontFamily = value;
304
- this._layoutGenerated = true;
305
- this.setUpdateType(UpdateType.Local);
306
- }
307
- }
308
-
309
- get fontStyle(): TrProps['fontStyle'] {
310
- return this.textProps.fontStyle;
311
- }
312
-
313
- set fontStyle(value: TrProps['fontStyle']) {
314
- if (this.textProps.fontStyle !== value) {
315
- this.textProps.fontStyle = value;
316
- this._layoutGenerated = true;
317
- this.setUpdateType(UpdateType.Local);
318
- }
319
- }
320
-
321
- get textAlign(): TrProps['textAlign'] {
322
- return this.textProps.textAlign;
323
- }
324
-
325
- set textAlign(value: TrProps['textAlign']) {
326
- if (this.textProps.textAlign !== value) {
327
- this.textProps.textAlign = value;
328
- this._layoutGenerated = false;
329
- this.setUpdateType(UpdateType.Local);
330
- }
331
- }
332
-
333
- get letterSpacing(): number {
334
- return this.textProps.letterSpacing;
335
- }
336
-
337
- set letterSpacing(value: number) {
338
- if (this.textProps.letterSpacing !== value) {
339
- this.textProps.letterSpacing = value;
340
- this._layoutGenerated = false;
341
- this.setUpdateType(UpdateType.Local);
342
- }
343
- }
344
-
345
- get lineHeight(): number {
346
- return this.textProps.lineHeight;
347
- }
348
-
349
- set lineHeight(value: number) {
350
- if (this.textProps.lineHeight !== value) {
351
- this.textProps.lineHeight = value;
352
- this._layoutGenerated = false;
353
- this.setUpdateType(UpdateType.Local);
354
- }
355
- }
356
-
357
- get maxLines(): number {
358
- return this.textProps.maxLines;
359
- }
360
-
361
- set maxLines(value: number) {
362
- if (this.textProps.maxLines !== value) {
363
- this.textProps.maxLines = value;
364
- this._layoutGenerated = false;
365
- this.setUpdateType(UpdateType.Local);
366
- }
367
- }
368
-
369
- get textBaseline(): TrProps['textBaseline'] {
370
- return this.textProps.textBaseline;
371
- }
372
-
373
- set textBaseline(value: TrProps['textBaseline']) {
374
- if (this.textProps.textBaseline !== value) {
375
- this.textProps.textBaseline = value;
376
- this._layoutGenerated = false;
377
- this.setUpdateType(UpdateType.Local);
378
- }
379
- }
380
-
381
- get verticalAlign(): TrProps['verticalAlign'] {
382
- return this.textProps.verticalAlign;
383
- }
384
-
385
- set verticalAlign(value: TrProps['verticalAlign']) {
386
- if (this.textProps.verticalAlign !== value) {
387
- this.textProps.verticalAlign = value;
388
- this._layoutGenerated = false;
389
- this.setUpdateType(UpdateType.Local);
390
- }
391
- }
392
-
393
- get overflowSuffix(): string {
394
- return this.textProps.overflowSuffix;
395
- }
396
-
397
- set overflowSuffix(value: string) {
398
- if (this.textProps.overflowSuffix !== value) {
399
- this.textProps.overflowSuffix = value;
400
- this._layoutGenerated = false;
401
- this.setUpdateType(UpdateType.Local);
402
- }
403
- }
404
-
405
- get wordBreak(): TrProps['wordBreak'] {
406
- return this.textProps.wordBreak;
407
- }
408
-
409
- set wordBreak(value: TrProps['wordBreak']) {
410
- if (this.textProps.wordBreak !== value) {
411
- this.textProps.wordBreak = value;
412
- this._layoutGenerated = false;
413
- this.setUpdateType(UpdateType.Local);
414
- }
415
- }
416
-
417
- get offsetY(): number {
418
- return this.textProps.offsetY;
419
- }
420
-
421
- set offsetY(value: number) {
422
- if (this.textProps.offsetY !== value) {
423
- this.textProps.offsetY = value;
424
- this._layoutGenerated = false;
425
- this.setUpdateType(UpdateType.Local);
426
- }
427
- }
428
-
429
- get forceLoad() {
430
- return this.textProps.forceLoad;
431
- }
432
-
433
- set forceLoad(value: boolean) {
434
- if (this.textProps.forceLoad !== value) {
435
- this.textProps.forceLoad = value;
436
- this.setUpdateType(UpdateType.Local);
437
- }
438
- }
439
-
440
- get renderInfo(): TextRenderInfo {
441
- return this._renderInfo;
442
- }
443
- }
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
+ FontHandler,
22
+ TextRenderer,
23
+ TrProps,
24
+ TextLayout,
25
+ TextRenderInfo,
26
+ } from './text-rendering/TextRenderer.js';
27
+ import {
28
+ CoreNode,
29
+ CoreNodeRenderState,
30
+ UpdateType,
31
+ type CoreNodeProps,
32
+ } from './CoreNode.js';
33
+ import type { Stage } from './Stage.js';
34
+ import type {
35
+ NodeTextFailedPayload,
36
+ NodeTextLoadedPayload,
37
+ NodeTextureLoadedPayload,
38
+ } from '../common/CommonTypes.js';
39
+ import type { RectWithValid } from './lib/utils.js';
40
+ import type { CoreRenderer } from './renderers/CoreRenderer.js';
41
+ import type { TextureLoadedEventHandler } from './textures/Texture.js';
42
+ export interface CoreTextNodeProps extends CoreNodeProps, TrProps {
43
+ /**
44
+ * Force Text Node to use a specific Text Renderer
45
+ */
46
+ textRendererOverride?: string | null;
47
+ forceLoad: boolean;
48
+ }
49
+
50
+ export class CoreTextNode extends CoreNode implements CoreTextNodeProps {
51
+ private textRenderer: TextRenderer;
52
+ private fontHandler: FontHandler;
53
+
54
+ private _layoutGenerated = false;
55
+ private _waitingForFont = false;
56
+
57
+ // SDF layout caching for performance
58
+ private _cachedLayout: TextLayout | null = null;
59
+ private _lastVertexBuffer: Float32Array | null = null;
60
+
61
+ // Text renderer properties - stored directly on the node
62
+ private textProps: CoreTextNodeProps;
63
+
64
+ private _renderInfo: TextRenderInfo = {
65
+ width: 0,
66
+ height: 0,
67
+ };
68
+
69
+ private _type: 'sdf' | 'canvas' = 'sdf'; // Default to SDF renderer
70
+
71
+ constructor(
72
+ stage: Stage,
73
+ props: CoreTextNodeProps,
74
+ textRenderer: TextRenderer,
75
+ ) {
76
+ super(stage, props);
77
+ this.textRenderer = textRenderer;
78
+ this.fontHandler = textRenderer.font;
79
+ this._type = textRenderer.type;
80
+
81
+ // Initialize text properties from props
82
+ // Props are guaranteed to have all defaults resolved by Stage.createTextNode
83
+ this.textProps = props;
84
+
85
+ this.setUpdateType(UpdateType.All);
86
+ }
87
+
88
+ protected override onTextureLoaded: TextureLoadedEventHandler = (
89
+ _,
90
+ dimensions,
91
+ ) => {
92
+ // If parent has a render texture, flag that we need to update
93
+ if (this.parentHasRenderTexture) {
94
+ this.notifyParentRTTOfUpdate();
95
+ }
96
+
97
+ // ignore 1x1 pixel textures
98
+ if (dimensions.w > 1 && dimensions.h > 1) {
99
+ this.emit('loaded', {
100
+ type: 'texture',
101
+ dimensions,
102
+ } satisfies NodeTextureLoadedPayload);
103
+ }
104
+
105
+ this.w = this._renderInfo.width;
106
+ this.h = this._renderInfo.height;
107
+
108
+ // Texture was loaded. In case the RAF loop has already stopped, we request
109
+ // a render to ensure the texture is rendered.
110
+ this.stage.requestRender();
111
+ };
112
+
113
+ allowTextGeneration() {
114
+ const p = this.props.parent;
115
+ if (p === null) {
116
+ return false;
117
+ }
118
+ if (p.worldAlpha > 0 && p.renderState > CoreNodeRenderState.OutOfBounds) {
119
+ return true;
120
+ }
121
+ return false;
122
+ }
123
+
124
+ /**
125
+ * Override CoreNode's update method to handle text-specific updates
126
+ */
127
+ override update(delta: number, parentClippingRect: RectWithValid): void {
128
+ if (
129
+ (this.textProps.forceLoad === true ||
130
+ this.allowTextGeneration() === true) &&
131
+ this._layoutGenerated === false
132
+ ) {
133
+ if (this.fontHandler.isFontLoaded(this.textProps.fontFamily) === true) {
134
+ this._waitingForFont = false;
135
+ this._cachedLayout = null; // Invalidate cached layout
136
+ this._lastVertexBuffer = null; // Invalidate last vertex buffer
137
+ const resp = this.textRenderer.renderText(this.stage, this.textProps);
138
+ this.handleRenderResult(resp);
139
+ this._layoutGenerated = true;
140
+ } else if (this._waitingForFont === false) {
141
+ this.fontHandler.waitingForFont(this.textProps.fontFamily, this);
142
+ this._waitingForFont = true;
143
+ }
144
+ }
145
+
146
+ // First run the standard CoreNode update
147
+ super.update(delta, parentClippingRect);
148
+ }
149
+
150
+ /**
151
+ * Override is renderable check for SDF text nodes
152
+ */
153
+ override updateIsRenderable(): void {
154
+ // SDF text nodes are always renderable if they have a valid layout
155
+ if (this._type === 'canvas') {
156
+ super.updateIsRenderable();
157
+ return;
158
+ }
159
+
160
+ // For SDF, check if we have a cached layout
161
+ this.setRenderable(this._cachedLayout !== null);
162
+ }
163
+
164
+ /**
165
+ * Handle the result of text rendering for both Canvas and SDF renderers
166
+ */
167
+ private handleRenderResult(result: TextRenderInfo): void {
168
+ // Host paths on top
169
+ const textRendererType = this._type;
170
+ let width = result.width;
171
+ let height = result.height;
172
+
173
+ // Handle Canvas renderer (uses ImageData)
174
+ if (textRendererType === 'canvas') {
175
+ if (result.imageData === undefined) {
176
+ this.emit('failed', {
177
+ type: 'text',
178
+ error: new Error(
179
+ 'Canvas text rendering failed, no image data returned',
180
+ ),
181
+ } satisfies NodeTextFailedPayload);
182
+ return;
183
+ }
184
+
185
+ this.texture = this.stage.txManager.createTexture('ImageTexture', {
186
+ premultiplyAlpha: true,
187
+ src: result.imageData as ImageData,
188
+ });
189
+
190
+ // It isn't renderable until the texture is loaded we have to set it to false here to avoid it
191
+ // being detected as a renderable default color node in the next frame
192
+ // it will be corrected once the texture is loaded
193
+ this.setRenderable(false);
194
+
195
+ if (this.renderState > CoreNodeRenderState.OutOfBounds) {
196
+ // We do want the texture to load immediately
197
+ this.texture.setRenderableOwner(this, true);
198
+ }
199
+ }
200
+
201
+ // Handle SDF renderer (uses layout caching)
202
+ if (textRendererType === 'sdf') {
203
+ this._cachedLayout = result.layout || null;
204
+ this.setRenderable(true);
205
+ this.props.w = width;
206
+ this.props.h = height;
207
+ this.setUpdateType(UpdateType.Local);
208
+ }
209
+
210
+ this._renderInfo = result;
211
+ this.emit('loaded', {
212
+ type: 'text',
213
+ dimensions: {
214
+ w: width,
215
+ h: height,
216
+ },
217
+ } satisfies NodeTextLoadedPayload);
218
+ }
219
+
220
+ /**
221
+ * Override renderQuads to handle SDF vs Canvas rendering
222
+ */
223
+ override renderQuads(renderer: CoreRenderer): void {
224
+ if (this.parentHasRenderTexture === true) {
225
+ const rtt = renderer.renderToTextureActive;
226
+ if (rtt === false || this.parentRenderTexture !== renderer.activeRttNode)
227
+ return;
228
+ }
229
+
230
+ // Canvas renderer: use standard texture rendering via CoreNode
231
+ if (this._type === 'canvas') {
232
+ super.renderQuads(renderer);
233
+ return;
234
+ }
235
+
236
+ // Early return if no cached data
237
+ if (!this._cachedLayout) {
238
+ return;
239
+ }
240
+
241
+ if (this._lastVertexBuffer === null) {
242
+ this._lastVertexBuffer = this.textRenderer.addQuads(this._cachedLayout);
243
+ }
244
+
245
+ const props = this.textProps;
246
+ this.textRenderer.renderQuads(
247
+ renderer,
248
+ this._cachedLayout as TextLayout,
249
+ this._lastVertexBuffer!,
250
+ {
251
+ fontFamily: this.textProps.fontFamily,
252
+ fontSize: props.fontSize,
253
+ color: this.props.color || 0xffffffff,
254
+ offsetY: props.offsetY,
255
+ worldAlpha: this.worldAlpha,
256
+ globalTransform: this.globalTransform!.getFloatArr(),
257
+ clippingRect: this.clippingRect,
258
+ width: this.props.w,
259
+ height: this.props.h,
260
+ parentHasRenderTexture: this.parentHasRenderTexture,
261
+ framebufferDimensions:
262
+ this.parentHasRenderTexture === true
263
+ ? this.parentFramebufferDimensions
264
+ : null,
265
+ stage: this.stage,
266
+ },
267
+ );
268
+ }
269
+
270
+ override destroy(): void {
271
+ if (this._waitingForFont === true) {
272
+ this.fontHandler.stopWaitingForFont(this.textProps.fontFamily, this);
273
+ }
274
+
275
+ // Clear cached layout and vertex buffer
276
+ this._cachedLayout = null;
277
+ this._lastVertexBuffer = null;
278
+
279
+ this.fontHandler = null!; // Clear reference to avoid memory leaks
280
+ this.textRenderer = null!; // Clear reference to avoid memory leaks
281
+
282
+ super.destroy();
283
+ }
284
+
285
+ get maxWidth() {
286
+ return this.textProps.maxWidth;
287
+ }
288
+
289
+ set maxWidth(value: number) {
290
+ if (this.textProps.maxWidth !== value) {
291
+ this.textProps.maxWidth = value;
292
+ this._layoutGenerated = false;
293
+ this.setUpdateType(UpdateType.Local);
294
+ }
295
+ }
296
+
297
+ // Property getters and setters
298
+ get maxHeight() {
299
+ return this.textProps.maxHeight;
300
+ }
301
+
302
+ set maxHeight(value: number) {
303
+ if (this.textProps.maxHeight !== value) {
304
+ this.textProps.maxHeight = value;
305
+ this._layoutGenerated = false;
306
+ this.setUpdateType(UpdateType.Local);
307
+ }
308
+ }
309
+
310
+ get text(): string {
311
+ return this.textProps.text;
312
+ }
313
+
314
+ set text(value: string) {
315
+ if (this.textProps.text !== value) {
316
+ this.textProps.text = value;
317
+ this._layoutGenerated = false;
318
+ this.setUpdateType(UpdateType.Local);
319
+ }
320
+ }
321
+
322
+ get fontSize(): number {
323
+ return this.textProps.fontSize;
324
+ }
325
+
326
+ set fontSize(value: number) {
327
+ if (this.textProps.fontSize !== value) {
328
+ this.textProps.fontSize = value;
329
+ this._layoutGenerated = false;
330
+ this.setUpdateType(UpdateType.Local);
331
+ }
332
+ }
333
+
334
+ get fontFamily(): string {
335
+ return this.textProps.fontFamily;
336
+ }
337
+
338
+ set fontFamily(value: string) {
339
+ if (this.textProps.fontFamily !== value) {
340
+ if (this._waitingForFont === true) {
341
+ this.fontHandler.stopWaitingForFont(this.textProps.fontFamily, this);
342
+ }
343
+ this.textProps.fontFamily = value;
344
+ this._layoutGenerated = true;
345
+ this.setUpdateType(UpdateType.Local);
346
+ }
347
+ }
348
+
349
+ get fontStyle(): TrProps['fontStyle'] {
350
+ return this.textProps.fontStyle;
351
+ }
352
+
353
+ set fontStyle(value: TrProps['fontStyle']) {
354
+ if (this.textProps.fontStyle !== value) {
355
+ this.textProps.fontStyle = value;
356
+ this._layoutGenerated = true;
357
+ this.setUpdateType(UpdateType.Local);
358
+ }
359
+ }
360
+
361
+ get textAlign(): TrProps['textAlign'] {
362
+ return this.textProps.textAlign;
363
+ }
364
+
365
+ set textAlign(value: TrProps['textAlign']) {
366
+ if (this.textProps.textAlign !== value) {
367
+ this.textProps.textAlign = value;
368
+ this._layoutGenerated = false;
369
+ this.setUpdateType(UpdateType.Local);
370
+ }
371
+ }
372
+
373
+ get letterSpacing(): number {
374
+ return this.textProps.letterSpacing;
375
+ }
376
+
377
+ set letterSpacing(value: number) {
378
+ if (this.textProps.letterSpacing !== value) {
379
+ this.textProps.letterSpacing = value;
380
+ this._layoutGenerated = false;
381
+ this.setUpdateType(UpdateType.Local);
382
+ }
383
+ }
384
+
385
+ get lineHeight(): number {
386
+ return this.textProps.lineHeight;
387
+ }
388
+
389
+ set lineHeight(value: number) {
390
+ if (this.textProps.lineHeight !== value) {
391
+ this.textProps.lineHeight = value;
392
+ this._layoutGenerated = false;
393
+ this.setUpdateType(UpdateType.Local);
394
+ }
395
+ }
396
+
397
+ get maxLines(): number {
398
+ return this.textProps.maxLines;
399
+ }
400
+
401
+ set maxLines(value: number) {
402
+ if (this.textProps.maxLines !== value) {
403
+ this.textProps.maxLines = value;
404
+ this._layoutGenerated = false;
405
+ this.setUpdateType(UpdateType.Local);
406
+ }
407
+ }
408
+
409
+ get textBaseline(): TrProps['textBaseline'] {
410
+ return this.textProps.textBaseline;
411
+ }
412
+
413
+ set textBaseline(value: TrProps['textBaseline']) {
414
+ if (this.textProps.textBaseline !== value) {
415
+ this.textProps.textBaseline = value;
416
+ this._layoutGenerated = false;
417
+ this.setUpdateType(UpdateType.Local);
418
+ }
419
+ }
420
+
421
+ get verticalAlign(): TrProps['verticalAlign'] {
422
+ return this.textProps.verticalAlign;
423
+ }
424
+
425
+ set verticalAlign(value: TrProps['verticalAlign']) {
426
+ if (this.textProps.verticalAlign !== value) {
427
+ this.textProps.verticalAlign = value;
428
+ this._layoutGenerated = false;
429
+ this.setUpdateType(UpdateType.Local);
430
+ }
431
+ }
432
+
433
+ get overflowSuffix(): string {
434
+ return this.textProps.overflowSuffix;
435
+ }
436
+
437
+ set overflowSuffix(value: string) {
438
+ if (this.textProps.overflowSuffix !== value) {
439
+ this.textProps.overflowSuffix = value;
440
+ this._layoutGenerated = false;
441
+ this.setUpdateType(UpdateType.Local);
442
+ }
443
+ }
444
+
445
+ get wordBreak(): TrProps['wordBreak'] {
446
+ return this.textProps.wordBreak;
447
+ }
448
+
449
+ set wordBreak(value: TrProps['wordBreak']) {
450
+ if (this.textProps.wordBreak !== value) {
451
+ this.textProps.wordBreak = value;
452
+ this._layoutGenerated = false;
453
+ this.setUpdateType(UpdateType.Local);
454
+ }
455
+ }
456
+
457
+ get offsetY(): number {
458
+ return this.textProps.offsetY;
459
+ }
460
+
461
+ set offsetY(value: number) {
462
+ if (this.textProps.offsetY !== value) {
463
+ this.textProps.offsetY = value;
464
+ this._layoutGenerated = false;
465
+ this.setUpdateType(UpdateType.Local);
466
+ }
467
+ }
468
+
469
+ get forceLoad() {
470
+ return this.textProps.forceLoad;
471
+ }
472
+
473
+ set forceLoad(value: boolean) {
474
+ if (this.textProps.forceLoad !== value) {
475
+ this.textProps.forceLoad = value;
476
+ this.setUpdateType(UpdateType.Local);
477
+ }
478
+ }
479
+
480
+ get renderInfo(): TextRenderInfo {
481
+ return this._renderInfo;
482
+ }
483
+ }