@lightningjs/renderer 2.9.0-beta1 → 2.9.0-beta3

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 (265) hide show
  1. package/COPYING +1 -0
  2. package/LICENSE +202 -202
  3. package/NOTICE +3 -3
  4. package/README.md +147 -147
  5. package/dist/src/core/CoreNode.d.ts +2 -1
  6. package/dist/src/core/CoreNode.js +54 -43
  7. package/dist/src/core/CoreNode.js.map +1 -1
  8. package/dist/src/core/CoreTextureManager.d.ts +61 -15
  9. package/dist/src/core/CoreTextureManager.js +179 -104
  10. package/dist/src/core/CoreTextureManager.js.map +1 -1
  11. package/dist/src/core/Stage.d.ts +7 -0
  12. package/dist/src/core/Stage.js +33 -1
  13. package/dist/src/core/Stage.js.map +1 -1
  14. package/dist/src/core/TextureMemoryManager.js +2 -5
  15. package/dist/src/core/TextureMemoryManager.js.map +1 -1
  16. package/dist/src/core/lib/ImageWorker.js +31 -28
  17. package/dist/src/core/lib/ImageWorker.js.map +1 -1
  18. package/dist/src/core/lib/WebGlContextWrapper.d.ts +1 -0
  19. package/dist/src/core/lib/WebGlContextWrapper.js +2 -0
  20. package/dist/src/core/lib/WebGlContextWrapper.js.map +1 -1
  21. package/dist/src/core/renderers/CoreContextTexture.d.ts +1 -0
  22. package/dist/src/core/renderers/CoreContextTexture.js +1 -0
  23. package/dist/src/core/renderers/CoreContextTexture.js.map +1 -1
  24. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.d.ts +1 -1
  25. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js +20 -7
  26. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js.map +1 -1
  27. package/dist/src/core/renderers/canvas/CanvasCoreTexture.d.ts +3 -3
  28. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js +8 -10
  29. package/dist/src/core/renderers/canvas/CanvasCoreTexture.js.map +1 -1
  30. package/dist/src/core/renderers/webgl/WebGlCoreCtxSubTexture.js +3 -1
  31. package/dist/src/core/renderers/webgl/WebGlCoreCtxSubTexture.js.map +1 -1
  32. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.d.ts +1 -2
  33. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js +36 -35
  34. package/dist/src/core/renderers/webgl/WebGlCoreCtxTexture.js.map +1 -1
  35. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.d.ts +0 -1
  36. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.js +7 -17
  37. package/dist/src/core/renderers/webgl/WebGlCoreRenderer.js.map +1 -1
  38. package/dist/src/core/renderers/webgl/internal/RendererUtils.js +5 -3
  39. package/dist/src/core/renderers/webgl/internal/RendererUtils.js.map +1 -1
  40. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  41. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  42. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  43. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  44. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  45. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  46. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  47. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  48. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  49. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  50. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  51. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  52. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  53. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  54. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  55. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  56. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  57. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  58. package/dist/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js +3 -5
  59. package/dist/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.js.map +1 -1
  60. package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js +3 -3
  61. package/dist/src/core/text-rendering/renderers/CanvasTextRenderer.js.map +1 -1
  62. package/dist/src/core/textures/ColorTexture.d.ts +1 -1
  63. package/dist/src/core/textures/ColorTexture.js +2 -1
  64. package/dist/src/core/textures/ColorTexture.js.map +1 -1
  65. package/dist/src/core/textures/ImageTexture.d.ts +8 -1
  66. package/dist/src/core/textures/ImageTexture.js +42 -1
  67. package/dist/src/core/textures/ImageTexture.js.map +1 -1
  68. package/dist/src/core/textures/NoiseTexture.d.ts +1 -1
  69. package/dist/src/core/textures/NoiseTexture.js +2 -1
  70. package/dist/src/core/textures/NoiseTexture.js.map +1 -1
  71. package/dist/src/core/textures/RenderTexture.d.ts +1 -1
  72. package/dist/src/core/textures/RenderTexture.js +2 -1
  73. package/dist/src/core/textures/RenderTexture.js.map +1 -1
  74. package/dist/src/core/textures/SubTexture.d.ts +1 -1
  75. package/dist/src/core/textures/SubTexture.js +21 -4
  76. package/dist/src/core/textures/SubTexture.js.map +1 -1
  77. package/dist/src/core/textures/Texture.d.ts +43 -21
  78. package/dist/src/core/textures/Texture.js +105 -33
  79. package/dist/src/core/textures/Texture.js.map +1 -1
  80. package/dist/src/main-api/Inspector.js +1 -1
  81. package/dist/src/main-api/Inspector.js.map +1 -1
  82. package/dist/src/main-api/Renderer.d.ts +18 -0
  83. package/dist/src/main-api/Renderer.js +6 -4
  84. package/dist/src/main-api/Renderer.js.map +1 -1
  85. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  86. package/exports/canvas.ts +39 -39
  87. package/exports/index.ts +89 -89
  88. package/exports/inspector.ts +24 -24
  89. package/exports/utils.ts +44 -44
  90. package/exports/webgl.ts +38 -38
  91. package/package.json +1 -1
  92. package/scripts/please-use-pnpm.js +13 -13
  93. package/src/common/CommonTypes.ts +139 -139
  94. package/src/common/EventEmitter.ts +77 -77
  95. package/src/common/IAnimationController.ts +92 -92
  96. package/src/common/IEventEmitter.ts +28 -28
  97. package/src/core/CoreNode.test.ts +95 -95
  98. package/src/core/CoreNode.ts +2282 -2258
  99. package/src/core/CoreShaderManager.ts +292 -292
  100. package/src/core/CoreTextNode.ts +450 -450
  101. package/src/core/CoreTextureManager.ts +522 -432
  102. package/src/core/Stage.ts +699 -652
  103. package/src/core/TextureMemoryManager.ts +277 -279
  104. package/src/core/animations/AnimationManager.ts +38 -38
  105. package/src/core/animations/CoreAnimation.ts +340 -340
  106. package/src/core/animations/CoreAnimationController.ts +157 -157
  107. package/src/core/lib/ContextSpy.ts +41 -41
  108. package/src/core/lib/ImageWorker.ts +270 -267
  109. package/src/core/lib/Matrix3d.ts +244 -244
  110. package/src/core/lib/RenderCoords.ts +86 -86
  111. package/src/core/lib/WebGlContextWrapper.ts +1322 -1320
  112. package/src/core/lib/textureCompression.ts +152 -152
  113. package/src/core/lib/textureSvg.ts +78 -78
  114. package/src/core/lib/utils.ts +306 -306
  115. package/src/core/platform.ts +61 -61
  116. package/src/core/renderers/CoreContextTexture.ts +43 -42
  117. package/src/core/renderers/CoreRenderOp.ts +22 -22
  118. package/src/core/renderers/CoreRenderer.ts +114 -114
  119. package/src/core/renderers/CoreShader.ts +41 -41
  120. package/src/core/renderers/canvas/CanvasCoreRenderer.ts +364 -349
  121. package/src/core/renderers/canvas/CanvasCoreTexture.ts +150 -143
  122. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +231 -231
  123. package/src/core/renderers/canvas/internal/ColorUtils.ts +69 -69
  124. package/src/core/renderers/canvas/shaders/UnsupportedShader.ts +48 -48
  125. package/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.ts +79 -79
  126. package/src/core/renderers/webgl/WebGlCoreCtxSubTexture.ts +50 -48
  127. package/src/core/renderers/webgl/WebGlCoreCtxTexture.ts +298 -297
  128. package/src/core/renderers/webgl/WebGlCoreRenderOp.ts +125 -125
  129. package/src/core/renderers/webgl/WebGlCoreRenderer.ts +805 -817
  130. package/src/core/renderers/webgl/WebGlCoreShader.ts +362 -362
  131. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  132. package/src/core/renderers/webgl/internal/RendererUtils.ts +5 -3
  133. package/src/core/renderers/webgl/internal/ShaderUtils.ts +143 -143
  134. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  135. package/src/core/renderers/webgl/shaders/DefaultShader.ts +93 -93
  136. package/src/core/renderers/webgl/shaders/DefaultShaderBatched.ts +132 -132
  137. package/src/core/renderers/webgl/shaders/DynamicShader.ts +580 -580
  138. package/src/core/renderers/webgl/shaders/RoundedRectangle.ts +167 -167
  139. package/src/core/renderers/webgl/shaders/SdfShader.ts +204 -204
  140. package/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.ts +101 -101
  141. package/src/core/renderers/webgl/shaders/effects/BorderEffect.ts +87 -87
  142. package/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.ts +101 -101
  143. package/src/core/renderers/webgl/shaders/effects/BorderRightEffect.ts +101 -101
  144. package/src/core/renderers/webgl/shaders/effects/BorderTopEffect.ts +101 -101
  145. package/src/core/renderers/webgl/shaders/effects/EffectUtils.ts +159 -159
  146. package/src/core/renderers/webgl/shaders/effects/FadeOutEffect.ts +127 -127
  147. package/src/core/renderers/webgl/shaders/effects/GlitchEffect.ts +148 -148
  148. package/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts +67 -67
  149. package/src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts +157 -157
  150. package/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts +171 -171
  151. package/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts +168 -168
  152. package/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.ts +187 -187
  153. package/src/core/renderers/webgl/shaders/effects/RadiusEffect.ts +110 -110
  154. package/src/core/renderers/webgl/shaders/effects/ShaderEffect.ts +196 -196
  155. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  156. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  157. package/src/core/text-rendering/TrFontManager.ts +183 -183
  158. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +169 -171
  159. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  160. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  161. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  162. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  163. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +89 -89
  164. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +509 -508
  165. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +798 -798
  166. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +853 -853
  167. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  168. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  169. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  170. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  171. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  172. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  173. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  174. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +403 -403
  175. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  176. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  177. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  178. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  179. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  180. package/src/core/text-rendering/renderers/TextRenderer.ts +557 -557
  181. package/src/core/textures/ColorTexture.ts +102 -100
  182. package/src/core/textures/ImageTexture.ts +378 -333
  183. package/src/core/textures/NoiseTexture.ts +104 -101
  184. package/src/core/textures/RenderTexture.ts +85 -83
  185. package/src/core/textures/SubTexture.ts +171 -146
  186. package/src/core/textures/Texture.ts +407 -318
  187. package/src/core/utils.ts +227 -227
  188. package/src/env.d.ts +7 -7
  189. package/src/main-api/DynamicShaderController.ts +104 -104
  190. package/src/main-api/INode.ts +101 -101
  191. package/src/main-api/Inspector.ts +505 -505
  192. package/src/main-api/Renderer.ts +693 -670
  193. package/src/main-api/ShaderController.ts +80 -80
  194. package/src/main-api/utils.ts +45 -45
  195. package/src/utils.ts +248 -248
  196. package/dist/exports/core-api.d.ts +0 -74
  197. package/dist/exports/core-api.js +0 -96
  198. package/dist/exports/core-api.js.map +0 -1
  199. package/dist/exports/main-api.d.ts +0 -30
  200. package/dist/exports/main-api.js +0 -45
  201. package/dist/exports/main-api.js.map +0 -1
  202. package/dist/src/core/CoreExtension.d.ts +0 -12
  203. package/dist/src/core/CoreExtension.js +0 -29
  204. package/dist/src/core/CoreExtension.js.map +0 -1
  205. package/dist/src/main-api/ICoreDriver.d.ts +0 -24
  206. package/dist/src/main-api/ICoreDriver.js +0 -20
  207. package/dist/src/main-api/ICoreDriver.js.map +0 -1
  208. package/dist/src/main-api/RendererMain.d.ts +0 -378
  209. package/dist/src/main-api/RendererMain.js +0 -367
  210. package/dist/src/main-api/RendererMain.js.map +0 -1
  211. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +0 -9
  212. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +0 -38
  213. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +0 -1
  214. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +0 -56
  215. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +0 -101
  216. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +0 -1
  217. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +0 -32
  218. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +0 -28
  219. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +0 -1
  220. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +0 -21
  221. package/dist/src/render-drivers/main/MainCoreDriver.js +0 -115
  222. package/dist/src/render-drivers/main/MainCoreDriver.js.map +0 -1
  223. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +0 -101
  224. package/dist/src/render-drivers/main/MainOnlyNode.js +0 -425
  225. package/dist/src/render-drivers/main/MainOnlyNode.js.map +0 -1
  226. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +0 -47
  227. package/dist/src/render-drivers/main/MainOnlyTextNode.js +0 -204
  228. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +0 -1
  229. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +0 -93
  230. package/dist/src/render-drivers/threadx/NodeStruct.js +0 -290
  231. package/dist/src/render-drivers/threadx/NodeStruct.js.map +0 -1
  232. package/dist/src/render-drivers/threadx/SharedNode.d.ts +0 -40
  233. package/dist/src/render-drivers/threadx/SharedNode.js +0 -61
  234. package/dist/src/render-drivers/threadx/SharedNode.js.map +0 -1
  235. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +0 -44
  236. package/dist/src/render-drivers/threadx/TextNodeStruct.js +0 -203
  237. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +0 -1
  238. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +0 -25
  239. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +0 -232
  240. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +0 -1
  241. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +0 -24
  242. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +0 -113
  243. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +0 -1
  244. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +0 -46
  245. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +0 -160
  246. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +0 -1
  247. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +0 -28
  248. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +0 -55
  249. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +0 -1
  250. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +0 -70
  251. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +0 -32
  252. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +0 -1
  253. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +0 -19
  254. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +0 -184
  255. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +0 -1
  256. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +0 -27
  257. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +0 -109
  258. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +0 -1
  259. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +0 -1
  260. package/dist/src/render-drivers/threadx/worker/renderer.js +0 -147
  261. package/dist/src/render-drivers/threadx/worker/renderer.js.map +0 -1
  262. package/dist/src/render-drivers/utils.d.ts +0 -12
  263. package/dist/src/render-drivers/utils.js +0 -74
  264. package/dist/src/render-drivers/utils.js.map +0 -1
  265. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -1,101 +1,101 @@
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 2024 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 { IAnimationController } from '../common/IAnimationController.js';
20
- import {
21
- CoreNode,
22
- type CoreNodeAnimateProps,
23
- type CoreNodeProps,
24
- } from '../core/CoreNode.js';
25
- import type { CoreTextNode, CoreTextNodeProps } from '../core/CoreTextNode.js';
26
- import type { AnimationSettings } from '../core/animations/CoreAnimation.js';
27
- import type { BaseShaderController } from './ShaderController.js';
28
-
29
- /**
30
- * A visual Node in the Renderer scene graph.
31
- *
32
- * @remarks
33
- * A Node is a basic building block of the Renderer scene graph. It can be a
34
- * container for other Nodes, or it can be a leaf Node that renders a solid
35
- * color, gradient, image, or specific texture, using a specific shader.
36
- *
37
- * For text rendering Nodes, see {@link ITextNode}.
38
- *
39
- * ## INode vs CoreNode
40
- * CoreNode is the name of the class for a Renderer Node and is only directly
41
- * used internally by the Renderer. INode describes the public API of a
42
- * Renderer Node including the ability to be tied to a specific Shader.
43
- *
44
- * Users of the Renderer API, should generally interact with INode objects
45
- * instead of CoreNode objects.
46
- */
47
- export interface INode<SC extends BaseShaderController = BaseShaderController>
48
- extends Omit<CoreNode, 'shader' | 'animate' | 'parent'> {
49
- shader: SC;
50
- animate(
51
- props: Partial<INodeAnimateProps<SC>>,
52
- settings: Partial<AnimationSettings>,
53
- ): IAnimationController;
54
- parent: INode | null;
55
- }
56
-
57
- /**
58
- * Properties used to animate() a Node
59
- */
60
- export interface INodeAnimateProps<
61
- SC extends BaseShaderController = BaseShaderController,
62
- > extends Omit<CoreNodeAnimateProps, 'shaderProps'> {
63
- shaderProps: Partial<SC['props']>;
64
- }
65
-
66
- /**
67
- * Properties used to create a new Node
68
- */
69
- export interface INodeProps<
70
- SC extends BaseShaderController = BaseShaderController,
71
- > extends Omit<CoreNodeProps, 'shader' | 'parent'> {
72
- shader: SC;
73
- parent: INode | null;
74
- }
75
-
76
- /**
77
- * A visual Node in the Renderer scene graph that renders text.
78
- *
79
- * @remarks
80
- * A Text Node is a special type of Node that renders text using a specific
81
- * text renderer, such as Web/Canvas or Signed Distance Field (SDF) text.
82
- *
83
- * For non-text rendering, see {@link INode}.
84
- *
85
- * Users of the Renderer API, should generally interact with ITextNode objects
86
- * instead of CoreTextNode objects.
87
- */
88
- export interface ITextNode extends Omit<CoreTextNode, 'animate' | 'parent'> {
89
- animate(
90
- props: Partial<INodeAnimateProps<BaseShaderController>>,
91
- settings: Partial<AnimationSettings>,
92
- ): IAnimationController;
93
- parent: INode | null;
94
- }
95
-
96
- /**
97
- * Properties used to create a new Text Node
98
- */
99
- export interface ITextNodeProps extends Omit<CoreTextNodeProps, 'parent'> {
100
- parent: INode | null;
101
- }
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 2024 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 { IAnimationController } from '../common/IAnimationController.js';
20
+ import {
21
+ CoreNode,
22
+ type CoreNodeAnimateProps,
23
+ type CoreNodeProps,
24
+ } from '../core/CoreNode.js';
25
+ import type { CoreTextNode, CoreTextNodeProps } from '../core/CoreTextNode.js';
26
+ import type { AnimationSettings } from '../core/animations/CoreAnimation.js';
27
+ import type { BaseShaderController } from './ShaderController.js';
28
+
29
+ /**
30
+ * A visual Node in the Renderer scene graph.
31
+ *
32
+ * @remarks
33
+ * A Node is a basic building block of the Renderer scene graph. It can be a
34
+ * container for other Nodes, or it can be a leaf Node that renders a solid
35
+ * color, gradient, image, or specific texture, using a specific shader.
36
+ *
37
+ * For text rendering Nodes, see {@link ITextNode}.
38
+ *
39
+ * ## INode vs CoreNode
40
+ * CoreNode is the name of the class for a Renderer Node and is only directly
41
+ * used internally by the Renderer. INode describes the public API of a
42
+ * Renderer Node including the ability to be tied to a specific Shader.
43
+ *
44
+ * Users of the Renderer API, should generally interact with INode objects
45
+ * instead of CoreNode objects.
46
+ */
47
+ export interface INode<SC extends BaseShaderController = BaseShaderController>
48
+ extends Omit<CoreNode, 'shader' | 'animate' | 'parent'> {
49
+ shader: SC;
50
+ animate(
51
+ props: Partial<INodeAnimateProps<SC>>,
52
+ settings: Partial<AnimationSettings>,
53
+ ): IAnimationController;
54
+ parent: INode | null;
55
+ }
56
+
57
+ /**
58
+ * Properties used to animate() a Node
59
+ */
60
+ export interface INodeAnimateProps<
61
+ SC extends BaseShaderController = BaseShaderController,
62
+ > extends Omit<CoreNodeAnimateProps, 'shaderProps'> {
63
+ shaderProps: Partial<SC['props']>;
64
+ }
65
+
66
+ /**
67
+ * Properties used to create a new Node
68
+ */
69
+ export interface INodeProps<
70
+ SC extends BaseShaderController = BaseShaderController,
71
+ > extends Omit<CoreNodeProps, 'shader' | 'parent'> {
72
+ shader: SC;
73
+ parent: INode | null;
74
+ }
75
+
76
+ /**
77
+ * A visual Node in the Renderer scene graph that renders text.
78
+ *
79
+ * @remarks
80
+ * A Text Node is a special type of Node that renders text using a specific
81
+ * text renderer, such as Web/Canvas or Signed Distance Field (SDF) text.
82
+ *
83
+ * For non-text rendering, see {@link INode}.
84
+ *
85
+ * Users of the Renderer API, should generally interact with ITextNode objects
86
+ * instead of CoreTextNode objects.
87
+ */
88
+ export interface ITextNode extends Omit<CoreTextNode, 'animate' | 'parent'> {
89
+ animate(
90
+ props: Partial<INodeAnimateProps<BaseShaderController>>,
91
+ settings: Partial<AnimationSettings>,
92
+ ): IAnimationController;
93
+ parent: INode | null;
94
+ }
95
+
96
+ /**
97
+ * Properties used to create a new Text Node
98
+ */
99
+ export interface ITextNodeProps extends Omit<CoreTextNodeProps, 'parent'> {
100
+ parent: INode | null;
101
+ }