@lightningjs/renderer 2.9.0 → 2.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (224) 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.js +1 -1
  6. package/dist/src/core/CoreNode.js.map +1 -1
  7. package/dist/src/core/lib/utils.d.ts +1 -0
  8. package/dist/src/core/lib/utils.js +3 -0
  9. package/dist/src/core/lib/utils.js.map +1 -1
  10. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js +6 -3
  11. package/dist/src/core/renderers/canvas/CanvasCoreRenderer.js.map +1 -1
  12. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  13. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  14. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  15. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  16. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  17. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  18. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  19. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  20. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  21. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  22. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  23. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  24. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  25. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  26. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  27. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  28. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  29. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  30. package/dist/src/core/text-rendering/font-face-types/WebTrFontFace.js +7 -3
  31. package/dist/src/core/text-rendering/font-face-types/WebTrFontFace.js.map +1 -1
  32. package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.js +7 -0
  33. package/dist/src/core/text-rendering/renderers/LightningTextTextureRenderer.js.map +1 -1
  34. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.js +5 -1
  35. package/dist/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.js.map +1 -1
  36. package/dist/src/core/textures/ImageTexture.js +5 -4
  37. package/dist/src/core/textures/ImageTexture.js.map +1 -1
  38. package/dist/src/core/textures/SubTexture.d.ts +1 -0
  39. package/dist/src/core/textures/SubTexture.js +7 -0
  40. package/dist/src/core/textures/SubTexture.js.map +1 -1
  41. package/dist/src/core/textures/Texture.d.ts +9 -0
  42. package/dist/src/core/textures/Texture.js +23 -13
  43. package/dist/src/core/textures/Texture.js.map +1 -1
  44. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  45. package/exports/canvas.ts +39 -39
  46. package/exports/index.ts +89 -89
  47. package/exports/inspector.ts +24 -24
  48. package/exports/utils.ts +44 -44
  49. package/exports/webgl.ts +38 -38
  50. package/package.json +1 -1
  51. package/scripts/please-use-pnpm.js +13 -13
  52. package/src/common/CommonTypes.ts +139 -139
  53. package/src/common/EventEmitter.ts +77 -77
  54. package/src/common/IAnimationController.ts +92 -92
  55. package/src/common/IEventEmitter.ts +28 -28
  56. package/src/core/CoreNode.test.ts +199 -199
  57. package/src/core/CoreNode.ts +2335 -2335
  58. package/src/core/CoreShaderManager.ts +292 -292
  59. package/src/core/CoreTextNode.ts +455 -455
  60. package/src/core/CoreTextureManager.ts +548 -548
  61. package/src/core/Stage.ts +700 -700
  62. package/src/core/TextureMemoryManager.ts +277 -277
  63. package/src/core/animations/AnimationManager.ts +38 -38
  64. package/src/core/animations/CoreAnimation.ts +340 -340
  65. package/src/core/animations/CoreAnimationController.ts +157 -157
  66. package/src/core/lib/ContextSpy.ts +41 -41
  67. package/src/core/lib/ImageWorker.ts +270 -270
  68. package/src/core/lib/Matrix3d.ts +244 -244
  69. package/src/core/lib/RenderCoords.ts +86 -86
  70. package/src/core/lib/WebGlContextWrapper.ts +1322 -1322
  71. package/src/core/lib/textureCompression.ts +152 -152
  72. package/src/core/lib/textureSvg.ts +78 -78
  73. package/src/core/lib/utils.ts +310 -306
  74. package/src/core/platform.ts +61 -61
  75. package/src/core/renderers/CoreContextTexture.ts +43 -43
  76. package/src/core/renderers/CoreRenderOp.ts +22 -22
  77. package/src/core/renderers/CoreRenderer.ts +114 -114
  78. package/src/core/renderers/CoreShader.ts +41 -41
  79. package/src/core/renderers/canvas/CanvasCoreRenderer.ts +369 -364
  80. package/src/core/renderers/canvas/CanvasCoreTexture.ts +150 -150
  81. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +231 -231
  82. package/src/core/renderers/canvas/internal/ColorUtils.ts +69 -69
  83. package/src/core/renderers/canvas/shaders/UnsupportedShader.ts +48 -48
  84. package/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.ts +79 -79
  85. package/src/core/renderers/webgl/WebGlCoreCtxSubTexture.ts +50 -50
  86. package/src/core/renderers/webgl/WebGlCoreCtxTexture.ts +298 -298
  87. package/src/core/renderers/webgl/WebGlCoreRenderOp.ts +125 -125
  88. package/src/core/renderers/webgl/WebGlCoreRenderer.ts +805 -805
  89. package/src/core/renderers/webgl/WebGlCoreShader.ts +362 -362
  90. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  91. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  92. package/src/core/renderers/webgl/internal/ShaderUtils.ts +143 -143
  93. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  94. package/src/core/renderers/webgl/shaders/DefaultShader.ts +93 -93
  95. package/src/core/renderers/webgl/shaders/DefaultShaderBatched.ts +132 -132
  96. package/src/core/renderers/webgl/shaders/DynamicShader.ts +580 -580
  97. package/src/core/renderers/webgl/shaders/RoundedRectangle.ts +167 -167
  98. package/src/core/renderers/webgl/shaders/SdfShader.ts +204 -204
  99. package/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.ts +101 -101
  100. package/src/core/renderers/webgl/shaders/effects/BorderEffect.ts +87 -87
  101. package/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.ts +101 -101
  102. package/src/core/renderers/webgl/shaders/effects/BorderRightEffect.ts +101 -101
  103. package/src/core/renderers/webgl/shaders/effects/BorderTopEffect.ts +101 -101
  104. package/src/core/renderers/webgl/shaders/effects/EffectUtils.ts +159 -159
  105. package/src/core/renderers/webgl/shaders/effects/FadeOutEffect.ts +127 -127
  106. package/src/core/renderers/webgl/shaders/effects/GlitchEffect.ts +148 -148
  107. package/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts +67 -67
  108. package/src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts +157 -157
  109. package/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts +171 -171
  110. package/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts +168 -168
  111. package/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.ts +187 -187
  112. package/src/core/renderers/webgl/shaders/effects/RadiusEffect.ts +110 -110
  113. package/src/core/renderers/webgl/shaders/effects/ShaderEffect.ts +196 -196
  114. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  115. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  116. package/src/core/text-rendering/TrFontManager.ts +183 -183
  117. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  118. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  119. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  120. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  121. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  122. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -89
  123. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +509 -509
  124. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +808 -798
  125. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +853 -853
  126. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  127. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  128. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  129. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  130. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  131. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  132. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  133. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +408 -403
  134. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  135. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  136. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  137. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  138. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  139. package/src/core/text-rendering/renderers/TextRenderer.ts +557 -557
  140. package/src/core/textures/ColorTexture.ts +102 -102
  141. package/src/core/textures/ImageTexture.ts +379 -378
  142. package/src/core/textures/NoiseTexture.ts +104 -104
  143. package/src/core/textures/RenderTexture.ts +85 -85
  144. package/src/core/textures/SubTexture.ts +179 -171
  145. package/src/core/textures/Texture.ts +435 -423
  146. package/src/core/utils.ts +227 -227
  147. package/src/env.d.ts +7 -7
  148. package/src/main-api/DynamicShaderController.ts +104 -104
  149. package/src/main-api/INode.ts +101 -101
  150. package/src/main-api/Inspector.ts +505 -505
  151. package/src/main-api/Renderer.ts +693 -693
  152. package/src/main-api/ShaderController.ts +80 -80
  153. package/src/main-api/utils.ts +45 -45
  154. package/src/utils.ts +248 -248
  155. package/dist/exports/core-api.d.ts +0 -74
  156. package/dist/exports/core-api.js +0 -96
  157. package/dist/exports/core-api.js.map +0 -1
  158. package/dist/exports/main-api.d.ts +0 -30
  159. package/dist/exports/main-api.js +0 -45
  160. package/dist/exports/main-api.js.map +0 -1
  161. package/dist/src/core/CoreExtension.d.ts +0 -12
  162. package/dist/src/core/CoreExtension.js +0 -29
  163. package/dist/src/core/CoreExtension.js.map +0 -1
  164. package/dist/src/main-api/ICoreDriver.d.ts +0 -24
  165. package/dist/src/main-api/ICoreDriver.js +0 -20
  166. package/dist/src/main-api/ICoreDriver.js.map +0 -1
  167. package/dist/src/main-api/RendererMain.d.ts +0 -378
  168. package/dist/src/main-api/RendererMain.js +0 -367
  169. package/dist/src/main-api/RendererMain.js.map +0 -1
  170. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +0 -9
  171. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +0 -38
  172. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +0 -1
  173. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +0 -56
  174. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +0 -101
  175. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +0 -1
  176. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +0 -32
  177. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +0 -28
  178. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +0 -1
  179. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +0 -21
  180. package/dist/src/render-drivers/main/MainCoreDriver.js +0 -115
  181. package/dist/src/render-drivers/main/MainCoreDriver.js.map +0 -1
  182. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +0 -101
  183. package/dist/src/render-drivers/main/MainOnlyNode.js +0 -425
  184. package/dist/src/render-drivers/main/MainOnlyNode.js.map +0 -1
  185. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +0 -47
  186. package/dist/src/render-drivers/main/MainOnlyTextNode.js +0 -204
  187. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +0 -1
  188. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +0 -93
  189. package/dist/src/render-drivers/threadx/NodeStruct.js +0 -290
  190. package/dist/src/render-drivers/threadx/NodeStruct.js.map +0 -1
  191. package/dist/src/render-drivers/threadx/SharedNode.d.ts +0 -40
  192. package/dist/src/render-drivers/threadx/SharedNode.js +0 -61
  193. package/dist/src/render-drivers/threadx/SharedNode.js.map +0 -1
  194. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +0 -44
  195. package/dist/src/render-drivers/threadx/TextNodeStruct.js +0 -203
  196. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +0 -1
  197. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +0 -25
  198. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +0 -232
  199. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +0 -1
  200. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +0 -24
  201. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +0 -113
  202. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +0 -1
  203. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +0 -46
  204. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +0 -160
  205. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +0 -1
  206. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +0 -28
  207. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +0 -55
  208. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +0 -1
  209. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +0 -70
  210. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +0 -32
  211. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +0 -1
  212. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +0 -19
  213. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +0 -184
  214. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +0 -1
  215. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +0 -27
  216. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +0 -109
  217. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +0 -1
  218. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +0 -1
  219. package/dist/src/render-drivers/threadx/worker/renderer.js +0 -147
  220. package/dist/src/render-drivers/threadx/worker/renderer.js.map +0 -1
  221. package/dist/src/render-drivers/utils.d.ts +0 -12
  222. package/dist/src/render-drivers/utils.js +0 -74
  223. package/dist/src/render-drivers/utils.js.map +0 -1
  224. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -1,152 +1,152 @@
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 TextureData } from '../textures/Texture.js';
21
-
22
- /**
23
- * Tests if the given location is a compressed texture container
24
- * @param url
25
- * @remarks
26
- * This function is used to determine if the given image url is a compressed
27
- * and only supports the following extensions: .ktx and .pvr
28
- * @returns
29
- */
30
- export function isCompressedTextureContainer(url: string): boolean {
31
- return /\.(ktx|pvr)$/.test(url);
32
- }
33
-
34
- /**
35
- * Loads a compressed texture container
36
- * @param url
37
- * @returns
38
- */
39
- export const loadCompressedTexture = async (
40
- url: string,
41
- ): Promise<TextureData> => {
42
- const response = await fetch(url);
43
- const arrayBuffer = await response.arrayBuffer();
44
-
45
- if (url.indexOf('.ktx') !== -1) {
46
- return loadKTXData(arrayBuffer);
47
- }
48
-
49
- return loadPVRData(arrayBuffer);
50
- };
51
-
52
- /**
53
- * Loads a KTX texture container and returns the texture data
54
- * @param buffer
55
- * @returns
56
- */
57
- const loadKTXData = async (buffer: ArrayBuffer): Promise<TextureData> => {
58
- const view = new DataView(buffer);
59
- const littleEndian = view.getUint32(12) === 16909060 ? true : false;
60
- const mipmaps = [];
61
-
62
- const data = {
63
- glInternalFormat: view.getUint32(28, littleEndian),
64
- pixelWidth: view.getUint32(36, littleEndian),
65
- pixelHeight: view.getUint32(40, littleEndian),
66
- numberOfMipmapLevels: view.getUint32(56, littleEndian),
67
- bytesOfKeyValueData: view.getUint32(60, littleEndian),
68
- };
69
-
70
- let offset = 64;
71
-
72
- // Key Value Pairs of data start at byte offset 64
73
- // But the only known kvp is the API version, so skipping parsing.
74
- offset += data.bytesOfKeyValueData;
75
-
76
- for (let i = 0; i < data.numberOfMipmapLevels; i++) {
77
- const imageSize = view.getUint32(offset);
78
- offset += 4;
79
-
80
- mipmaps.push(view.buffer.slice(offset, imageSize));
81
- offset += imageSize;
82
- }
83
-
84
- return {
85
- data: {
86
- glInternalFormat: data.glInternalFormat,
87
- mipmaps,
88
- width: data.pixelWidth || 0,
89
- height: data.pixelHeight || 0,
90
- type: 'ktx',
91
- },
92
- premultiplyAlpha: false,
93
- };
94
- };
95
-
96
- /**
97
- * Loads a PVR texture container and returns the texture data
98
- * @param buffer
99
- * @returns
100
- */
101
- const loadPVRData = async (buffer: ArrayBuffer): Promise<TextureData> => {
102
- // pvr header length in 32 bits
103
- const pvrHeaderLength = 13;
104
- // for now only we only support: COMPRESSED_RGB_ETC1_WEBGL
105
- const pvrFormatEtc1 = 0x8d64;
106
- const pvrWidth = 7;
107
- const pvrHeight = 6;
108
- const pvrMipmapCount = 11;
109
- const pvrMetadata = 12;
110
- const arrayBuffer = buffer;
111
- const header = new Int32Array(arrayBuffer, 0, pvrHeaderLength);
112
-
113
- // @ts-expect-error Object possibly undefined
114
- // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
115
- const dataOffset = header[pvrMetadata] + 52;
116
- const pvrtcData = new Uint8Array(arrayBuffer, dataOffset);
117
- const mipmaps = [];
118
- const data = {
119
- pixelWidth: header[pvrWidth],
120
- pixelHeight: header[pvrHeight],
121
- numberOfMipmapLevels: header[pvrMipmapCount] || 0,
122
- };
123
-
124
- let offset = 0;
125
- let width = data.pixelWidth || 0;
126
- let height = data.pixelHeight || 0;
127
-
128
- for (let i = 0; i < data.numberOfMipmapLevels; i++) {
129
- const level = ((width + 3) >> 2) * ((height + 3) >> 2) * 8;
130
- const view = new Uint8Array(
131
- arrayBuffer,
132
- pvrtcData.byteOffset + offset,
133
- level,
134
- );
135
-
136
- mipmaps.push(view);
137
- offset += level;
138
- width = width >> 1;
139
- height = height >> 1;
140
- }
141
-
142
- return {
143
- data: {
144
- glInternalFormat: pvrFormatEtc1,
145
- mipmaps: mipmaps,
146
- width: data.pixelWidth || 0,
147
- height: data.pixelHeight || 0,
148
- type: 'pvr',
149
- },
150
- premultiplyAlpha: false,
151
- };
152
- };
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 TextureData } from '../textures/Texture.js';
21
+
22
+ /**
23
+ * Tests if the given location is a compressed texture container
24
+ * @param url
25
+ * @remarks
26
+ * This function is used to determine if the given image url is a compressed
27
+ * and only supports the following extensions: .ktx and .pvr
28
+ * @returns
29
+ */
30
+ export function isCompressedTextureContainer(url: string): boolean {
31
+ return /\.(ktx|pvr)$/.test(url);
32
+ }
33
+
34
+ /**
35
+ * Loads a compressed texture container
36
+ * @param url
37
+ * @returns
38
+ */
39
+ export const loadCompressedTexture = async (
40
+ url: string,
41
+ ): Promise<TextureData> => {
42
+ const response = await fetch(url);
43
+ const arrayBuffer = await response.arrayBuffer();
44
+
45
+ if (url.indexOf('.ktx') !== -1) {
46
+ return loadKTXData(arrayBuffer);
47
+ }
48
+
49
+ return loadPVRData(arrayBuffer);
50
+ };
51
+
52
+ /**
53
+ * Loads a KTX texture container and returns the texture data
54
+ * @param buffer
55
+ * @returns
56
+ */
57
+ const loadKTXData = async (buffer: ArrayBuffer): Promise<TextureData> => {
58
+ const view = new DataView(buffer);
59
+ const littleEndian = view.getUint32(12) === 16909060 ? true : false;
60
+ const mipmaps = [];
61
+
62
+ const data = {
63
+ glInternalFormat: view.getUint32(28, littleEndian),
64
+ pixelWidth: view.getUint32(36, littleEndian),
65
+ pixelHeight: view.getUint32(40, littleEndian),
66
+ numberOfMipmapLevels: view.getUint32(56, littleEndian),
67
+ bytesOfKeyValueData: view.getUint32(60, littleEndian),
68
+ };
69
+
70
+ let offset = 64;
71
+
72
+ // Key Value Pairs of data start at byte offset 64
73
+ // But the only known kvp is the API version, so skipping parsing.
74
+ offset += data.bytesOfKeyValueData;
75
+
76
+ for (let i = 0; i < data.numberOfMipmapLevels; i++) {
77
+ const imageSize = view.getUint32(offset);
78
+ offset += 4;
79
+
80
+ mipmaps.push(view.buffer.slice(offset, imageSize));
81
+ offset += imageSize;
82
+ }
83
+
84
+ return {
85
+ data: {
86
+ glInternalFormat: data.glInternalFormat,
87
+ mipmaps,
88
+ width: data.pixelWidth || 0,
89
+ height: data.pixelHeight || 0,
90
+ type: 'ktx',
91
+ },
92
+ premultiplyAlpha: false,
93
+ };
94
+ };
95
+
96
+ /**
97
+ * Loads a PVR texture container and returns the texture data
98
+ * @param buffer
99
+ * @returns
100
+ */
101
+ const loadPVRData = async (buffer: ArrayBuffer): Promise<TextureData> => {
102
+ // pvr header length in 32 bits
103
+ const pvrHeaderLength = 13;
104
+ // for now only we only support: COMPRESSED_RGB_ETC1_WEBGL
105
+ const pvrFormatEtc1 = 0x8d64;
106
+ const pvrWidth = 7;
107
+ const pvrHeight = 6;
108
+ const pvrMipmapCount = 11;
109
+ const pvrMetadata = 12;
110
+ const arrayBuffer = buffer;
111
+ const header = new Int32Array(arrayBuffer, 0, pvrHeaderLength);
112
+
113
+ // @ts-expect-error Object possibly undefined
114
+ // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
115
+ const dataOffset = header[pvrMetadata] + 52;
116
+ const pvrtcData = new Uint8Array(arrayBuffer, dataOffset);
117
+ const mipmaps = [];
118
+ const data = {
119
+ pixelWidth: header[pvrWidth],
120
+ pixelHeight: header[pvrHeight],
121
+ numberOfMipmapLevels: header[pvrMipmapCount] || 0,
122
+ };
123
+
124
+ let offset = 0;
125
+ let width = data.pixelWidth || 0;
126
+ let height = data.pixelHeight || 0;
127
+
128
+ for (let i = 0; i < data.numberOfMipmapLevels; i++) {
129
+ const level = ((width + 3) >> 2) * ((height + 3) >> 2) * 8;
130
+ const view = new Uint8Array(
131
+ arrayBuffer,
132
+ pvrtcData.byteOffset + offset,
133
+ level,
134
+ );
135
+
136
+ mipmaps.push(view);
137
+ offset += level;
138
+ width = width >> 1;
139
+ height = height >> 1;
140
+ }
141
+
142
+ return {
143
+ data: {
144
+ glInternalFormat: pvrFormatEtc1,
145
+ mipmaps: mipmaps,
146
+ width: data.pixelWidth || 0,
147
+ height: data.pixelHeight || 0,
148
+ type: 'pvr',
149
+ },
150
+ premultiplyAlpha: false,
151
+ };
152
+ };
@@ -1,78 +1,78 @@
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 { assertTruthy } from '../../utils.js';
21
- import { type TextureData } from '../textures/Texture.js';
22
-
23
- /**
24
- * Tests if the given location is a SVG
25
- * @param url
26
- * @remarks
27
- * This function is used to determine if the given image url is a SVG
28
- * image
29
- * @returns
30
- */
31
- export function isSvgImage(url: string): boolean {
32
- return /\.(svg)$/.test(url);
33
- }
34
-
35
- /**
36
- * Loads a SVG image
37
- * @param url
38
- * @returns
39
- */
40
- export const loadSvg = (
41
- url: string,
42
- width: number | null,
43
- height: number | null,
44
- sx: number | null,
45
- sy: number | null,
46
- sw: number | null,
47
- sh: number | null,
48
- ): Promise<TextureData> => {
49
- return new Promise((resolve, reject) => {
50
- const canvas = document.createElement('canvas');
51
- const ctx = canvas.getContext('2d');
52
- assertTruthy(ctx);
53
-
54
- ctx.imageSmoothingEnabled = true;
55
- const img = new Image();
56
- img.onload = () => {
57
- const x = sx ?? 0;
58
- const y = sy ?? 0;
59
- const w = width || img.width;
60
- const h = height || img.height;
61
-
62
- canvas.width = w;
63
- canvas.height = h;
64
- ctx.drawImage(img, 0, 0, w, h);
65
-
66
- resolve({
67
- data: ctx.getImageData(x, y, sw ?? w, sh ?? h),
68
- premultiplyAlpha: false,
69
- });
70
- };
71
-
72
- img.onerror = (err) => {
73
- reject(err);
74
- };
75
-
76
- img.src = url;
77
- });
78
- };
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 { assertTruthy } from '../../utils.js';
21
+ import { type TextureData } from '../textures/Texture.js';
22
+
23
+ /**
24
+ * Tests if the given location is a SVG
25
+ * @param url
26
+ * @remarks
27
+ * This function is used to determine if the given image url is a SVG
28
+ * image
29
+ * @returns
30
+ */
31
+ export function isSvgImage(url: string): boolean {
32
+ return /\.(svg)$/.test(url);
33
+ }
34
+
35
+ /**
36
+ * Loads a SVG image
37
+ * @param url
38
+ * @returns
39
+ */
40
+ export const loadSvg = (
41
+ url: string,
42
+ width: number | null,
43
+ height: number | null,
44
+ sx: number | null,
45
+ sy: number | null,
46
+ sw: number | null,
47
+ sh: number | null,
48
+ ): Promise<TextureData> => {
49
+ return new Promise((resolve, reject) => {
50
+ const canvas = document.createElement('canvas');
51
+ const ctx = canvas.getContext('2d');
52
+ assertTruthy(ctx);
53
+
54
+ ctx.imageSmoothingEnabled = true;
55
+ const img = new Image();
56
+ img.onload = () => {
57
+ const x = sx ?? 0;
58
+ const y = sy ?? 0;
59
+ const w = width || img.width;
60
+ const h = height || img.height;
61
+
62
+ canvas.width = w;
63
+ canvas.height = h;
64
+ ctx.drawImage(img, 0, 0, w, h);
65
+
66
+ resolve({
67
+ data: ctx.getImageData(x, y, sw ?? w, sh ?? h),
68
+ premultiplyAlpha: false,
69
+ });
70
+ };
71
+
72
+ img.onerror = (err) => {
73
+ reject(err);
74
+ };
75
+
76
+ img.src = url;
77
+ });
78
+ };