@lightningjs/renderer 2.13.0 → 2.13.1

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 (213) 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/lib/ImageWorker.js +2 -1
  14. package/dist/src/core/lib/ImageWorker.js.map +1 -1
  15. package/dist/src/core/lib/utils.d.ts +4 -0
  16. package/dist/src/core/lib/utils.js +46 -0
  17. package/dist/src/core/lib/utils.js.map +1 -1
  18. package/dist/src/core/renderers/webgl/shaders/DefaultShader.js +45 -45
  19. package/dist/src/core/renderers/webgl/shaders/DefaultShaderBatched.js +61 -61
  20. package/dist/src/core/renderers/webgl/shaders/DynamicShader.js +93 -93
  21. package/dist/src/core/renderers/webgl/shaders/RoundedRectangle.js +63 -63
  22. package/dist/src/core/renderers/webgl/shaders/SdfShader.js +62 -62
  23. package/dist/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.js +15 -15
  24. package/dist/src/core/renderers/webgl/shaders/effects/BorderEffect.js +6 -6
  25. package/dist/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.js +15 -15
  26. package/dist/src/core/renderers/webgl/shaders/effects/BorderRightEffect.js +15 -15
  27. package/dist/src/core/renderers/webgl/shaders/effects/BorderTopEffect.js +15 -15
  28. package/dist/src/core/renderers/webgl/shaders/effects/FadeOutEffect.js +42 -42
  29. package/dist/src/core/renderers/webgl/shaders/effects/GlitchEffect.js +44 -44
  30. package/dist/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.js +3 -3
  31. package/dist/src/core/renderers/webgl/shaders/effects/HolePunchEffect.js +22 -22
  32. package/dist/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.js +28 -28
  33. package/dist/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.js +10 -10
  34. package/dist/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.js +37 -37
  35. package/dist/src/core/renderers/webgl/shaders/effects/RadiusEffect.js +19 -19
  36. package/dist/src/core/textures/ImageTexture.d.ts +2 -2
  37. package/dist/src/core/textures/ImageTexture.js +24 -4
  38. package/dist/src/core/textures/ImageTexture.js.map +1 -1
  39. package/dist/src/main-api/ICoreDriver.d.ts +24 -0
  40. package/dist/src/main-api/ICoreDriver.js +20 -0
  41. package/dist/src/main-api/ICoreDriver.js.map +1 -0
  42. package/dist/src/main-api/RendererMain.d.ts +378 -0
  43. package/dist/src/main-api/RendererMain.js +367 -0
  44. package/dist/src/main-api/RendererMain.js.map +1 -0
  45. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.d.ts +9 -0
  46. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js +38 -0
  47. package/dist/src/main-api/texture-usage-trackers/FinalizationRegistryTextureUsageTracker.js.map +1 -0
  48. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.d.ts +56 -0
  49. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js +101 -0
  50. package/dist/src/main-api/texture-usage-trackers/ManualCountTextureUsageTracker.js.map +1 -0
  51. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.d.ts +32 -0
  52. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js +28 -0
  53. package/dist/src/main-api/texture-usage-trackers/TextureUsageTracker.js.map +1 -0
  54. package/dist/src/render-drivers/main/MainCoreDriver.d.ts +21 -0
  55. package/dist/src/render-drivers/main/MainCoreDriver.js +115 -0
  56. package/dist/src/render-drivers/main/MainCoreDriver.js.map +1 -0
  57. package/dist/src/render-drivers/main/MainOnlyNode.d.ts +101 -0
  58. package/dist/src/render-drivers/main/MainOnlyNode.js +425 -0
  59. package/dist/src/render-drivers/main/MainOnlyNode.js.map +1 -0
  60. package/dist/src/render-drivers/main/MainOnlyTextNode.d.ts +47 -0
  61. package/dist/src/render-drivers/main/MainOnlyTextNode.js +204 -0
  62. package/dist/src/render-drivers/main/MainOnlyTextNode.js.map +1 -0
  63. package/dist/src/render-drivers/threadx/NodeStruct.d.ts +93 -0
  64. package/dist/src/render-drivers/threadx/NodeStruct.js +290 -0
  65. package/dist/src/render-drivers/threadx/NodeStruct.js.map +1 -0
  66. package/dist/src/render-drivers/threadx/SharedNode.d.ts +40 -0
  67. package/dist/src/render-drivers/threadx/SharedNode.js +61 -0
  68. package/dist/src/render-drivers/threadx/SharedNode.js.map +1 -0
  69. package/dist/src/render-drivers/threadx/TextNodeStruct.d.ts +44 -0
  70. package/dist/src/render-drivers/threadx/TextNodeStruct.js +203 -0
  71. package/dist/src/render-drivers/threadx/TextNodeStruct.js.map +1 -0
  72. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.d.ts +25 -0
  73. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js +232 -0
  74. package/dist/src/render-drivers/threadx/ThreadXCoreDriver.js.map +1 -0
  75. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.d.ts +24 -0
  76. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js +113 -0
  77. package/dist/src/render-drivers/threadx/ThreadXMainAnimationController.js.map +1 -0
  78. package/dist/src/render-drivers/threadx/ThreadXMainNode.d.ts +46 -0
  79. package/dist/src/render-drivers/threadx/ThreadXMainNode.js +160 -0
  80. package/dist/src/render-drivers/threadx/ThreadXMainNode.js.map +1 -0
  81. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.d.ts +28 -0
  82. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js +55 -0
  83. package/dist/src/render-drivers/threadx/ThreadXMainTextNode.js.map +1 -0
  84. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.d.ts +70 -0
  85. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js +32 -0
  86. package/dist/src/render-drivers/threadx/ThreadXRendererMessage.js.map +1 -0
  87. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts +19 -0
  88. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js +184 -0
  89. package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map +1 -0
  90. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts +27 -0
  91. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js +109 -0
  92. package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map +1 -0
  93. package/dist/src/render-drivers/threadx/worker/renderer.d.ts +1 -0
  94. package/dist/src/render-drivers/threadx/worker/renderer.js +147 -0
  95. package/dist/src/render-drivers/threadx/worker/renderer.js.map +1 -0
  96. package/dist/src/render-drivers/utils.d.ts +12 -0
  97. package/dist/src/render-drivers/utils.js +74 -0
  98. package/dist/src/render-drivers/utils.js.map +1 -0
  99. package/dist/tsconfig.dist.tsbuildinfo +1 -1
  100. package/dist/tsconfig.tsbuildinfo +1 -0
  101. package/exports/canvas.ts +39 -39
  102. package/exports/index.ts +89 -89
  103. package/exports/inspector.ts +24 -24
  104. package/exports/utils.ts +44 -44
  105. package/exports/webgl.ts +38 -38
  106. package/package.json +2 -1
  107. package/scripts/please-use-pnpm.js +13 -13
  108. package/src/common/CommonTypes.ts +146 -146
  109. package/src/common/EventEmitter.ts +77 -77
  110. package/src/common/IAnimationController.ts +92 -92
  111. package/src/common/IEventEmitter.ts +28 -28
  112. package/src/core/CoreNode.test.ts +202 -202
  113. package/src/core/CoreNode.ts +2455 -2455
  114. package/src/core/CoreShaderManager.ts +292 -292
  115. package/src/core/CoreTextNode.ts +455 -455
  116. package/src/core/CoreTextureManager.ts +597 -597
  117. package/src/core/Stage.ts +743 -743
  118. package/src/core/TextureMemoryManager.ts +395 -395
  119. package/src/core/animations/AnimationManager.ts +38 -38
  120. package/src/core/animations/CoreAnimation.ts +340 -340
  121. package/src/core/animations/CoreAnimationController.ts +157 -157
  122. package/src/core/lib/ContextSpy.ts +41 -41
  123. package/src/core/lib/ImageWorker.ts +280 -279
  124. package/src/core/lib/Matrix3d.ts +244 -244
  125. package/src/core/lib/RenderCoords.ts +86 -86
  126. package/src/core/lib/WebGlContextWrapper.ts +1332 -1332
  127. package/src/core/lib/textureCompression.ts +152 -152
  128. package/src/core/lib/textureSvg.ts +78 -78
  129. package/src/core/lib/utils.ts +384 -310
  130. package/src/core/lib/validateImageBitmap.ts +76 -76
  131. package/src/core/platform.ts +63 -63
  132. package/src/core/renderers/CoreContextTexture.ts +43 -43
  133. package/src/core/renderers/CoreRenderOp.ts +22 -22
  134. package/src/core/renderers/CoreRenderer.ts +115 -115
  135. package/src/core/renderers/CoreShader.ts +41 -41
  136. package/src/core/renderers/canvas/CanvasCoreRenderer.ts +375 -375
  137. package/src/core/renderers/canvas/CanvasCoreTexture.ts +153 -153
  138. package/src/core/renderers/canvas/internal/C2DShaderUtils.ts +231 -231
  139. package/src/core/renderers/canvas/internal/ColorUtils.ts +69 -69
  140. package/src/core/renderers/canvas/shaders/UnsupportedShader.ts +48 -48
  141. package/src/core/renderers/webgl/WebGlCoreCtxRenderTexture.ts +86 -86
  142. package/src/core/renderers/webgl/WebGlCoreCtxSubTexture.ts +50 -50
  143. package/src/core/renderers/webgl/WebGlCoreCtxTexture.ts +301 -301
  144. package/src/core/renderers/webgl/WebGlCoreRenderOp.ts +125 -125
  145. package/src/core/renderers/webgl/WebGlCoreRenderer.ts +815 -815
  146. package/src/core/renderers/webgl/WebGlCoreShader.ts +362 -362
  147. package/src/core/renderers/webgl/internal/BufferCollection.ts +54 -54
  148. package/src/core/renderers/webgl/internal/RendererUtils.ts +155 -155
  149. package/src/core/renderers/webgl/internal/ShaderUtils.ts +143 -143
  150. package/src/core/renderers/webgl/internal/WebGlUtils.ts +35 -35
  151. package/src/core/renderers/webgl/shaders/DefaultShader.ts +93 -93
  152. package/src/core/renderers/webgl/shaders/DefaultShaderBatched.ts +132 -132
  153. package/src/core/renderers/webgl/shaders/DynamicShader.ts +580 -580
  154. package/src/core/renderers/webgl/shaders/RoundedRectangle.ts +167 -167
  155. package/src/core/renderers/webgl/shaders/SdfShader.ts +204 -204
  156. package/src/core/renderers/webgl/shaders/effects/BorderBottomEffect.ts +101 -101
  157. package/src/core/renderers/webgl/shaders/effects/BorderEffect.ts +87 -87
  158. package/src/core/renderers/webgl/shaders/effects/BorderLeftEffect.ts +101 -101
  159. package/src/core/renderers/webgl/shaders/effects/BorderRightEffect.ts +101 -101
  160. package/src/core/renderers/webgl/shaders/effects/BorderTopEffect.ts +101 -101
  161. package/src/core/renderers/webgl/shaders/effects/EffectUtils.ts +159 -159
  162. package/src/core/renderers/webgl/shaders/effects/FadeOutEffect.ts +127 -127
  163. package/src/core/renderers/webgl/shaders/effects/GlitchEffect.ts +148 -148
  164. package/src/core/renderers/webgl/shaders/effects/GrayscaleEffect.ts +67 -67
  165. package/src/core/renderers/webgl/shaders/effects/HolePunchEffect.ts +157 -157
  166. package/src/core/renderers/webgl/shaders/effects/LinearGradientEffect.ts +171 -171
  167. package/src/core/renderers/webgl/shaders/effects/RadialGradientEffect.ts +168 -168
  168. package/src/core/renderers/webgl/shaders/effects/RadialProgressEffect.ts +187 -187
  169. package/src/core/renderers/webgl/shaders/effects/RadiusEffect.ts +110 -110
  170. package/src/core/renderers/webgl/shaders/effects/ShaderEffect.ts +196 -196
  171. package/src/core/text-rendering/TextRenderingUtils.ts +36 -36
  172. package/src/core/text-rendering/TextTextureRendererUtils.ts +263 -263
  173. package/src/core/text-rendering/TrFontManager.ts +183 -183
  174. package/src/core/text-rendering/font-face-types/SdfTrFontFace/SdfTrFontFace.ts +176 -176
  175. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/FontShaper.ts +139 -139
  176. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.test.ts +173 -173
  177. package/src/core/text-rendering/font-face-types/SdfTrFontFace/internal/SdfFontShaper.ts +171 -171
  178. package/src/core/text-rendering/font-face-types/TrFontFace.ts +187 -187
  179. package/src/core/text-rendering/font-face-types/WebTrFontFace.ts +94 -94
  180. package/src/core/text-rendering/font-face-types/utils.ts +39 -39
  181. package/src/core/text-rendering/renderers/CanvasTextRenderer.ts +509 -509
  182. package/src/core/text-rendering/renderers/LightningTextTextureRenderer.ts +808 -808
  183. package/src/core/text-rendering/renderers/SdfTextRenderer/SdfTextRenderer.ts +853 -853
  184. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.test.ts +48 -48
  185. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/PeekableGenerator.ts +66 -66
  186. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/SpecialCodepoints.ts +52 -52
  187. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/constants.ts +32 -32
  188. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getStartConditions.ts +117 -117
  189. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.test.ts +133 -133
  190. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/getUnicodeCodepoints.ts +38 -38
  191. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/layoutText.ts +408 -408
  192. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.test.ts +49 -49
  193. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/measureText.ts +52 -52
  194. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.test.ts +205 -205
  195. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/setRenderWindow.ts +93 -93
  196. package/src/core/text-rendering/renderers/SdfTextRenderer/internal/util.ts +40 -40
  197. package/src/core/text-rendering/renderers/TextRenderer.ts +557 -557
  198. package/src/core/textures/ColorTexture.ts +102 -102
  199. package/src/core/textures/ImageTexture.ts +399 -376
  200. package/src/core/textures/NoiseTexture.ts +104 -104
  201. package/src/core/textures/RenderTexture.ts +85 -85
  202. package/src/core/textures/SubTexture.ts +205 -205
  203. package/src/core/textures/Texture.ts +337 -337
  204. package/src/core/utils.ts +227 -227
  205. package/src/env.d.ts +7 -7
  206. package/src/main-api/DynamicShaderController.ts +104 -104
  207. package/src/main-api/INode.ts +101 -101
  208. package/src/main-api/Inspector.ts +522 -522
  209. package/src/main-api/Renderer.ts +751 -751
  210. package/src/main-api/ShaderController.ts +80 -80
  211. package/src/main-api/utils.ts +45 -45
  212. package/src/utils.ts +248 -248
  213. package/COPYING +0 -1
