@lightningjs/renderer 2.9.2 → 2.11.0

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 (329) hide show
  1. package/LICENSE +202 -202
  2. package/NOTICE +3 -3
  3. package/README.md +147 -147
  4. package/dist/exports/core-api.d.ts +74 -0
  5. package/dist/exports/core-api.js +96 -0
  6. package/dist/exports/core-api.js.map +1 -0
  7. package/dist/exports/main-api.d.ts +30 -0
  8. package/dist/exports/main-api.js +45 -0
  9. package/dist/exports/main-api.js.map +1 -0
  10. package/dist/src/core/CoreExtension.d.ts +12 -0
  11. package/dist/src/core/CoreExtension.js +29 -0
  12. package/dist/src/core/CoreExtension.js.map +1 -0
  13. package/dist/src/core/CoreStuff.d.ts +1 -0
  14. package/dist/src/core/CoreStuff.js +138 -0
  15. package/dist/src/core/CoreStuff.js.map +1 -0
  16. package/dist/src/core/CoreTextureManager.d.ts +5 -2
  17. package/dist/src/core/CoreTextureManager.js +20 -11
  18. package/dist/src/core/CoreTextureManager.js.map +1 -1
  19. package/dist/src/core/LngNode.d.ts +736 -0
  20. package/dist/src/core/LngNode.js +1174 -0
  21. package/dist/src/core/LngNode.js.map +1 -0
  22. package/dist/src/core/Matrix2DContext.d.ts +15 -0
  23. package/dist/src/core/Matrix2DContext.js +45 -0
  24. package/dist/src/core/Matrix2DContext.js.map +1 -0
  25. package/dist/src/core/ShaderNode.d.ts +10 -0
  26. package/dist/src/core/ShaderNode.js +30 -0
  27. package/dist/src/core/ShaderNode.js.map +1 -0
  28. package/dist/src/core/Stage.d.ts +1 -1
  29. package/dist/src/core/Stage.js +2 -2
  30. package/dist/src/core/Stage.js.map +1 -1
  31. package/dist/src/core/TextNode.d.ts +103 -0
  32. package/dist/src/core/TextNode.js +331 -0
  33. package/dist/src/core/TextNode.js.map +1 -0
  34. package/dist/src/core/TextureMemoryManager.d.ts +30 -0
  35. package/dist/src/core/TextureMemoryManager.js +58 -38
  36. package/dist/src/core/TextureMemoryManager.js.map +1 -1
  37. package/dist/src/core/lib/Coords.d.ts +14 -0
  38. package/dist/src/core/lib/Coords.js +55 -0
  39. package/dist/src/core/lib/Coords.js.map +1 -0
  40. package/dist/src/core/lib/glm/common.d.ts +162 -0
  41. package/dist/src/core/lib/glm/common.js +81 -0
  42. package/dist/src/core/lib/glm/common.js.map +1 -0
  43. package/dist/src/core/lib/glm/index.d.ts +11 -0
  44. package/dist/src/core/lib/glm/index.js +30 -0
  45. package/dist/src/core/lib/glm/index.js.map +1 -0
  46. package/dist/src/core/lib/glm/mat2.d.ts +219 -0
  47. package/dist/src/core/lib/glm/mat2.js +396 -0
  48. package/dist/src/core/lib/glm/mat2.js.map +1 -0
  49. package/dist/src/core/lib/glm/mat2d.d.ts +237 -0
  50. package/dist/src/core/lib/glm/mat2d.js +442 -0
  51. package/dist/src/core/lib/glm/mat2d.js.map +1 -0
  52. package/dist/src/core/lib/glm/mat3.d.ts +283 -0
  53. package/dist/src/core/lib/glm/mat3.js +680 -0
  54. package/dist/src/core/lib/glm/mat3.js.map +1 -0
  55. package/dist/src/core/lib/glm/mat4.d.ts +550 -0
  56. package/dist/src/core/lib/glm/mat4.js +1802 -0
  57. package/dist/src/core/lib/glm/mat4.js.map +1 -0
  58. package/dist/src/core/lib/glm/quat.d.ts +363 -0
  59. package/dist/src/core/lib/glm/quat.js +693 -0
  60. package/dist/src/core/lib/glm/quat.js.map +1 -0
  61. package/dist/src/core/lib/glm/quat2.d.ts +356 -0
  62. package/dist/src/core/lib/glm/quat2.js +754 -0
  63. package/dist/src/core/lib/glm/quat2.js.map +1 -0
  64. package/dist/src/core/lib/glm/vec2.d.ts +365 -0
  65. package/dist/src/core/lib/glm/vec2.js +569 -0
  66. package/dist/src/core/lib/glm/vec2.js.map +1 -0
  67. package/dist/src/core/lib/glm/vec3.d.ts +406 -0
  68. package/dist/src/core/lib/glm/vec3.js +720 -0
  69. package/dist/src/core/lib/glm/vec3.js.map +1 -0
  70. package/dist/src/core/lib/glm/vec4.d.ts +330 -0
  71. package/dist/src/core/lib/glm/vec4.js +608 -0
  72. package/dist/src/core/lib/glm/vec4.js.map +1 -0
  73. package/dist/src/core/lib/textureSvg.js +1 -1
  74. package/dist/src/core/lib/textureSvg.js.map +1 -1
  75. package/dist/src/core/renderers/CoreShaderManager.d.ts +19 -0
  76. package/dist/src/core/renderers/CoreShaderManager.js +33 -0
  77. package/dist/src/core/renderers/CoreShaderManager.js.map +1 -0
  78. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js +4 -2
  79. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js.map +1 -1
  80. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js +4 -4
  81. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js.map +1 -1
  82. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js +9 -12
  83. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js.map +1 -1
  84. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.d.ts +27 -0
  85. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js +82 -0
  86. package/dist/src/core/renderers/webgl/WebGlCoreShaderManager.js.map +1 -0
  87. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.d.ts +11 -0
  88. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js +34 -0
  89. package/dist/src/core/renderers/webgl/WebGlCoreShaderProgram.js.map +1 -0
  90. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  91. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  92. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  93. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  94. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  95. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  96. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  97. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  98. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  99. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  100. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  101. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  102. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  103. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  104. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  105. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  106. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  107. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  108. package/dist/src/core/scene/Scene.d.ts +59 -0
  109. package/dist/src/core/scene/Scene.js +106 -0
  110. package/dist/src/core/scene/Scene.js.map +1 -0
  111. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.d.ts +20 -0
  112. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js +55 -0
  113. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/makeRenderWindow.js.map +1 -0
  114. package/dist/src/core/textures/ColorTexture.js +1 -1
  115. package/dist/src/core/textures/ColorTexture.js.map +1 -1
  116. package/dist/src/core/textures/ImageTexture.js +3 -3
  117. package/dist/src/core/textures/ImageTexture.js.map +1 -1
  118. package/dist/src/core/textures/NoiseTexture.js +1 -1
  119. package/dist/src/core/textures/NoiseTexture.js.map +1 -1
  120. package/dist/src/core/textures/RenderTexture.js +1 -1
  121. package/dist/src/core/textures/RenderTexture.js.map +1 -1
  122. package/dist/src/core/textures/SubTexture.d.ts +4 -0
  123. package/dist/src/core/textures/SubTexture.js +54 -16
  124. package/dist/src/core/textures/SubTexture.js.map +1 -1
  125. package/dist/src/core/textures/Texture.d.ts +2 -34
  126. package/dist/src/core/textures/Texture.js +13 -69
  127. package/dist/src/core/textures/Texture.js.map +1 -1
  128. package/dist/src/main-api/ICoreDriver.d.ts +27 -0
  129. package/dist/src/main-api/ICoreDriver.js +20 -0
  130. package/dist/src/main-api/ICoreDriver.js.map +1 -0
  131. package/dist/src/main-api/IRenderDriver.d.ts +20 -0
  132. package/dist/src/main-api/IRenderDriver.js +20 -0
  133. package/dist/src/main-api/IRenderDriver.js.map +1 -0
  134. package/dist/src/main-api/IShaderController.d.ts +14 -0
  135. package/dist/src/main-api/IShaderController.js +30 -0
  136. package/dist/src/main-api/IShaderController.js.map +1 -0
  137. package/dist/src/main-api/IShaderNode.d.ts +17 -0
  138. package/dist/src/main-api/IShaderNode.js +19 -0
  139. package/dist/src/main-api/IShaderNode.js.map +1 -0
  140. package/dist/src/main-api/Renderer.d.ts +6 -5
  141. package/dist/src/main-api/Renderer.js +3 -2
  142. package/dist/src/main-api/Renderer.js.map +1 -1
  143. package/dist/src/main-api/RendererMain.d.ts +375 -0
  144. package/dist/src/main-api/RendererMain.js +365 -0
  145. package/dist/src/main-api/RendererMain.js.map +1 -0
  146. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +9 -0
  147. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +38 -0
  148. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +1 -0
  149. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +56 -0
  150. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +101 -0
  151. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +1 -0
  152. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +32 -0
  153. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +28 -0
  154. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +1 -0
  155. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +24 -0
  156. package/dist/src/render-drivers/main/MainCoreDriver.js +118 -0
  157. package/dist/src/render-drivers/main/MainCoreDriver.js.map +1 -0
  158. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +99 -0
  159. package/dist/src/render-drivers/main/MainOnlyNode.js +396 -0
  160. package/dist/src/render-drivers/main/MainOnlyNode.js.map +1 -0
  161. package/dist/src/render-drivers/main/MainOnlyShaderController.d.ts +6 -0
  162. package/dist/src/render-drivers/main/MainOnlyShaderController.js +15 -0
  163. package/dist/src/render-drivers/main/MainOnlyShaderController.js.map +1 -0
  164. package/dist/src/render-drivers/main/MainOnlyShaderNode.d.ts +7 -0
  165. package/dist/src/render-drivers/main/MainOnlyShaderNode.js +34 -0
  166. package/dist/src/render-drivers/main/MainOnlyShaderNode.js.map +1 -0
  167. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +47 -0
  168. package/dist/src/render-drivers/main/MainOnlyTextNode.js +205 -0
  169. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +1 -0
  170. package/dist/src/render-drivers/main/MainRenderDriver.d.ts +17 -0
  171. package/dist/src/render-drivers/main/MainRenderDriver.js +88 -0
  172. package/dist/src/render-drivers/main/MainRenderDriver.js.map +1 -0
  173. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +90 -0
  174. package/dist/src/render-drivers/threadx/NodeStruct.js +281 -0
  175. package/dist/src/render-drivers/threadx/NodeStruct.js.map +1 -0
  176. package/dist/src/render-drivers/threadx/SharedNode.d.ts +39 -0
  177. package/dist/src/render-drivers/threadx/SharedNode.js +60 -0
  178. package/dist/src/render-drivers/threadx/SharedNode.js.map +1 -0
  179. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +44 -0
  180. package/dist/src/render-drivers/threadx/TextNodeStruct.js +201 -0
  181. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +1 -0
  182. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +28 -0
  183. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +234 -0
  184. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +1 -0
  185. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +20 -0
  186. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +84 -0
  187. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +1 -0
  188. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +44 -0
  189. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +154 -0
  190. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +1 -0
  191. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.d.ts +6 -0
  192. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js +16 -0
  193. package/dist/src/render-drivers/threadx/ThreadXMainShaderController.js.map +1 -0
  194. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.d.ts +7 -0
  195. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js +15 -0
  196. package/dist/src/render-drivers/threadx/ThreadXMainShaderNode.js.map +1 -0
  197. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +28 -0
  198. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +55 -0
  199. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +1 -0
  200. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.d.ts +21 -0
  201. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js +198 -0
  202. package/dist/src/render-drivers/threadx/ThreadXRenderDriver.js.map +1 -0
  203. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +70 -0
  204. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +32 -0
  205. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +1 -0
  206. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +19 -0
  207. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +177 -0
  208. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +1 -0
  209. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +27 -0
  210. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +108 -0
  211. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +1 -0
  212. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +1 -0
  213. package/dist/src/render-drivers/threadx/worker/renderer.js +145 -0
  214. package/dist/src/render-drivers/threadx/worker/renderer.js.map +1 -0
  215. package/dist/src/render-drivers/utils.d.ts +12 -0
  216. package/dist/src/render-drivers/utils.js +69 -0
  217. package/dist/src/render-drivers/utils.js.map +1 -0
  218. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  219. package/exports/canvas.ts +39 -39
  220. package/exports/index.ts +89 -89
  221. package/exports/inspector.ts +24 -24
  222. package/exports/utils.ts +44 -44
  223. package/exports/webgl.ts +38 -38
  224. package/package.json +2 -1
  225. package/scripts/please-use-pnpm.js +13 -13
  226. package/src/common/CommonTypes.ts +139 -139
  227. package/src/common/EventEmitter.ts +77 -77
  228. package/src/common/IAnimationController.ts +92 -92
  229. package/src/common/IEventEmitter.ts +28 -28
  230. package/src/core/CoreNode.test.ts +199 -199
  231. package/src/core/CoreNode.ts +2335 -2335
  232. package/src/core/CoreShaderManager.ts +292 -292
  233. package/src/core/CoreTextNode.ts +455 -455
  234. package/src/core/CoreTextureManager.ts +561 -548
  235. package/src/core/Stage.ts +700 -700
  236. package/src/core/TextureMemoryManager.ts +292 -277
  237. package/src/core/animations/AnimationManager.ts +38 -38
  238. package/src/core/animations/CoreAnimation.ts +340 -340
  239. package/src/core/animations/CoreAnimationController.ts +157 -157
  240. package/src/core/lib/ContextSpy.ts +41 -41
  241. package/src/core/lib/ImageWorker.ts +270 -270
  242. package/src/core/lib/Matrix3d.ts +244 -244
  243. package/src/core/lib/RenderCoords.ts +86 -86
  244. package/src/core/lib/WebGlContextWrapper.ts +1322 -1322
  245. package/src/core/lib/textureCompression.ts +152 -152
  246. package/src/core/lib/textureSvg.ts +78 -78
  247. package/src/core/lib/utils.ts +310 -310
  248. package/src/core/platform.ts +61 -61
  249. package/src/core/renderers/CoreContextTexture.ts +43 -43
  250. package/src/core/renderers/CoreRenderOp.ts +22 -22
  251. package/src/core/renderers/CoreRenderer.ts +114 -114
  252. package/src/core/renderers/CoreShader.ts +41 -41
  253. package/src/core/renderers/canvas/CanvasCoreRenderer.ts +371 -369
  254. package/src/core/renderers/canvas/CanvasCoreTexture.ts +150 -150
  255. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +231 -231
  256. package/src/core/renderers/canvas/internal/ColorUtils.ts +69 -69
  257. package/src/core/renderers/canvas/shaders/UnsupportedShader.ts +48 -48
  258. package/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.ts +79 -79
  259. package/src/core/renderers/webgl/WebGlCoreCtxSubTexture.ts +50 -50
  260. package/src/core/renderers/webgl/WebGlCoreCtxTexture.ts +295 -298
  261. package/src/core/renderers/webgl/WebGlCoreRenderOp.ts +125 -125
  262. package/src/core/renderers/webgl/WebGlCoreRenderer.ts +805 -805
  263. package/src/core/renderers/webgl/WebGlCoreShader.ts +362 -362
  264. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  265. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  266. package/src/core/renderers/webgl/internal/ShaderUtils.ts +143 -143
  267. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  268. package/src/core/renderers/webgl/shaders/DefaultShader.ts +93 -93
  269. package/src/core/renderers/webgl/shaders/DefaultShaderBatched.ts +132 -132
  270. package/src/core/renderers/webgl/shaders/DynamicShader.ts +580 -580
  271. package/src/core/renderers/webgl/shaders/RoundedRectangle.ts +167 -167
  272. package/src/core/renderers/webgl/shaders/SdfShader.ts +204 -204
  273. package/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.ts +101 -101
  274. package/src/core/renderers/webgl/shaders/effects/BorderEffect.ts +87 -87
  275. package/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.ts +101 -101
  276. package/src/core/renderers/webgl/shaders/effects/BorderRightEffect.ts +101 -101
  277. package/src/core/renderers/webgl/shaders/effects/BorderTopEffect.ts +101 -101
  278. package/src/core/renderers/webgl/shaders/effects/EffectUtils.ts +159 -159
  279. package/src/core/renderers/webgl/shaders/effects/FadeOutEffect.ts +127 -127
  280. package/src/core/renderers/webgl/shaders/effects/GlitchEffect.ts +148 -148
  281. package/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts +67 -67
  282. package/src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts +157 -157
  283. package/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts +171 -171
  284. package/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts +168 -168
  285. package/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.ts +187 -187
  286. package/src/core/renderers/webgl/shaders/effects/RadiusEffect.ts +110 -110
  287. package/src/core/renderers/webgl/shaders/effects/ShaderEffect.ts +196 -196
  288. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  289. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  290. package/src/core/text-rendering/TrFontManager.ts +183 -183
  291. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  292. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  293. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  294. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  295. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  296. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -94
  297. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +509 -509
  298. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +808 -808
  299. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +853 -853
  300. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  301. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  302. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  303. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  304. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  305. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  306. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  307. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +408 -408
  308. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  309. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  310. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  311. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  312. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  313. package/src/core/text-rendering/renderers/TextRenderer.ts +557 -557
  314. package/src/core/textures/ColorTexture.ts +102 -102
  315. package/src/core/textures/ImageTexture.ts +379 -379
  316. package/src/core/textures/NoiseTexture.ts +104 -104
  317. package/src/core/textures/RenderTexture.ts +85 -85
  318. package/src/core/textures/SubTexture.ts +225 -179
  319. package/src/core/textures/Texture.ts +347 -435
  320. package/src/core/utils.ts +227 -227
  321. package/src/env.d.ts +7 -7
  322. package/src/main-api/DynamicShaderController.ts +104 -104
  323. package/src/main-api/INode.ts +101 -101
  324. package/src/main-api/Inspector.ts +505 -505
  325. package/src/main-api/Renderer.ts +698 -693
  326. package/src/main-api/ShaderController.ts +80 -80
  327. package/src/main-api/utils.ts +45 -45
  328. package/src/utils.ts +248 -248
  329. package/COPYING +0 -1
@@ -1,580 +1,580 @@
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
- import type { WebGlCoreRenderer } from '../WebGlCoreRenderer.js';
20
- import {
21
- WebGlCoreShader,
22
- type DimensionsShaderProp,
23
- type AlphaShaderProp,
24
- } from '../WebGlCoreShader.js';
25
- import { type UniformInfo } from '../internal/ShaderUtils.js';
26
- import type { WebGlCoreCtxTexture } from '../WebGlCoreCtxTexture.js';
27
- import {
28
- ShaderEffect,
29
- type EffectDescUnion,
30
- type ShaderEffectUniform,
31
- type ShaderEffectValueMap,
32
- type BaseEffectDesc,
33
- } from './effects/ShaderEffect.js';
34
- import type { EffectMap } from '../../../CoreShaderManager.js';
35
- import { assertTruthy } from '../../../../utils.js';
36
- import type { UniformMethodMap } from '../../../lib/WebGlContextWrapper.js';
37
-
38
- export interface DynamicShaderProps
39
- extends DimensionsShaderProp,
40
- AlphaShaderProp {
41
- effects?: EffectDescUnion[];
42
- }
43
-
44
- const effectCache = new Map<string, BaseEffectDesc[]>();
45
- const getResolvedEffect = (
46
- effects: BaseEffectDesc[],
47
- effectContructors: Partial<EffectMap>,
48
- ): BaseEffectDesc[] => {
49
- const key = JSON.stringify(effects);
50
- if (effectCache.has(key)) {
51
- return effectCache.get(key)!;
52
- }
53
- effects = effects ?? [];
54
- const resolvedEffects = [];
55
- const effectsLength = effects.length;
56
- let i = 0;
57
- for (; i < effectsLength; i++) {
58
- const { name, type, props } = effects[i] as BaseEffectDesc;
59
- const resolvedEffect = {
60
- name,
61
- type,
62
- props: {} as Record<string, any>,
63
- };
64
-
65
- const effectConstructor = effectContructors[type]!;
66
- const defaultPropValues = effectConstructor.resolveDefaults(props);
67
- const uniforms = effectConstructor.uniforms;
68
- const uniformKeys = Object.keys(uniforms);
69
- const uniformsLength = uniformKeys.length;
70
- let j = 0;
71
- for (; j < uniformsLength; j++) {
72
- const key = uniformKeys[j]!;
73
- const uniform = uniforms[key]!;
74
-
75
- const result: ShaderEffectValueMap = {
76
- value: defaultPropValues[key] as ShaderEffectUniform['value'],
77
- programValue: undefined,
78
- method: uniform.method,
79
- updateOnBind: uniform.updateOnBind || false,
80
- hasValidator: uniform.validator !== undefined,
81
- hasProgramValueUpdater: uniform.updateProgramValue !== undefined,
82
- };
83
-
84
- const validatedValue =
85
- (result.hasValidator &&
86
- uniform.validator!(defaultPropValues[key], defaultPropValues)) ||
87
- defaultPropValues[key];
88
-
89
- if (defaultPropValues[key] !== validatedValue) {
90
- result.validatedValue = validatedValue as number | number[];
91
- }
92
-
93
- if (result.hasProgramValueUpdater) {
94
- uniform.updateProgramValue!(result);
95
- }
96
-
97
- if (result.programValue === undefined) {
98
- result.programValue = result.value as number;
99
- }
100
-
101
- resolvedEffect.props[key] = result;
102
- }
103
- resolvedEffects.push(resolvedEffect);
104
- }
105
-
106
- effectCache.set(key, resolvedEffects);
107
- return resolvedEffects;
108
- };
109
-
110
- export class DynamicShader extends WebGlCoreShader {
111
- effects: Array<InstanceType<EffectMap[keyof EffectMap]>> = [];
112
-
113
- constructor(
114
- renderer: WebGlCoreRenderer,
115
- props: DynamicShaderProps,
116
- effectContructors: Partial<EffectMap>,
117
- ) {
118
- const shader = DynamicShader.createShader(props, effectContructors);
119
- super({
120
- renderer,
121
- attributes: ['a_position', 'a_textureCoordinate', 'a_color'],
122
- uniforms: [
123
- { name: 'u_resolution', uniform: 'uniform2fv' },
124
- { name: 'u_pixelRatio', uniform: 'uniform1f' },
125
- { name: 'u_texture', uniform: 'uniform2fv' },
126
- { name: 'u_dimensions', uniform: 'uniform2fv' },
127
- { name: 'u_alpha', uniform: 'uniform1f' },
128
- ...shader.uniforms,
129
- ],
130
- shaderSources: {
131
- vertex: shader.vertex,
132
- fragment: shader.fragment,
133
- },
134
- });
135
-
136
- this.effects = shader.effects as Array<
137
- InstanceType<EffectMap[keyof EffectMap]>
138
- >;
139
- }
140
-
141
- override bindTextures(textures: WebGlCoreCtxTexture[]) {
142
- const { glw } = this;
143
- glw.activeTexture(0);
144
- glw.bindTexture(textures[0]!.ctxTexture);
145
- }
146
-
147
- bindUniformMethods(props: DynamicShaderProps): void {
148
- const glw = this.glw;
149
- const effects = props.effects;
150
- const effectsL = effects!.length;
151
- for (let i = 0; i < effectsL; i++) {
152
- const uniformInfo = this.effects[i]!.uniformInfo;
153
- const effect = effects![i]! as Record<string, any>;
154
- const propKeys = Object.keys(effect.props);
155
- const propsLength = propKeys.length;
156
- for (let j = 0; j < propsLength; j++) {
157
- const key = propKeys[j]!;
158
- const method = effect.props[key].method as keyof UniformMethodMap;
159
- const location = this.getUniformLocation(uniformInfo[key]!.name);
160
-
161
- if (
162
- method === 'uniform2fv' ||
163
- method === 'uniform2iv' ||
164
- //uniform === 'uniform3fv ' || <--- check why this isnt recognized
165
- method === 'uniform3iv' ||
166
- method === 'uniform4fv' ||
167
- method === 'uniform4iv' ||
168
- method === 'uniformMatrix2fv' ||
169
- method === 'uniformMatrix3fv' ||
170
- method === 'uniformMatrix4fv' ||
171
- method === 'uniform1f' ||
172
- method === 'uniform1fv' ||
173
- method === 'uniform1i' ||
174
- method === 'uniform1iv'
175
- ) {
176
- effect.props[key].setUniformValue = function () {
177
- glw[method](location, this.programValue);
178
- };
179
- continue;
180
- }
181
-
182
- if (method === 'uniform2f' || method === 'uniform2i') {
183
- effect.props[key].setUniformValue = function () {
184
- glw[method](location, this.programValue[0]!, this.programValue[1]!);
185
- };
186
- continue;
187
- }
188
-
189
- if (method === 'uniform3f' || method === 'uniform3i') {
190
- effect.props[key].setUniformValue = function () {
191
- glw[method](
192
- location,
193
- this.programValue[0]!,
194
- this.programValue[1]!,
195
- this.programValue[2]!,
196
- );
197
- };
198
- continue;
199
- }
200
-
201
- if (method === 'uniform4f' || method === 'uniform4i') {
202
- effect.props[key].setUniformValue = function () {
203
- glw[method](
204
- location,
205
- this.programValue[0]!,
206
- this.programValue[1]!,
207
- this.programValue[2]!,
208
- this.programValue[3]!,
209
- );
210
- };
211
- continue;
212
- }
213
- }
214
- }
215
- }
216
-
217
- protected override bindProps(props: Required<DynamicShaderProps>): void {
218
- const effects = props.effects;
219
- const effectsL = effects.length;
220
- let i = 0;
221
- for (; i < effectsL; i++) {
222
- const effect = effects[i]! as Record<string, any>;
223
- const propKeys = Object.keys(effect.props);
224
- const propsLength = propKeys.length;
225
- let j = 0;
226
- for (; j < propsLength; j++) {
227
- const key = propKeys[j]!;
228
- const prop = effect.props[key]!;
229
- if (prop.updateOnBind === true) {
230
- const uniform =
231
- this.renderer.shManager.getRegisteredEffects()[
232
- effect.type as keyof EffectMap
233
- ]?.uniforms[key];
234
- uniform?.updateProgramValue!(effect.props[key], props);
235
- }
236
-
237
- prop.setUniformValue();
238
- }
239
- }
240
- }
241
-
242
- override canBatchShaderProps(
243
- propsA: Required<DynamicShaderProps>,
244
- propsB: Required<DynamicShaderProps>,
245
- ): boolean {
246
- if (
247
- propsA.$alpha !== propsB.$alpha ||
248
- propsA.$dimensions.width !== propsB.$dimensions.width ||
249
- propsA.$dimensions.height !== propsB.$dimensions.height ||
250
- propsA.effects.length !== propsB.effects.length
251
- ) {
252
- return false;
253
- }
254
- const propsEffectsLen = propsA.effects.length;
255
- let i = 0;
256
- for (; i < propsEffectsLen; i++) {
257
- const effectA = propsA.effects[i]!;
258
- const effectB = propsB.effects[i]!;
259
- if (effectA.type !== effectB.type) {
260
- return false;
261
- }
262
- for (const key in effectA.props) {
263
- if (
264
- (effectB.props && !effectB.props[key]) ||
265
- (effectA.props[key] as ShaderEffectValueMap).value !==
266
- (effectB.props[key] as ShaderEffectValueMap).value
267
- ) {
268
- return false;
269
- }
270
- }
271
- }
272
- return true;
273
- }
274
-
275
- static createShader(
276
- props: DynamicShaderProps,
277
- effectContructors: Partial<EffectMap>,
278
- ) {
279
- //counts duplicate effects
280
- const effectNameCount: Record<string, number> = {};
281
- const methods: Record<string, string> = {};
282
-
283
- let declareUniforms = '';
284
- const uniforms: UniformInfo[] = [];
285
-
286
- const uFx: Record<string, unknown>[] = [];
287
-
288
- const effects = props.effects!.map((effect) => {
289
- const baseClass = effectContructors[effect.type]!;
290
- const key = baseClass.getEffectKey(effect.props || {});
291
-
292
- effectNameCount[key] = effectNameCount[key] ? ++effectNameCount[key] : 1;
293
-
294
- const nr = effectNameCount[key]!;
295
-
296
- if (nr === 1) {
297
- uFx.push({ key, type: effect.type, props: effect.props });
298
- }
299
-
300
- //initialize new effect class;
301
- const fxClass = new baseClass({
302
- ref: `${key}${nr === 1 ? '' : nr}`,
303
- target: key,
304
- props: effect.props,
305
- }) as ShaderEffect;
306
-
307
- declareUniforms += fxClass.declaredUniforms;
308
- uniforms.push(...Object.values(fxClass.uniformInfo));
309
- return fxClass;
310
- });
311
-
312
- //build source
313
- let effectMethods = '';
314
-
315
- uFx?.forEach((fx) => {
316
- const fxClass = effectContructors[fx.type as keyof EffectMap]!;
317
- const fxProps = fxClass.resolveDefaults(
318
- (fx.props ?? {}) as Record<string, unknown>,
319
- );
320
-
321
- const remap: Record<string, string>[] = [];
322
- for (const m in fxClass.methods) {
323
- let cm = m;
324
- const fxMethod = fxClass.methods[m]!;
325
- if (methods[m] && methods[m] !== fxMethod) {
326
- cm = DynamicShader.resolveMethodDuplicate(m, fxMethod, methods);
327
- }
328
- methods[cm] = fxMethod.replace('function', cm);
329
- remap.push({ m, cm });
330
- }
331
-
332
- let onShaderMask =
333
- fxClass.onShaderMask instanceof Function
334
- ? fxClass.onShaderMask(fxProps)
335
- : fxClass.onShaderMask;
336
-
337
- let onColorize =
338
- fxClass.onColorize instanceof Function
339
- ? fxClass.onColorize(fxProps)
340
- : fxClass.onColorize;
341
-
342
- let onEffectMask =
343
- fxClass.onEffectMask instanceof Function
344
- ? fxClass.onEffectMask(fxProps)
345
- : fxClass.onEffectMask;
346
-
347
- remap.forEach((r) => {
348
- const { m, cm } = r;
349
- const reg = new RegExp(`\\$${m!}`, 'g');
350
- if (onShaderMask) {
351
- onShaderMask = onShaderMask.replace(reg, cm!);
352
- }
353
- if (onColorize) {
354
- onColorize = onColorize.replace(reg, cm!);
355
- }
356
- if (onEffectMask) {
357
- onEffectMask = onEffectMask.replace(reg, cm!);
358
- }
359
- });
360
-
361
- const methodParameters = fxClass.getMethodParameters(
362
- fxClass.uniforms,
363
- fxProps,
364
- );
365
- const pm = methodParameters.length > 0 ? `, ${methodParameters}` : '';
366
- if (onShaderMask) {
367
- effectMethods += `
368
- float fx_${fx.key as string}_onShaderMask(float shaderMask ${pm}) {
369
- ${onShaderMask}
370
- }
371
- `;
372
- }
373
- if (onColorize) {
374
- effectMethods += `
375
- vec4 fx_${
376
- fx.key as string
377
- }_onColorize(float shaderMask, vec4 maskColor, vec4 shaderColor${pm}) {
378
- ${onColorize}
379
- }
380
- `;
381
- }
382
-
383
- if (onEffectMask) {
384
- effectMethods += `
385
- vec4 fx_${
386
- fx.key as string
387
- }_onEffectMask(float shaderMask, vec4 maskColor, vec4 shaderColor${pm}) {
388
- ${onEffectMask}
389
- }
390
- `;
391
- }
392
- });
393
-
394
- let sharedMethods = '';
395
- for (const m in methods) {
396
- sharedMethods += methods[m];
397
- }
398
-
399
- //fill main functions
400
- let currentMask = `mix(shaderColor, maskColor, clamp(-(lng_DefaultMask), 0.0, 1.0))`;
401
- let drawEffects = `
402
-
403
- `;
404
- for (let i = 0; i < effects.length; i++) {
405
- const current = effects[i]!;
406
- const pm =
407
- current.passParameters.length > 0 ? `, ${current.passParameters}` : '';
408
- const currentClass = effectContructors[current.name as keyof EffectMap]!;
409
-
410
- if (currentClass.onShaderMask) {
411
- drawEffects += `
412
- shaderMask = fx_${current.target}_onShaderMask(shaderMask ${pm});
413
- `;
414
- }
415
- if (currentClass.onColorize) {
416
- drawEffects += `
417
- maskColor = fx_${current.target}_onColorize(shaderMask, maskColor, shaderColor${pm});
418
- `;
419
- }
420
- if (currentClass.onEffectMask) {
421
- currentMask = `fx_${current.target}_onEffectMask(shaderMask, maskColor, shaderColor${pm})`;
422
- }
423
-
424
- const next = effects[i + 1]!;
425
- if (
426
- next === undefined ||
427
- effectContructors[next.name as keyof EffectMap]!.onEffectMask
428
- ) {
429
- drawEffects += `
430
- shaderColor = ${currentMask};
431
- `;
432
- }
433
- }
434
-
435
- return {
436
- effects,
437
- uniforms,
438
- fragment: DynamicShader.fragment(
439
- declareUniforms,
440
- sharedMethods,
441
- effectMethods,
442
- drawEffects,
443
- ),
444
- vertex: DynamicShader.vertex(),
445
- };
446
- }
447
-
448
- static resolveMethodDuplicate(
449
- key: string,
450
- effectMethod: string,
451
- methodCollection: Record<string, string>,
452
- increment = 0,
453
- ): string {
454
- const m = key + (increment > 0 ? (increment as unknown as string) : '');
455
- if (methodCollection[m] && methodCollection[m] !== effectMethod) {
456
- return this.resolveMethodDuplicate(
457
- key,
458
- effectMethod,
459
- methodCollection,
460
- ++increment,
461
- );
462
- }
463
- return m;
464
- }
465
-
466
- static override resolveDefaults(
467
- props: DynamicShaderProps,
468
- effectContructors?: Partial<EffectMap>,
469
- ): Required<DynamicShaderProps> {
470
- assertTruthy(effectContructors);
471
- return {
472
- effects: getResolvedEffect(
473
- props.effects ?? [],
474
- effectContructors,
475
- ) as EffectDescUnion[],
476
- $dimensions: {
477
- width: 0,
478
- height: 0,
479
- },
480
- $alpha: 0,
481
- };
482
- }
483
-
484
- static override makeCacheKey(
485
- props: DynamicShaderProps,
486
- effectContructors?: Partial<EffectMap>,
487
- ): string {
488
- let fx = '';
489
- props.effects?.forEach((effect) => {
490
- const baseClass = effectContructors![effect.type]!;
491
- const key = baseClass.getEffectKey(effect.props || {});
492
- fx += `,${key}`;
493
- });
494
- return `DynamicShader${fx}`;
495
- }
496
-
497
- static z$__type__Props: DynamicShaderProps;
498
-
499
- static vertex = () => `
500
- # ifdef GL_FRAGMENT_PRECISION_HIGH
501
- precision highp float;
502
- # else
503
- precision mediump float;
504
- # endif
505
-
506
- attribute vec2 a_textureCoordinate;
507
- attribute vec2 a_position;
508
- attribute vec4 a_color;
509
- attribute float a_textureIndex;
510
-
511
- uniform vec2 u_resolution;
512
- uniform float u_pixelRatio;
513
-
514
- varying vec4 v_color;
515
- varying vec2 v_textureCoordinate;
516
- varying float v_textureIndex;
517
-
518
- void main(){
519
- vec2 normalized = a_position * u_pixelRatio / u_resolution;
520
- vec2 zero_two = normalized * 2.0;
521
- vec2 clip_space = zero_two - 1.0;
522
-
523
- // pass to fragment
524
- v_color = a_color;
525
- v_textureCoordinate = a_textureCoordinate;
526
- v_textureIndex = a_textureIndex;
527
-
528
- // flip y
529
- gl_Position = vec4(clip_space * vec2(1.0, -1.0), 0, 1);
530
- }
531
- `;
532
-
533
- static fragment = (
534
- uniforms: string,
535
- methods: string,
536
- effectMethods: string,
537
- drawEffects: string,
538
- ) => `
539
- # ifdef GL_FRAGMENT_PRECISION_HIGH
540
- precision highp float;
541
- # else
542
- precision mediump float;
543
- # endif
544
-
545
- #define PI 3.14159265359
546
-
547
- uniform vec2 u_resolution;
548
- uniform vec2 u_dimensions;
549
- uniform float u_alpha;
550
- uniform float u_radius;
551
- uniform sampler2D u_texture;
552
- uniform float u_pixelRatio;
553
-
554
- ${uniforms}
555
-
556
- varying vec4 v_color;
557
- varying vec2 v_textureCoordinate;
558
-
559
- ${methods}
560
-
561
- ${effectMethods}
562
-
563
- void main() {
564
- vec2 p = v_textureCoordinate.xy * u_dimensions - u_dimensions * 0.5;
565
- vec2 d = abs(p) - (u_dimensions) * 0.5;
566
- float lng_DefaultMask = min(max(d.x, d.y), 0.0) + length(max(d, 0.0));
567
-
568
- vec4 shaderColor = vec4(0.0);
569
- float shaderMask = lng_DefaultMask;
570
-
571
- vec4 maskColor = texture2D(u_texture, v_textureCoordinate) * v_color;
572
-
573
- shaderColor = mix(shaderColor, maskColor, clamp(-(lng_DefaultMask + 0.5), 0.0, 1.0));
574
-
575
- ${drawEffects}
576
-
577
- gl_FragColor = shaderColor * u_alpha;
578
- }
579
- `;
580
- }
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
+ import type { WebGlCoreRenderer } from '../WebGlCoreRenderer.js';
20
+ import {
21
+ WebGlCoreShader,
22
+ type DimensionsShaderProp,
23
+ type AlphaShaderProp,
24
+ } from '../WebGlCoreShader.js';
25
+ import { type UniformInfo } from '../internal/ShaderUtils.js';
26
+ import type { WebGlCoreCtxTexture } from '../WebGlCoreCtxTexture.js';
27
+ import {
28
+ ShaderEffect,
29
+ type EffectDescUnion,
30
+ type ShaderEffectUniform,
31
+ type ShaderEffectValueMap,
32
+ type BaseEffectDesc,
33
+ } from './effects/ShaderEffect.js';
34
+ import type { EffectMap } from '../../../CoreShaderManager.js';
35
+ import { assertTruthy } from '../../../../utils.js';
36
+ import type { UniformMethodMap } from '../../../lib/WebGlContextWrapper.js';
37
+
38
+ export interface DynamicShaderProps
39
+ extends DimensionsShaderProp,
40
+ AlphaShaderProp {
41
+ effects?: EffectDescUnion[];
42
+ }
43
+
44
+ const effectCache = new Map<string, BaseEffectDesc[]>();
45
+ const getResolvedEffect = (
46
+ effects: BaseEffectDesc[],
47
+ effectContructors: Partial<EffectMap>,
48
+ ): BaseEffectDesc[] => {
49
+ const key = JSON.stringify(effects);
50
+ if (effectCache.has(key)) {
51
+ return effectCache.get(key)!;
52
+ }
53
+ effects = effects ?? [];
54
+ const resolvedEffects = [];
55
+ const effectsLength = effects.length;
56
+ let i = 0;
57
+ for (; i < effectsLength; i++) {
58
+ const { name, type, props } = effects[i] as BaseEffectDesc;
59
+ const resolvedEffect = {
60
+ name,
61
+ type,
62
+ props: {} as Record<string, any>,
63
+ };
64
+
65
+ const effectConstructor = effectContructors[type]!;
66
+ const defaultPropValues = effectConstructor.resolveDefaults(props);
67
+ const uniforms = effectConstructor.uniforms;
68
+ const uniformKeys = Object.keys(uniforms);
69
+ const uniformsLength = uniformKeys.length;
70
+ let j = 0;
71
+ for (; j < uniformsLength; j++) {
72
+ const key = uniformKeys[j]!;
73
+ const uniform = uniforms[key]!;
74
+
75
+ const result: ShaderEffectValueMap = {
76
+ value: defaultPropValues[key] as ShaderEffectUniform['value'],
77
+ programValue: undefined,
78
+ method: uniform.method,
79
+ updateOnBind: uniform.updateOnBind || false,
80
+ hasValidator: uniform.validator !== undefined,
81
+ hasProgramValueUpdater: uniform.updateProgramValue !== undefined,
82
+ };
83
+
84
+ const validatedValue =
85
+ (result.hasValidator &&
86
+ uniform.validator!(defaultPropValues[key], defaultPropValues)) ||
87
+ defaultPropValues[key];
88
+
89
+ if (defaultPropValues[key] !== validatedValue) {
90
+ result.validatedValue = validatedValue as number | number[];
91
+ }
92
+
93
+ if (result.hasProgramValueUpdater) {
94
+ uniform.updateProgramValue!(result);
95
+ }
96
+
97
+ if (result.programValue === undefined) {
98
+ result.programValue = result.value as number;
99
+ }
100
+
101
+ resolvedEffect.props[key] = result;
102
+ }
103
+ resolvedEffects.push(resolvedEffect);
104
+ }
105
+
106
+ effectCache.set(key, resolvedEffects);
107
+ return resolvedEffects;
108
+ };
109
+
110
+ export class DynamicShader extends WebGlCoreShader {
111
+ effects: Array<InstanceType<EffectMap[keyof EffectMap]>> = [];
112
+
113
+ constructor(
114
+ renderer: WebGlCoreRenderer,
115
+ props: DynamicShaderProps,
116
+ effectContructors: Partial<EffectMap>,
117
+ ) {
118
+ const shader = DynamicShader.createShader(props, effectContructors);
119
+ super({
120
+ renderer,
121
+ attributes: ['a_position', 'a_textureCoordinate', 'a_color'],
122
+ uniforms: [
123
+ { name: 'u_resolution', uniform: 'uniform2fv' },
124
+ { name: 'u_pixelRatio', uniform: 'uniform1f' },
125
+ { name: 'u_texture', uniform: 'uniform2fv' },
126
+ { name: 'u_dimensions', uniform: 'uniform2fv' },
127
+ { name: 'u_alpha', uniform: 'uniform1f' },
128
+ ...shader.uniforms,
129
+ ],
130
+ shaderSources: {
131
+ vertex: shader.vertex,
132
+ fragment: shader.fragment,
133
+ },
134
+ });
135
+
136
+ this.effects = shader.effects as Array<
137
+ InstanceType<EffectMap[keyof EffectMap]>
138
+ >;
139
+ }
140
+
141
+ override bindTextures(textures: WebGlCoreCtxTexture[]) {
142
+ const { glw } = this;
143
+ glw.activeTexture(0);
144
+ glw.bindTexture(textures[0]!.ctxTexture);
145
+ }
146
+
147
+ bindUniformMethods(props: DynamicShaderProps): void {
148
+ const glw = this.glw;
149
+ const effects = props.effects;
150
+ const effectsL = effects!.length;
151
+ for (let i = 0; i < effectsL; i++) {
152
+ const uniformInfo = this.effects[i]!.uniformInfo;
153
+ const effect = effects![i]! as Record<string, any>;
154
+ const propKeys = Object.keys(effect.props);
155
+ const propsLength = propKeys.length;
156
+ for (let j = 0; j < propsLength; j++) {
157
+ const key = propKeys[j]!;
158
+ const method = effect.props[key].method as keyof UniformMethodMap;
159
+ const location = this.getUniformLocation(uniformInfo[key]!.name);
160
+
161
+ if (
162
+ method === 'uniform2fv' ||
163
+ method === 'uniform2iv' ||
164
+ //uniform === 'uniform3fv ' || <--- check why this isnt recognized
165
+ method === 'uniform3iv' ||
166
+ method === 'uniform4fv' ||
167
+ method === 'uniform4iv' ||
168
+ method === 'uniformMatrix2fv' ||
169
+ method === 'uniformMatrix3fv' ||
170
+ method === 'uniformMatrix4fv' ||
171
+ method === 'uniform1f' ||
172
+ method === 'uniform1fv' ||
173
+ method === 'uniform1i' ||
174
+ method === 'uniform1iv'
175
+ ) {
176
+ effect.props[key].setUniformValue = function () {
177
+ glw[method](location, this.programValue);
178
+ };
179
+ continue;
180
+ }
181
+
182
+ if (method === 'uniform2f' || method === 'uniform2i') {
183
+ effect.props[key].setUniformValue = function () {
184
+ glw[method](location, this.programValue[0]!, this.programValue[1]!);
185
+ };
186
+ continue;
187
+ }
188
+
189
+ if (method === 'uniform3f' || method === 'uniform3i') {
190
+ effect.props[key].setUniformValue = function () {
191
+ glw[method](
192
+ location,
193
+ this.programValue[0]!,
194
+ this.programValue[1]!,
195
+ this.programValue[2]!,
196
+ );
197
+ };
198
+ continue;
199
+ }
200
+
201
+ if (method === 'uniform4f' || method === 'uniform4i') {
202
+ effect.props[key].setUniformValue = function () {
203
+ glw[method](
204
+ location,
205
+ this.programValue[0]!,
206
+ this.programValue[1]!,
207
+ this.programValue[2]!,
208
+ this.programValue[3]!,
209
+ );
210
+ };
211
+ continue;
212
+ }
213
+ }
214
+ }
215
+ }
216
+
217
+ protected override bindProps(props: Required<DynamicShaderProps>): void {
218
+ const effects = props.effects;
219
+ const effectsL = effects.length;
220
+ let i = 0;
221
+ for (; i < effectsL; i++) {
222
+ const effect = effects[i]! as Record<string, any>;
223
+ const propKeys = Object.keys(effect.props);
224
+ const propsLength = propKeys.length;
225
+ let j = 0;
226
+ for (; j < propsLength; j++) {
227
+ const key = propKeys[j]!;
228
+ const prop = effect.props[key]!;
229
+ if (prop.updateOnBind === true) {
230
+ const uniform =
231
+ this.renderer.shManager.getRegisteredEffects()[
232
+ effect.type as keyof EffectMap
233
+ ]?.uniforms[key];
234
+ uniform?.updateProgramValue!(effect.props[key], props);
235
+ }
236
+
237
+ prop.setUniformValue();
238
+ }
239
+ }
240
+ }
241
+
242
+ override canBatchShaderProps(
243
+ propsA: Required<DynamicShaderProps>,
244
+ propsB: Required<DynamicShaderProps>,
245
+ ): boolean {
246
+ if (
247
+ propsA.$alpha !== propsB.$alpha ||
248
+ propsA.$dimensions.width !== propsB.$dimensions.width ||
249
+ propsA.$dimensions.height !== propsB.$dimensions.height ||
250
+ propsA.effects.length !== propsB.effects.length
251
+ ) {
252
+ return false;
253
+ }
254
+ const propsEffectsLen = propsA.effects.length;
255
+ let i = 0;
256
+ for (; i < propsEffectsLen; i++) {
257
+ const effectA = propsA.effects[i]!;
258
+ const effectB = propsB.effects[i]!;
259
+ if (effectA.type !== effectB.type) {
260
+ return false;
261
+ }
262
+ for (const key in effectA.props) {
263
+ if (
264
+ (effectB.props && !effectB.props[key]) ||
265
+ (effectA.props[key] as ShaderEffectValueMap).value !==
266
+ (effectB.props[key] as ShaderEffectValueMap).value
267
+ ) {
268
+ return false;
269
+ }
270
+ }
271
+ }
272
+ return true;
273
+ }
274
+
275
+ static createShader(
276
+ props: DynamicShaderProps,
277
+ effectContructors: Partial<EffectMap>,
278
+ ) {
279
+ //counts duplicate effects
280
+ const effectNameCount: Record<string, number> = {};
281
+ const methods: Record<string, string> = {};
282
+
283
+ let declareUniforms = '';
284
+ const uniforms: UniformInfo[] = [];
285
+
286
+ const uFx: Record<string, unknown>[] = [];
287
+
288
+ const effects = props.effects!.map((effect) => {
289
+ const baseClass = effectContructors[effect.type]!;
290
+ const key = baseClass.getEffectKey(effect.props || {});
291
+
292
+ effectNameCount[key] = effectNameCount[key] ? ++effectNameCount[key] : 1;
293
+
294
+ const nr = effectNameCount[key]!;
295
+
296
+ if (nr === 1) {
297
+ uFx.push({ key, type: effect.type, props: effect.props });
298
+ }
299
+
300
+ //initialize new effect class;
301
+ const fxClass = new baseClass({
302
+ ref: `${key}${nr === 1 ? '' : nr}`,
303
+ target: key,
304
+ props: effect.props,
305
+ }) as ShaderEffect;
306
+
307
+ declareUniforms += fxClass.declaredUniforms;
308
+ uniforms.push(...Object.values(fxClass.uniformInfo));
309
+ return fxClass;
310
+ });
311
+
312
+ //build source
313
+ let effectMethods = '';
314
+
315
+ uFx?.forEach((fx) => {
316
+ const fxClass = effectContructors[fx.type as keyof EffectMap]!;
317
+ const fxProps = fxClass.resolveDefaults(
318
+ (fx.props ?? {}) as Record<string, unknown>,
319
+ );
320
+
321
+ const remap: Record<string, string>[] = [];
322
+ for (const m in fxClass.methods) {
323
+ let cm = m;
324
+ const fxMethod = fxClass.methods[m]!;
325
+ if (methods[m] && methods[m] !== fxMethod) {
326
+ cm = DynamicShader.resolveMethodDuplicate(m, fxMethod, methods);
327
+ }
328
+ methods[cm] = fxMethod.replace('function', cm);
329
+ remap.push({ m, cm });
330
+ }
331
+
332
+ let onShaderMask =
333
+ fxClass.onShaderMask instanceof Function
334
+ ? fxClass.onShaderMask(fxProps)
335
+ : fxClass.onShaderMask;
336
+
337
+ let onColorize =
338
+ fxClass.onColorize instanceof Function
339
+ ? fxClass.onColorize(fxProps)
340
+ : fxClass.onColorize;
341
+
342
+ let onEffectMask =
343
+ fxClass.onEffectMask instanceof Function
344
+ ? fxClass.onEffectMask(fxProps)
345
+ : fxClass.onEffectMask;
346
+
347
+ remap.forEach((r) => {
348
+ const { m, cm } = r;
349
+ const reg = new RegExp(`\\$${m!}`, 'g');
350
+ if (onShaderMask) {
351
+ onShaderMask = onShaderMask.replace(reg, cm!);
352
+ }
353
+ if (onColorize) {
354
+ onColorize = onColorize.replace(reg, cm!);
355
+ }
356
+ if (onEffectMask) {
357
+ onEffectMask = onEffectMask.replace(reg, cm!);
358
+ }
359
+ });
360
+
361
+ const methodParameters = fxClass.getMethodParameters(
362
+ fxClass.uniforms,
363
+ fxProps,
364
+ );
365
+ const pm = methodParameters.length > 0 ? `, ${methodParameters}` : '';
366
+ if (onShaderMask) {
367
+ effectMethods += `
368
+ float fx_${fx.key as string}_onShaderMask(float shaderMask ${pm}) {
369
+ ${onShaderMask}
370
+ }
371
+ `;
372
+ }
373
+ if (onColorize) {
374
+ effectMethods += `
375
+ vec4 fx_${
376
+ fx.key as string
377
+ }_onColorize(float shaderMask, vec4 maskColor, vec4 shaderColor${pm}) {
378
+ ${onColorize}
379
+ }
380
+ `;
381
+ }
382
+
383
+ if (onEffectMask) {
384
+ effectMethods += `
385
+ vec4 fx_${
386
+ fx.key as string
387
+ }_onEffectMask(float shaderMask, vec4 maskColor, vec4 shaderColor${pm}) {
388
+ ${onEffectMask}
389
+ }
390
+ `;
391
+ }
392
+ });
393
+
394
+ let sharedMethods = '';
395
+ for (const m in methods) {
396
+ sharedMethods += methods[m];
397
+ }
398
+
399
+ //fill main functions
400
+ let currentMask = `mix(shaderColor, maskColor, clamp(-(lng_DefaultMask), 0.0, 1.0))`;
401
+ let drawEffects = `
402
+
403
+ `;
404
+ for (let i = 0; i < effects.length; i++) {
405
+ const current = effects[i]!;
406
+ const pm =
407
+ current.passParameters.length > 0 ? `, ${current.passParameters}` : '';
408
+ const currentClass = effectContructors[current.name as keyof EffectMap]!;
409
+
410
+ if (currentClass.onShaderMask) {
411
+ drawEffects += `
412
+ shaderMask = fx_${current.target}_onShaderMask(shaderMask ${pm});
413
+ `;
414
+ }
415
+ if (currentClass.onColorize) {
416
+ drawEffects += `
417
+ maskColor = fx_${current.target}_onColorize(shaderMask, maskColor, shaderColor${pm});
418
+ `;
419
+ }
420
+ if (currentClass.onEffectMask) {
421
+ currentMask = `fx_${current.target}_onEffectMask(shaderMask, maskColor, shaderColor${pm})`;
422
+ }
423
+
424
+ const next = effects[i + 1]!;
425
+ if (
426
+ next === undefined ||
427
+ effectContructors[next.name as keyof EffectMap]!.onEffectMask
428
+ ) {
429
+ drawEffects += `
430
+ shaderColor = ${currentMask};
431
+ `;
432
+ }
433
+ }
434
+
435
+ return {
436
+ effects,
437
+ uniforms,
438
+ fragment: DynamicShader.fragment(
439
+ declareUniforms,
440
+ sharedMethods,
441
+ effectMethods,
442
+ drawEffects,
443
+ ),
444
+ vertex: DynamicShader.vertex(),
445
+ };
446
+ }
447
+
448
+ static resolveMethodDuplicate(
449
+ key: string,
450
+ effectMethod: string,
451
+ methodCollection: Record<string, string>,
452
+ increment = 0,
453
+ ): string {
454
+ const m = key + (increment > 0 ? (increment as unknown as string) : '');
455
+ if (methodCollection[m] && methodCollection[m] !== effectMethod) {
456
+ return this.resolveMethodDuplicate(
457
+ key,
458
+ effectMethod,
459
+ methodCollection,
460
+ ++increment,
461
+ );
462
+ }
463
+ return m;
464
+ }
465
+
466
+ static override resolveDefaults(
467
+ props: DynamicShaderProps,
468
+ effectContructors?: Partial<EffectMap>,
469
+ ): Required<DynamicShaderProps> {
470
+ assertTruthy(effectContructors);
471
+ return {
472
+ effects: getResolvedEffect(
473
+ props.effects ?? [],
474
+ effectContructors,
475
+ ) as EffectDescUnion[],
476
+ $dimensions: {
477
+ width: 0,
478
+ height: 0,
479
+ },
480
+ $alpha: 0,
481
+ };
482
+ }
483
+
484
+ static override makeCacheKey(
485
+ props: DynamicShaderProps,
486
+ effectContructors?: Partial<EffectMap>,
487
+ ): string {
488
+ let fx = '';
489
+ props.effects?.forEach((effect) => {
490
+ const baseClass = effectContructors![effect.type]!;
491
+ const key = baseClass.getEffectKey(effect.props || {});
492
+ fx += `,${key}`;
493
+ });
494
+ return `DynamicShader${fx}`;
495
+ }
496
+
497
+ static z$__type__Props: DynamicShaderProps;
498
+
499
+ static vertex = () => `
500
+ # ifdef GL_FRAGMENT_PRECISION_HIGH
501
+ precision highp float;
502
+ # else
503
+ precision mediump float;
504
+ # endif
505
+
506
+ attribute vec2 a_textureCoordinate;
507
+ attribute vec2 a_position;
508
+ attribute vec4 a_color;
509
+ attribute float a_textureIndex;
510
+
511
+ uniform vec2 u_resolution;
512
+ uniform float u_pixelRatio;
513
+
514
+ varying vec4 v_color;
515
+ varying vec2 v_textureCoordinate;
516
+ varying float v_textureIndex;
517
+
518
+ void main(){
519
+ vec2 normalized = a_position * u_pixelRatio / u_resolution;
520
+ vec2 zero_two = normalized * 2.0;
521
+ vec2 clip_space = zero_two - 1.0;
522
+
523
+ // pass to fragment
524
+ v_color = a_color;
525
+ v_textureCoordinate = a_textureCoordinate;
526
+ v_textureIndex = a_textureIndex;
527
+
528
+ // flip y
529
+ gl_Position = vec4(clip_space * vec2(1.0, -1.0), 0, 1);
530
+ }
531
+ `;
532
+
533
+ static fragment = (
534
+ uniforms: string,
535
+ methods: string,
536
+ effectMethods: string,
537
+ drawEffects: string,
538
+ ) => `
539
+ # ifdef GL_FRAGMENT_PRECISION_HIGH
540
+ precision highp float;
541
+ # else
542
+ precision mediump float;
543
+ # endif
544
+
545
+ #define PI 3.14159265359
546
+
547
+ uniform vec2 u_resolution;
548
+ uniform vec2 u_dimensions;
549
+ uniform float u_alpha;
550
+ uniform float u_radius;
551
+ uniform sampler2D u_texture;
552
+ uniform float u_pixelRatio;
553
+
554
+ ${uniforms}
555
+
556
+ varying vec4 v_color;
557
+ varying vec2 v_textureCoordinate;
558
+
559
+ ${methods}
560
+
561
+ ${effectMethods}
562
+
563
+ void main() {
564
+ vec2 p = v_textureCoordinate.xy * u_dimensions - u_dimensions * 0.5;
565
+ vec2 d = abs(p) - (u_dimensions) * 0.5;
566
+ float lng_DefaultMask = min(max(d.x, d.y), 0.0) + length(max(d, 0.0));
567
+
568
+ vec4 shaderColor = vec4(0.0);
569
+ float shaderMask = lng_DefaultMask;
570
+
571
+ vec4 maskColor = texture2D(u_texture, v_textureCoordinate) * v_color;
572
+
573
+ shaderColor = mix(shaderColor, maskColor, clamp(-(lng_DefaultMask + 0.5), 0.0, 1.0));
574
+
575
+ ${drawEffects}
576
+
577
+ gl_FragColor = shaderColor * u_alpha;
578
+ }
579
+ `;
580
+ }