@@ -1,279 +1,280 @@
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 { CreateImageBitmapSupport } from '../lib/validateImageBitmap.js';
21
- import { type TextureData } from '../textures/Texture.js';
22
-
23
- type MessageCallback = [(value: any) => void, (reason: any) => void];
24
- interface getImageReturn {
25
- data: ImageBitmap;
26
- premultiplyAlpha: boolean | null;
27
- }
28
-
29
- interface ImageWorkerMessage {
30
- id: number;
31
- src: string;
32
- data: getImageReturn;
33
- error: string;
34
- sx: number | null;
35
- sy: number | null;
36
- sw: number | null;
37
- sh: number | null;
38
- }
39
-
40
- /**
41
- * Note that, within the createImageWorker function, we must only use ES5 code to keep it ES5-valid after babelifying, as
42
- * the converted code of this section is converted to a blob and used as the js of the web worker thread.
43
- *
44
- * The createImageWorker function is a web worker that fetches an image from a URL and returns an ImageBitmap object.
45
- * The eslint @typescript rule is disabled for the entire function because the function is converted to a blob and used as the
46
- * js of the web worker thread, so the typescript syntax is not valid in this context.
47
- */
48
-
49
- /* eslint-disable */
50
- function createImageWorker() {
51
- function hasAlphaChannel(mimeType: string) {
52
- return mimeType.indexOf('image/png') !== -1;
53
- }
54
-
55
- function getImage(
56
- src: string,
57
- premultiplyAlpha: boolean | null,
58
- x: number | null,
59
- y: number | null,
60
- width: number | null,
61
- height: number | null,
62
- options: {
63
- supportsOptionsCreateImageBitmap: boolean;
64
- supportsFullCreateImageBitmap: boolean;
65
- },
66
- ): Promise<getImageReturn> {
67
- return new Promise(function (resolve, reject) {
68
- var supportsOptionsCreateImageBitmap =
69
- options.supportsOptionsCreateImageBitmap;
70
- var supportsFullCreateImageBitmap = options.supportsFullCreateImageBitmap;
71
- var xhr = new XMLHttpRequest();
72
- xhr.open('GET', src, true);
73
- xhr.responseType = 'blob';
74
-
75
- xhr.onload = function () {
76
- // On most devices like WebOS and Tizen, the file protocol returns 0 while http(s) protocol returns 200
77
- if (xhr.status !== 200 && xhr.status !== 0) {
78
- return reject(new Error('Failed to load image: ' + xhr.statusText));
79
- }
80
-
81
- var blob = xhr.response;
82
- var withAlphaChannel =
83
- premultiplyAlpha !== undefined
84
- ? premultiplyAlpha
85
- : hasAlphaChannel(blob.type);
86
-
87
- // createImageBitmap with crop and options
88
- if (
89
- supportsFullCreateImageBitmap === true &&
90
- width !== null &&
91
- height !== null
92
- ) {
93
- createImageBitmap(blob, x || 0, y || 0, width, height, {
94
- premultiplyAlpha: withAlphaChannel ? 'premultiply' : 'none',
95
- colorSpaceConversion: 'none',
96
- imageOrientation: 'none',
97
- })
98
- .then(function (data) {
99
- resolve({ data, premultiplyAlpha: premultiplyAlpha });
100
- })
101
- .catch(function (error) {
102
- reject(error);
103
- });
104
- return;
105
- } else if (
106
- supportsOptionsCreateImageBitmap === false &&
107
- supportsOptionsCreateImageBitmap === false
108
- ) {
109
- // Fallback for browsers that do not support createImageBitmap with options
110
- // this is supported for Chrome v50 to v52/54 that doesn't support options
111
- createImageBitmap(blob)
112
- .then(function (data) {
113
- resolve({ data, premultiplyAlpha: premultiplyAlpha });
114
- })
115
- .catch(function (error) {
116
- reject(error);
117
- });
118
- } else {
119
- createImageBitmap(blob, {
120
- premultiplyAlpha: withAlphaChannel ? 'premultiply' : 'none',
121
- colorSpaceConversion: 'none',
122
- imageOrientation: 'none',
123
- })
124
- .then(function (data) {
125
- resolve({ data, premultiplyAlpha: premultiplyAlpha });
126
- })
127
- .catch(function (error) {
128
- reject(error);
129
- });
130
- }
131
- };
132
-
133
- xhr.onerror = function () {
134
- reject(
135
- new Error('Network error occurred while trying to fetch the image.'),
136
- );
137
- };
138
-
139
- xhr.send();
140
- });
141
- }
142
-
143
- self.onmessage = (event) => {
144
- var src = event.data.src;
145
- var id = event.data.id;
146
- var premultiplyAlpha = event.data.premultiplyAlpha;
147
- var x = event.data.sx;
148
- var y = event.data.sy;
149
- var width = event.data.sw;
150
- var height = event.data.sh;
151
-
152
- // these will be set to true if the browser supports the createImageBitmap options or full
153
- var supportsOptionsCreateImageBitmap = false;
154
- var supportsFullCreateImageBitmap = false;
155
-
156
- getImage(src, premultiplyAlpha, x, y, width, height, {
157
- supportsOptionsCreateImageBitmap,
158
- supportsFullCreateImageBitmap,
159
- })
160
- .then(function (data) {
161
- self.postMessage({ id: id, src: src, data: data });
162
- })
163
- .catch(function (error) {
164
- self.postMessage({ id: id, src: src, error: error.message });
165
- });
166
- };
167
- }
168
- /* eslint-enable */
169
-
170
- export class ImageWorkerManager {
171
- imageWorkersEnabled = true;
172
- messageManager: Record<number, MessageCallback> = {};
173
- workers: Worker[] = [];
174
- workerIndex = 0;
175
- nextId = 0;
176
-
177
- constructor(
178
- numImageWorkers: number,
179
- createImageBitmapSupport: CreateImageBitmapSupport,
180
- ) {
181
- this.workers = this.createWorkers(
182
- numImageWorkers,
183
- createImageBitmapSupport,
184
- );
185
- this.workers.forEach((worker) => {
186
- worker.onmessage = this.handleMessage.bind(this);
187
- });
188
- }
189
-
190
- private handleMessage(event: MessageEvent) {
191
- const { id, data, error } = event.data as ImageWorkerMessage;
192
- const msg = this.messageManager[id];
193
- if (msg) {
194
- const [resolve, reject] = msg;
195
- delete this.messageManager[id];
196
- if (error) {
197
- reject(new Error(error));
198
- } else {
199
- resolve(data);
200
- }
201
- }
202
- }
203
-
204
- private createWorkers(
205
- numWorkers = 1,
206
- createImageBitmapSupport: CreateImageBitmapSupport,
207
- ): Worker[] {
208
- let workerCode = `(${createImageWorker.toString()})()`;
209
-
210
- // Replace placeholders with actual initialization values
211
- if (createImageBitmapSupport.options === true) {
212
- workerCode = workerCode.replace(
213
- 'var supportsOptionsCreateImageBitmap = false;',
214
- 'var supportsOptionsCreateImageBitmap = true;',
215
- );
216
- }
217
-
218
- if (createImageBitmapSupport.full === true) {
219
- workerCode = workerCode.replace(
220
- 'var supportsOptionsCreateImageBitmap = false;',
221
- 'var supportsOptionsCreateImageBitmap = true;',
222
- );
223
-
224
- workerCode = workerCode.replace(
225
- 'var supportsFullCreateImageBitmap = false;',
226
- 'var supportsFullCreateImageBitmap = true;',
227
- );
228
- }
229
-
230
- workerCode = workerCode.replace('"use strict";', '');
231
- const blob: Blob = new Blob([workerCode], {
232
- type: 'application/javascript',
233
- });
234
- const blobURL: string = (self.URL ? URL : webkitURL).createObjectURL(blob);
235
- const workers: Worker[] = [];
236
- for (let i = 0; i < numWorkers; i++) {
237
- workers.push(new Worker(blobURL));
238
- }
239
- return workers;
240
- }
241
-
242
- private getNextWorker(): Worker | undefined {
243
- const worker = this.workers[this.workerIndex];
244
- this.workerIndex = (this.workerIndex + 1) % this.workers.length;
245
- return worker;
246
- }
247
-
248
- getImage(
249
- src: string,
250
- premultiplyAlpha: boolean | null,
251
- sx: number | null,
252
- sy: number | null,
253
- sw: number | null,
254
- sh: number | null,
255
- ): Promise<TextureData> {
256
- return new Promise((resolve, reject) => {
257
- try {
258
- if (this.workers) {
259
- const id = this.nextId++;
260
- this.messageManager[id] = [resolve, reject];
261
- const nextWorker = this.getNextWorker();
262
- if (nextWorker) {
263
- nextWorker.postMessage({
264
- id,
265
- src: src,
266
- premultiplyAlpha,
267
- sx,
268
- sy,
269
- sw,
270
- sh,
271
- });
272
- }
273
- }
274
- } catch (error) {
275
- reject(error);
276
- }
277
- });
278
- }
279
- }
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 { CreateImageBitmapSupport } from '../lib/validateImageBitmap.js';
21
+ import { type TextureData } from '../textures/Texture.js';
22
+
23
+ type MessageCallback = [(value: any) => void, (reason: any) => void];
24
+ interface getImageReturn {
25
+ data: ImageBitmap;
26
+ premultiplyAlpha: boolean | null;
27
+ }
28
+
29
+ interface ImageWorkerMessage {
30
+ id: number;
31
+ src: string;
32
+ data: getImageReturn;
33
+ error: string;
34
+ sx: number | null;
35
+ sy: number | null;
36
+ sw: number | null;
37
+ sh: number | null;
38
+ }
39
+
40
+ /**
41
+ * Note that, within the createImageWorker function, we must only use ES5 code to keep it ES5-valid after babelifying, as
42
+ * the converted code of this section is converted to a blob and used as the js of the web worker thread.
43
+ *
44
+ * The createImageWorker function is a web worker that fetches an image from a URL and returns an ImageBitmap object.
45
+ * The eslint @typescript rule is disabled for the entire function because the function is converted to a blob and used as the
46
+ * js of the web worker thread, so the typescript syntax is not valid in this context.
47
+ */
48
+
49
+ /* eslint-disable */
50
+ function createImageWorker() {
51
+ function hasAlphaChannel(mimeType: string) {
52
+ return mimeType.indexOf('image/png') !== -1;
53
+ }
54
+
55
+ function getImage(
56
+ src: string,
57
+ premultiplyAlpha: boolean | null,
58
+ x: number | null,
59
+ y: number | null,
60
+ width: number | null,
61
+ height: number | null,
62
+ options: {
63
+ supportsOptionsCreateImageBitmap: boolean;
64
+ supportsFullCreateImageBitmap: boolean;
65
+ },
66
+ ): Promise<getImageReturn> {
67
+ return new Promise(function (resolve, reject) {
68
+ var supportsOptionsCreateImageBitmap =
69
+ options.supportsOptionsCreateImageBitmap;
70
+ var supportsFullCreateImageBitmap = options.supportsFullCreateImageBitmap;
71
+ var xhr = new XMLHttpRequest();
72
+ xhr.open('GET', src, true);
73
+ xhr.responseType = 'blob';
74
+
75
+ xhr.onload = function () {
76
+ // On most devices like WebOS and Tizen, the file protocol returns 0 while http(s) protocol returns 200
77
+ if (xhr.status !== 200 && xhr.status !== 0) {
78
+ return reject(new Error('Failed to load image: ' + xhr.statusText));
79
+ }
80
+
81
+ var blob = xhr.response;
82
+ var withAlphaChannel =
83
+ premultiplyAlpha !== undefined
84
+ ? premultiplyAlpha
85
+ : hasAlphaChannel(blob.type);
86
+
87
+ // createImageBitmap with crop and options
88
+ if (
89
+ supportsFullCreateImageBitmap === true &&
90
+ width !== null &&
91
+ height !== null
92
+ ) {
93
+ createImageBitmap(blob, x || 0, y || 0, width, height, {
94
+ premultiplyAlpha: withAlphaChannel ? 'premultiply' : 'none',
95
+ colorSpaceConversion: 'none',
96
+ imageOrientation: 'none',
97
+ })
98
+ .then(function (data) {
99
+ resolve({ data, premultiplyAlpha: premultiplyAlpha });
100
+ })
101
+ .catch(function (error) {
102
+ reject(error);
103
+ });
104
+ return;
105
+ } else if (
106
+ supportsOptionsCreateImageBitmap === false &&
107
+ supportsOptionsCreateImageBitmap === false
108
+ ) {
109
+ // Fallback for browsers that do not support createImageBitmap with options
110
+ // this is supported for Chrome v50 to v52/54 that doesn't support options
111
+ createImageBitmap(blob)
112
+ .then(function (data) {
113
+ resolve({ data, premultiplyAlpha: premultiplyAlpha });
114
+ })
115
+ .catch(function (error) {
116
+ reject(error);
117
+ });
118
+ } else {
119
+ createImageBitmap(blob, {
120
+ premultiplyAlpha: withAlphaChannel ? 'premultiply' : 'none',
121
+ colorSpaceConversion: 'none',
122
+ imageOrientation: 'none',
123
+ })
124
+ .then(function (data) {
125
+ resolve({ data, premultiplyAlpha: premultiplyAlpha });
126
+ })
127
+ .catch(function (error) {
128
+ reject(error);
129
+ });
130
+ }
131
+ };
132
+
133
+ xhr.onerror = function () {
134
+ reject(
135
+ new Error('Network error occurred while trying to fetch the image.'),
136
+ );
137
+ };
138
+
139
+ xhr.send();
140
+ });
141
+ }
142
+
143
+ self.onmessage = (event) => {
144
+ var src = event.data.src;
145
+ var id = event.data.id;
146
+ var premultiplyAlpha = event.data.premultiplyAlpha;
147
+ var x = event.data.sx;
148
+ var y = event.data.sy;
149
+ var width = event.data.sw;
150
+ var height = event.data.sh;
151
+
152
+ // these will be set to true if the browser supports the createImageBitmap options or full
153
+ var supportsOptionsCreateImageBitmap = false;
154
+ var supportsFullCreateImageBitmap = false;
155
+
156
+ getImage(src, premultiplyAlpha, x, y, width, height, {
157
+ supportsOptionsCreateImageBitmap,
158
+ supportsFullCreateImageBitmap,
159
+ })
160
+ .then(function (data) {
161
+ // @ts-ignore ts has wrong postMessage signature
162
+ self.postMessage({ id: id, src: src, data: data }, [data.data]);
163
+ })
164
+ .catch(function (error) {
165
+ self.postMessage({ id: id, src: src, error: error.message });
166
+ });
167
+ };
168
+ }
169
+ /* eslint-enable */
170
+
171
+ export class ImageWorkerManager {
172
+ imageWorkersEnabled = true;
173
+ messageManager: Record<number, MessageCallback> = {};
174
+ workers: Worker[] = [];
175
+ workerIndex = 0;
176
+ nextId = 0;
177
+
178
+ constructor(
179
+ numImageWorkers: number,
180
+ createImageBitmapSupport: CreateImageBitmapSupport,
181
+ ) {
182
+ this.workers = this.createWorkers(
183
+ numImageWorkers,
184
+ createImageBitmapSupport,
185
+ );
186
+ this.workers.forEach((worker) => {
187
+ worker.onmessage = this.handleMessage.bind(this);
188
+ });
189
+ }
190
+
191
+ private handleMessage(event: MessageEvent) {
192
+ const { id, data, error } = event.data as ImageWorkerMessage;
193
+ const msg = this.messageManager[id];
194
+ if (msg) {
195
+ const [resolve, reject] = msg;
196
+ delete this.messageManager[id];
197
+ if (error) {
198
+ reject(new Error(error));
199
+ } else {
200
+ resolve(data);
201
+ }
202
+ }
203
+ }
204
+
205
+ private createWorkers(
206
+ numWorkers = 1,
207
+ createImageBitmapSupport: CreateImageBitmapSupport,
208
+ ): Worker[] {
209
+ let workerCode = `(${createImageWorker.toString()})()`;
210
+
211
+ // Replace placeholders with actual initialization values
212
+ if (createImageBitmapSupport.options === true) {
213
+ workerCode = workerCode.replace(
214
+ 'var supportsOptionsCreateImageBitmap = false;',
215
+ 'var supportsOptionsCreateImageBitmap = true;',
216
+ );
217
+ }
218
+
219
+ if (createImageBitmapSupport.full === true) {
220
+ workerCode = workerCode.replace(
221
+ 'var supportsOptionsCreateImageBitmap = false;',
222
+ 'var supportsOptionsCreateImageBitmap = true;',
223
+ );
224
+
225
+ workerCode = workerCode.replace(
226
+ 'var supportsFullCreateImageBitmap = false;',
227
+ 'var supportsFullCreateImageBitmap = true;',
228
+ );
229
+ }
230
+
231
+ workerCode = workerCode.replace('"use strict";', '');
232
+ const blob: Blob = new Blob([workerCode], {
233
+ type: 'application/javascript',
234
+ });
235
+ const blobURL: string = (self.URL ? URL : webkitURL).createObjectURL(blob);
236
+ const workers: Worker[] = [];
237
+ for (let i = 0; i < numWorkers; i++) {
238
+ workers.push(new Worker(blobURL));
239
+ }
240
+ return workers;
241
+ }
242
+
243
+ private getNextWorker(): Worker | undefined {
244
+ const worker = this.workers[this.workerIndex];
245
+ this.workerIndex = (this.workerIndex + 1) % this.workers.length;
246
+ return worker;
247
+ }
248
+
249
+ getImage(
250
+ src: string,
251
+ premultiplyAlpha: boolean | null,
252
+ sx: number | null,
253
+ sy: number | null,
254
+ sw: number | null,
255
+ sh: number | null,
256
+ ): Promise<TextureData> {
257
+ return new Promise((resolve, reject) => {
258
+ try {
259
+ if (this.workers) {
260
+ const id = this.nextId++;
261
+ this.messageManager[id] = [resolve, reject];
262
+ const nextWorker = this.getNextWorker();
263
+ if (nextWorker) {
264
+ nextWorker.postMessage({
265
+ id,
266
+ src: src,
267
+ premultiplyAlpha,
268
+ sx,
269
+ sy,
270
+ sw,
271
+ sh,
272
+ });
273
+ }
274
+ }
275
+ } catch (error) {
276
+ reject(error);
277
+ }
278
+ });
279
+ }
280
+ }