@babylonjs/smart-filters 1.0.13 → 8.18.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 (258) hide show
  1. package/dist/blockFoundation/aggregateBlock.d.ts +3 -3
  2. package/dist/blockFoundation/aggregateBlock.d.ts.map +1 -1
  3. package/dist/blockFoundation/aggregateBlock.js +1 -2
  4. package/dist/blockFoundation/aggregateBlock.js.map +1 -1
  5. package/dist/blockFoundation/baseBlock.d.ts +2 -2
  6. package/dist/blockFoundation/baseBlock.d.ts.map +1 -1
  7. package/dist/blockFoundation/baseBlock.js +5 -6
  8. package/dist/blockFoundation/baseBlock.js.map +1 -1
  9. package/dist/blockFoundation/customAggregateBlock.d.ts.map +1 -1
  10. package/dist/blockFoundation/customAggregateBlock.js +2 -2
  11. package/dist/blockFoundation/customAggregateBlock.js.map +1 -1
  12. package/dist/blockFoundation/customShaderBlock.d.ts.map +1 -1
  13. package/dist/blockFoundation/customShaderBlock.js +4 -6
  14. package/dist/blockFoundation/customShaderBlock.js.map +1 -1
  15. package/dist/blockFoundation/disableableShaderBlock.d.ts.map +1 -1
  16. package/dist/blockFoundation/disableableShaderBlock.js +4 -4
  17. package/dist/blockFoundation/disableableShaderBlock.js.map +1 -1
  18. package/dist/blockFoundation/index.js +0 -2
  19. package/dist/blockFoundation/index.js.map +1 -1
  20. package/dist/blockFoundation/inputBlock.d.ts +8 -8
  21. package/dist/blockFoundation/inputBlock.d.ts.map +1 -1
  22. package/dist/blockFoundation/inputBlock.deserializer.d.ts +1 -1
  23. package/dist/blockFoundation/inputBlock.deserializer.d.ts.map +1 -1
  24. package/dist/blockFoundation/inputBlock.deserializer.js +1 -1
  25. package/dist/blockFoundation/inputBlock.deserializer.js.map +1 -1
  26. package/dist/blockFoundation/inputBlock.js +7 -7
  27. package/dist/blockFoundation/inputBlock.js.map +1 -1
  28. package/dist/blockFoundation/inputBlock.serialization.types.d.ts.map +1 -1
  29. package/dist/blockFoundation/inputBlock.serializer.d.ts +1 -1
  30. package/dist/blockFoundation/inputBlock.serializer.js +26 -28
  31. package/dist/blockFoundation/inputBlock.serializer.js.map +1 -1
  32. package/dist/blockFoundation/outputBlock.d.ts +4 -9
  33. package/dist/blockFoundation/outputBlock.d.ts.map +1 -1
  34. package/dist/blockFoundation/outputBlock.js +13 -14
  35. package/dist/blockFoundation/outputBlock.js.map +1 -1
  36. package/dist/blockFoundation/shaderBlock.d.ts +4 -4
  37. package/dist/blockFoundation/shaderBlock.d.ts.map +1 -1
  38. package/dist/blockFoundation/shaderBlock.js +13 -19
  39. package/dist/blockFoundation/shaderBlock.js.map +1 -1
  40. package/dist/blockFoundation/textureOptions.d.ts +1 -1
  41. package/dist/blockFoundation/textureOptions.js +1 -1
  42. package/dist/command/command.d.ts +1 -1
  43. package/dist/command/command.js +1 -1
  44. package/dist/command/commandBuffer.d.ts +1 -1
  45. package/dist/command/commandBuffer.d.ts.map +1 -1
  46. package/dist/command/commandBuffer.js +2 -2
  47. package/dist/command/commandBufferDebugger.d.ts +2 -2
  48. package/dist/command/commandBufferDebugger.d.ts.map +1 -1
  49. package/dist/command/commandBufferDebugger.js +1 -1
  50. package/dist/command/commandBufferDebugger.js.map +1 -1
  51. package/dist/command/index.d.ts +3 -1
  52. package/dist/command/index.d.ts.map +1 -1
  53. package/dist/command/index.js +5 -1
  54. package/dist/command/index.js.map +1 -1
  55. package/dist/connection/connectionPoint.d.ts +3 -3
  56. package/dist/connection/connectionPoint.d.ts.map +1 -1
  57. package/dist/connection/connectionPoint.js +2 -2
  58. package/dist/connection/connectionPoint.js.map +1 -1
  59. package/dist/connection/connectionPointCompatibilityState.d.ts +1 -1
  60. package/dist/connection/connectionPointCompatibilityState.js +1 -1
  61. package/dist/connection/connectionPointType.d.ts +3 -3
  62. package/dist/connection/connectionPointType.d.ts.map +1 -1
  63. package/dist/connection/connectionPointWithDefault.d.ts +3 -3
  64. package/dist/connection/connectionPointWithDefault.d.ts.map +1 -1
  65. package/dist/connection/connectionPointWithDefault.js.map +1 -1
  66. package/dist/connection/index.d.ts +2 -1
  67. package/dist/connection/index.d.ts.map +1 -1
  68. package/dist/connection/index.js +3 -3
  69. package/dist/connection/index.js.map +1 -1
  70. package/dist/editorUtils/editableInPropertyPage.d.ts +2 -2
  71. package/dist/editorUtils/editableInPropertyPage.d.ts.map +1 -1
  72. package/dist/editorUtils/editableInPropertyPage.js +2 -2
  73. package/dist/editorUtils/editableInPropertyPage.js.map +1 -1
  74. package/dist/editorUtils/index.d.ts +1 -0
  75. package/dist/editorUtils/index.d.ts.map +1 -1
  76. package/dist/editorUtils/index.js +2 -0
  77. package/dist/editorUtils/index.js.map +1 -1
  78. package/dist/index.d.ts.map +1 -1
  79. package/dist/index.js +1 -1
  80. package/dist/index.js.map +1 -1
  81. package/dist/optimization/dependencyGraph.js.map +1 -1
  82. package/dist/optimization/optimizedShaderBlock.d.ts +4 -4
  83. package/dist/optimization/optimizedShaderBlock.d.ts.map +1 -1
  84. package/dist/optimization/optimizedShaderBlock.js.map +1 -1
  85. package/dist/optimization/smartFilterOptimizer.d.ts +2 -2
  86. package/dist/optimization/smartFilterOptimizer.d.ts.map +1 -1
  87. package/dist/optimization/smartFilterOptimizer.js +34 -57
  88. package/dist/optimization/smartFilterOptimizer.js.map +1 -1
  89. package/dist/runtime/index.d.ts +2 -1
  90. package/dist/runtime/index.d.ts.map +1 -1
  91. package/dist/runtime/index.js +3 -3
  92. package/dist/runtime/index.js.map +1 -1
  93. package/dist/runtime/renderTargetGenerator.d.ts +1 -1
  94. package/dist/runtime/renderTargetGenerator.d.ts.map +1 -1
  95. package/dist/runtime/renderTargetGenerator.js +5 -7
  96. package/dist/runtime/renderTargetGenerator.js.map +1 -1
  97. package/dist/runtime/shaderRuntime.d.ts +7 -7
  98. package/dist/runtime/shaderRuntime.d.ts.map +1 -1
  99. package/dist/runtime/shaderRuntime.js +7 -8
  100. package/dist/runtime/shaderRuntime.js.map +1 -1
  101. package/dist/runtime/smartFilterRuntime.d.ts +3 -3
  102. package/dist/runtime/smartFilterRuntime.d.ts.map +1 -1
  103. package/dist/runtime/smartFilterRuntime.js.map +1 -1
  104. package/dist/runtime/strongRef.d.ts +1 -1
  105. package/dist/runtime/strongRef.js +1 -1
  106. package/dist/serialization/importCustomBlockDefinition.d.ts +1 -1
  107. package/dist/serialization/importCustomBlockDefinition.js +8 -9
  108. package/dist/serialization/importCustomBlockDefinition.js.map +1 -1
  109. package/dist/serialization/index.d.ts +1 -0
  110. package/dist/serialization/index.d.ts.map +1 -1
  111. package/dist/serialization/index.js +3 -0
  112. package/dist/serialization/index.js.map +1 -1
  113. package/dist/serialization/serializedBlockDefinition.d.ts +2 -2
  114. package/dist/serialization/serializedBlockDefinition.d.ts.map +1 -1
  115. package/dist/serialization/serializedShaderBlockDefinition.d.ts +1 -1
  116. package/dist/serialization/serializedShaderBlockDefinition.d.ts.map +1 -1
  117. package/dist/serialization/serializedSmartFilter.d.ts +1 -1
  118. package/dist/serialization/serializedSmartFilter.d.ts.map +1 -1
  119. package/dist/serialization/smartFilterDeserializer.d.ts +6 -6
  120. package/dist/serialization/smartFilterDeserializer.d.ts.map +1 -1
  121. package/dist/serialization/smartFilterDeserializer.js +9 -12
  122. package/dist/serialization/smartFilterDeserializer.js.map +1 -1
  123. package/dist/serialization/smartFilterSerializer.d.ts +2 -2
  124. package/dist/serialization/smartFilterSerializer.d.ts.map +1 -1
  125. package/dist/serialization/smartFilterSerializer.js +10 -13
  126. package/dist/serialization/smartFilterSerializer.js.map +1 -1
  127. package/dist/serialization/v1/defaultBlockSerializer.d.ts +2 -2
  128. package/dist/serialization/v1/defaultBlockSerializer.d.ts.map +1 -1
  129. package/dist/serialization/v1/defaultBlockSerializer.js +1 -1
  130. package/dist/serialization/v1/index.d.ts +1 -0
  131. package/dist/serialization/v1/index.d.ts.map +1 -1
  132. package/dist/serialization/v1/index.js +2 -0
  133. package/dist/serialization/v1/index.js.map +1 -1
  134. package/dist/serialization/v1/shaderBlockSerialization.types.d.ts +3 -3
  135. package/dist/serialization/v1/shaderBlockSerialization.types.d.ts.map +1 -1
  136. package/dist/serialization/v1/smartFilterSerialization.types.d.ts +2 -2
  137. package/dist/serialization/v1/smartFilterSerialization.types.d.ts.map +1 -1
  138. package/dist/smartFilter.d.ts +8 -8
  139. package/dist/smartFilter.d.ts.map +1 -1
  140. package/dist/smartFilter.js +6 -7
  141. package/dist/smartFilter.js.map +1 -1
  142. package/dist/utils/buildTools/buildShaders.d.ts +3 -2
  143. package/dist/utils/buildTools/buildShaders.d.ts.map +1 -1
  144. package/dist/utils/buildTools/buildShaders.js +7 -6
  145. package/dist/utils/buildTools/buildShaders.js.map +1 -1
  146. package/dist/utils/buildTools/convertGlslIntoBlock.d.ts +4 -2
  147. package/dist/utils/buildTools/convertGlslIntoBlock.d.ts.map +1 -1
  148. package/dist/utils/buildTools/convertGlslIntoBlock.js +136 -141
  149. package/dist/utils/buildTools/convertGlslIntoBlock.js.map +1 -1
  150. package/dist/utils/buildTools/convertGlslIntoShaderProgram.d.ts +4 -4
  151. package/dist/utils/buildTools/convertGlslIntoShaderProgram.d.ts.map +1 -1
  152. package/dist/utils/buildTools/convertGlslIntoShaderProgram.js +55 -48
  153. package/dist/utils/buildTools/convertGlslIntoShaderProgram.js.map +1 -1
  154. package/dist/utils/buildTools/convertShaders.d.ts +8 -5
  155. package/dist/utils/buildTools/convertShaders.d.ts.map +1 -1
  156. package/dist/utils/buildTools/convertShaders.js +38 -14
  157. package/dist/utils/buildTools/convertShaders.js.map +1 -1
  158. package/dist/utils/buildTools/shaderConverter.d.ts +4 -4
  159. package/dist/utils/buildTools/shaderConverter.d.ts.map +1 -1
  160. package/dist/utils/buildTools/shaderConverter.js +17 -21
  161. package/dist/utils/buildTools/shaderConverter.js.map +1 -1
  162. package/dist/utils/buildTools/watchShaders.d.ts +3 -2
  163. package/dist/utils/buildTools/watchShaders.d.ts.map +1 -1
  164. package/dist/utils/buildTools/watchShaders.js +10 -8
  165. package/dist/utils/buildTools/watchShaders.js.map +1 -1
  166. package/dist/utils/index.d.ts +1 -0
  167. package/dist/utils/index.d.ts.map +1 -1
  168. package/dist/utils/index.js +2 -1
  169. package/dist/utils/index.js.map +1 -1
  170. package/dist/utils/renderTargetUtils.d.ts +3 -3
  171. package/dist/utils/renderTargetUtils.d.ts.map +1 -1
  172. package/dist/utils/renderTargetUtils.js +4 -4
  173. package/dist/utils/renderTargetUtils.js.map +1 -1
  174. package/dist/utils/shaderCodeUtils.d.ts +8 -8
  175. package/dist/utils/shaderCodeUtils.d.ts.map +1 -1
  176. package/dist/utils/shaderCodeUtils.js +16 -28
  177. package/dist/utils/shaderCodeUtils.js.map +1 -1
  178. package/dist/utils/textureLoaders.d.ts +2 -2
  179. package/dist/utils/textureLoaders.d.ts.map +1 -1
  180. package/dist/utils/textureLoaders.js +2 -3
  181. package/dist/utils/textureLoaders.js.map +1 -1
  182. package/dist/utils/textureUtils.d.ts +5 -5
  183. package/dist/utils/textureUtils.d.ts.map +1 -1
  184. package/dist/utils/textureUtils.js +1 -1
  185. package/dist/utils/textureUtils.js.map +1 -1
  186. package/dist/version.d.ts +2 -2
  187. package/dist/version.js +2 -2
  188. package/license.md +21 -21
  189. package/package.json +13 -8
  190. package/src/blockFoundation/aggregateBlock.ts +148 -151
  191. package/src/blockFoundation/baseBlock.ts +339 -364
  192. package/src/blockFoundation/customAggregateBlock.ts +88 -104
  193. package/src/blockFoundation/customShaderBlock.ts +312 -326
  194. package/src/blockFoundation/disableableShaderBlock.ts +91 -100
  195. package/src/blockFoundation/index.ts +9 -9
  196. package/src/blockFoundation/inputBlock.deserializer.ts +72 -97
  197. package/src/blockFoundation/inputBlock.serialization.types.ts +126 -132
  198. package/src/blockFoundation/inputBlock.serializer.ts +150 -150
  199. package/src/blockFoundation/inputBlock.ts +181 -192
  200. package/src/blockFoundation/outputBlock.ts +144 -151
  201. package/src/blockFoundation/shaderBlock.ts +156 -163
  202. package/src/blockFoundation/textureOptions.ts +57 -57
  203. package/src/command/command.ts +59 -59
  204. package/src/command/commandBuffer.ts +71 -71
  205. package/src/command/commandBufferDebugger.ts +14 -14
  206. package/src/command/index.ts +7 -3
  207. package/src/connection/connectionPoint.ts +205 -214
  208. package/src/connection/connectionPointCompatibilityState.ts +31 -31
  209. package/src/connection/connectionPointType.ts +45 -45
  210. package/src/connection/connectionPointWithDefault.ts +27 -35
  211. package/src/connection/index.ts +8 -9
  212. package/src/editorUtils/editableInPropertyPage.ts +106 -106
  213. package/src/editorUtils/index.ts +3 -1
  214. package/src/index.ts +16 -15
  215. package/src/optimization/dependencyGraph.ts +96 -96
  216. package/src/optimization/index.ts +1 -1
  217. package/src/optimization/optimizedShaderBlock.ts +131 -134
  218. package/src/optimization/smartFilterOptimizer.ts +757 -825
  219. package/src/runtime/index.ts +8 -6
  220. package/src/runtime/renderTargetGenerator.ts +222 -248
  221. package/src/runtime/shaderRuntime.ts +174 -173
  222. package/src/runtime/smartFilterRuntime.ts +112 -112
  223. package/src/runtime/strongRef.ts +18 -18
  224. package/src/serialization/importCustomBlockDefinition.ts +86 -86
  225. package/src/serialization/index.ts +10 -7
  226. package/src/serialization/serializedBlockDefinition.ts +12 -12
  227. package/src/serialization/serializedShaderBlockDefinition.ts +7 -7
  228. package/src/serialization/serializedSmartFilter.ts +6 -6
  229. package/src/serialization/smartFilterDeserializer.ts +190 -220
  230. package/src/serialization/smartFilterSerializer.ts +110 -121
  231. package/src/serialization/v1/defaultBlockSerializer.ts +21 -21
  232. package/src/serialization/v1/index.ts +4 -2
  233. package/src/serialization/v1/shaderBlockSerialization.types.ts +85 -85
  234. package/src/serialization/v1/smartFilterSerialization.types.ts +129 -133
  235. package/src/smartFilter.ts +255 -260
  236. package/src/utils/buildTools/buildShaders.ts +14 -13
  237. package/src/utils/buildTools/convertGlslIntoBlock.ts +370 -385
  238. package/src/utils/buildTools/convertGlslIntoShaderProgram.ts +173 -172
  239. package/src/utils/buildTools/convertShaders.ts +65 -43
  240. package/src/utils/buildTools/recordVersionNumber.js +17 -0
  241. package/src/utils/buildTools/shaderConverter.ts +466 -478
  242. package/src/utils/buildTools/watchShaders.ts +44 -42
  243. package/src/utils/index.ts +4 -2
  244. package/src/utils/renderTargetUtils.ts +30 -35
  245. package/src/utils/shaderCodeUtils.ts +192 -207
  246. package/src/utils/textureLoaders.ts +31 -43
  247. package/src/utils/textureUtils.ts +28 -32
  248. package/src/version.ts +2 -2
  249. package/dist/utils/buildTools/determineVersion.d.ts +0 -36
  250. package/dist/utils/buildTools/determineVersion.d.ts.map +0 -1
  251. package/dist/utils/buildTools/determineVersion.js +0 -109
  252. package/dist/utils/buildTools/determineVersion.js.map +0 -1
  253. package/dist/utils/buildTools/versionUp.d.ts +0 -2
  254. package/dist/utils/buildTools/versionUp.d.ts.map +0 -1
  255. package/dist/utils/buildTools/versionUp.js +0 -53
  256. package/dist/utils/buildTools/versionUp.js.map +0 -1
  257. package/src/utils/buildTools/determineVersion.ts +0 -128
  258. package/src/utils/buildTools/versionUp.ts +0 -61
@@ -1,57 +1,57 @@
1
- /**
2
- * The format of a texture - corresponds to the Babylon.js TextureFormat constants
3
- */
4
- export enum TextureFormat {
5
- /** Babylon Constants.TEXTUREFORMAT_RGBA */
6
- RGBA = 5,
7
- /** Babylon Constants.TEXTUREFORMAT_R */
8
- R = 6,
9
- /** Babylon Constants.TEXTUREFORMAT_RG */
10
- RG = 7,
11
- }
12
-
13
- /**
14
- * The type of a texture - corresponds to the Babylon.js TextureType constants
15
- */
16
- export enum TextureType {
17
- /** Babylon Constants.TEXTURETYPE_UNSIGNED_BYTE */
18
- UNSIGNED_BYTE = 0,
19
- /** Babylon Constants.TEXTURETYPE_FLOAT */
20
- FLOAT = 1,
21
- /** Babylon Constants.TEXTURETYPE_HALF_FLOAT */
22
- HALF_FLOAT = 2,
23
- }
24
-
25
- // IMPORTANT: Update textureOptionsMatch() if you add more fields to OutputTextureOptions
26
- /**
27
- * Describes the requirements for the output texture of a shader block.
28
- */
29
- export type OutputTextureOptions = {
30
- /**
31
- * The texture size ratio (output size of this block / size of the Smart Filter output)
32
- */
33
- ratio: number;
34
-
35
- /**
36
- * The format of the texture
37
- */
38
- format: TextureFormat;
39
-
40
- /**
41
- * The type of the texture
42
- */
43
- type: TextureType;
44
- };
45
-
46
- /**
47
- * Compares two OutputTextureOptions to see if they match.
48
- * @param a - The first OutputTextureOptions
49
- * @param b - The second OutputTextureOptions
50
- * @returns True if the two options match, false otherwise
51
- */
52
- export function textureOptionsMatch(a: OutputTextureOptions | undefined, b: OutputTextureOptions | undefined): boolean {
53
- if (a === undefined || b === undefined) {
54
- return false;
55
- }
56
- return a.ratio === b.ratio && a.format === b.format && a.type === b.type;
57
- }
1
+ /**
2
+ * The format of a texture - corresponds to the Babylon.js TextureFormat constants
3
+ */
4
+ export enum TextureFormat {
5
+ /** Babylon Constants.TEXTUREFORMAT_RGBA */
6
+ RGBA = 5,
7
+ /** Babylon Constants.TEXTUREFORMAT_R */
8
+ R = 6,
9
+ /** Babylon Constants.TEXTUREFORMAT_RG */
10
+ RG = 7,
11
+ }
12
+
13
+ /**
14
+ * The type of a texture - corresponds to the Babylon.js TextureType constants
15
+ */
16
+ export enum TextureType {
17
+ /** Babylon Constants.TEXTURETYPE_UNSIGNED_BYTE */
18
+ UNSIGNED_BYTE = 0,
19
+ /** Babylon Constants.TEXTURETYPE_FLOAT */
20
+ FLOAT = 1,
21
+ /** Babylon Constants.TEXTURETYPE_HALF_FLOAT */
22
+ HALF_FLOAT = 2,
23
+ }
24
+
25
+ // IMPORTANT: Update textureOptionsMatch() if you add more fields to OutputTextureOptions
26
+ /**
27
+ * Describes the requirements for the output texture of a shader block.
28
+ */
29
+ export type OutputTextureOptions = {
30
+ /**
31
+ * The texture size ratio (output size of this block / size of the Smart Filter output)
32
+ */
33
+ ratio: number;
34
+
35
+ /**
36
+ * The format of the texture
37
+ */
38
+ format: TextureFormat;
39
+
40
+ /**
41
+ * The type of the texture
42
+ */
43
+ type: TextureType;
44
+ };
45
+
46
+ /**
47
+ * Compares two OutputTextureOptions to see if they match.
48
+ * @param a - The first OutputTextureOptions
49
+ * @param b - The second OutputTextureOptions
50
+ * @returns True if the two options match, false otherwise
51
+ */
52
+ export function TextureOptionsMatch(a: OutputTextureOptions | undefined, b: OutputTextureOptions | undefined): boolean {
53
+ if (a === undefined || b === undefined) {
54
+ return false;
55
+ }
56
+ return a.ratio === b.ratio && a.format === b.format && a.type === b.type;
57
+ }
@@ -1,59 +1,59 @@
1
- /**
2
- * Represents the owner of a command.
3
- */
4
- export interface ICommandOwner {
5
- /**
6
- * The friendly name of the owner.
7
- */
8
- readonly name: string;
9
-
10
- /**
11
- * The blockType of the owner;
12
- */
13
- readonly blockType: string;
14
- }
15
-
16
- /**
17
- * Represents a the action of a @see Command. This is what will be executed during a command buffer execution.
18
- */
19
- export type CommandAction = () => void;
20
-
21
- /**
22
- * Represents a command to execute.
23
- *
24
- * A command contains a function that will be executed at runtime by the smart filter.
25
- *
26
- * It also contains the owner of the command for debugging purposes.
27
- */
28
- export type Command = {
29
- /**
30
- * The friendly name of the command.
31
- */
32
- readonly name: string;
33
-
34
- /**
35
- * The owner of the command.
36
- * In practice, it will mostly be a block, the smart filter or a tool injecting commands.
37
- */
38
- readonly owner: ICommandOwner;
39
-
40
- /**
41
- * Defines the action to execute.
42
- */
43
- readonly action: CommandAction;
44
- };
45
-
46
- /**
47
- * Creates a new command.
48
- * @param name - The friendly name of the command
49
- * @param owner - The owner of the command
50
- * @param action - The action to execute when the command is executed
51
- * @returns The new command
52
- */
53
- export function createCommand(name: string, owner: ICommandOwner, action: CommandAction): Command {
54
- return {
55
- name,
56
- owner,
57
- action,
58
- };
59
- }
1
+ /**
2
+ * Represents the owner of a command.
3
+ */
4
+ export interface ICommandOwner {
5
+ /**
6
+ * The friendly name of the owner.
7
+ */
8
+ readonly name: string;
9
+
10
+ /**
11
+ * The blockType of the owner;
12
+ */
13
+ readonly blockType: string;
14
+ }
15
+
16
+ /**
17
+ * Represents a the action of a @see Command. This is what will be executed during a command buffer execution.
18
+ */
19
+ export type CommandAction = () => void;
20
+
21
+ /**
22
+ * Represents a command to execute.
23
+ *
24
+ * A command contains a function that will be executed at runtime by the smart filter.
25
+ *
26
+ * It also contains the owner of the command for debugging purposes.
27
+ */
28
+ export type Command = {
29
+ /**
30
+ * The friendly name of the command.
31
+ */
32
+ readonly name: string;
33
+
34
+ /**
35
+ * The owner of the command.
36
+ * In practice, it will mostly be a block, the smart filter or a tool injecting commands.
37
+ */
38
+ readonly owner: ICommandOwner;
39
+
40
+ /**
41
+ * Defines the action to execute.
42
+ */
43
+ readonly action: CommandAction;
44
+ };
45
+
46
+ /**
47
+ * Creates a new command.
48
+ * @param name - The friendly name of the command
49
+ * @param owner - The owner of the command
50
+ * @param action - The action to execute when the command is executed
51
+ * @returns The new command
52
+ */
53
+ export function CreateCommand(name: string, owner: ICommandOwner, action: CommandAction): Command {
54
+ return {
55
+ name,
56
+ owner,
57
+ action,
58
+ };
59
+ }
@@ -1,71 +1,71 @@
1
- import type { Command } from "./command";
2
-
3
- /**
4
- * Represents the action to run when calling `visitCommands` on a @see CommandBuffer.
5
- */
6
- export type CommandsVisitor = (command: Command) => void;
7
-
8
- /**
9
- * @see CommandsVisitor used to execute the commands of a @see CommandBuffer.
10
- * @param command - The command to execute.
11
- */
12
- function executeCommandsVisitor(command: Command) {
13
- command.action();
14
- }
15
-
16
- /**
17
- * A command buffer is a list of commands to execute.
18
- * This is used to store the list of tasks the current smart filter needs to execute.
19
- */
20
- export class CommandBuffer {
21
- private readonly _commands: Command[] = [];
22
-
23
- /**
24
- * Creates a new command buffer.
25
- * @param args - the list of commands to add to the command buffer
26
- */
27
- constructor(...args: Command[]) {
28
- for (const command of args) {
29
- this.push(command);
30
- }
31
- }
32
-
33
- /**
34
- * Adds a command to the command buffer.
35
- * @param command - the command to add
36
- */
37
- public push(command: Command) {
38
- this._commands.push(command);
39
- }
40
-
41
- /**
42
- * Clears the command buffer and empty the list of commands.
43
- */
44
- public clear() {
45
- this._commands.length = 0;
46
- }
47
-
48
- /**
49
- * Visits all the commands in the command buffer.
50
- * @param commandVisitor - The action to execute on each command
51
- */
52
- public visitCommands(commandVisitor: CommandsVisitor): void {
53
- for (const command of this._commands) {
54
- commandVisitor(command);
55
- }
56
- }
57
-
58
- /**
59
- * Execute all the commands in the command buffer.
60
- */
61
- public execute() {
62
- this.visitCommands(executeCommandsVisitor);
63
- }
64
-
65
- /**
66
- * Dispose the resources associated to the command buffer.
67
- */
68
- public dispose() {
69
- this.clear();
70
- }
71
- }
1
+ import type { Command } from "./command.js";
2
+
3
+ /**
4
+ * Represents the action to run when calling `visitCommands` on a @see CommandBuffer.
5
+ */
6
+ export type CommandsVisitor = (command: Command) => void;
7
+
8
+ /**
9
+ * @see CommandsVisitor used to execute the commands of a @see CommandBuffer.
10
+ * @param command - The command to execute.
11
+ */
12
+ function ExecuteCommandsVisitor(command: Command) {
13
+ command.action();
14
+ }
15
+
16
+ /**
17
+ * A command buffer is a list of commands to execute.
18
+ * This is used to store the list of tasks the current smart filter needs to execute.
19
+ */
20
+ export class CommandBuffer {
21
+ private readonly _commands: Command[] = [];
22
+
23
+ /**
24
+ * Creates a new command buffer.
25
+ * @param args - the list of commands to add to the command buffer
26
+ */
27
+ constructor(...args: Command[]) {
28
+ for (const command of args) {
29
+ this.push(command);
30
+ }
31
+ }
32
+
33
+ /**
34
+ * Adds a command to the command buffer.
35
+ * @param command - the command to add
36
+ */
37
+ public push(command: Command) {
38
+ this._commands.push(command);
39
+ }
40
+
41
+ /**
42
+ * Clears the command buffer and empty the list of commands.
43
+ */
44
+ public clear() {
45
+ this._commands.length = 0;
46
+ }
47
+
48
+ /**
49
+ * Visits all the commands in the command buffer.
50
+ * @param commandVisitor - The action to execute on each command
51
+ */
52
+ public visitCommands(commandVisitor: CommandsVisitor): void {
53
+ for (const command of this._commands) {
54
+ commandVisitor(command);
55
+ }
56
+ }
57
+
58
+ /**
59
+ * Execute all the commands in the command buffer.
60
+ */
61
+ public execute() {
62
+ this.visitCommands(ExecuteCommandsVisitor);
63
+ }
64
+
65
+ /**
66
+ * Dispose the resources associated to the command buffer.
67
+ */
68
+ public dispose() {
69
+ this.clear();
70
+ }
71
+ }
@@ -1,14 +1,14 @@
1
- import { Logger } from "@babylonjs/core/Misc/logger.js";
2
- import type { CommandBuffer } from "./commandBuffer";
3
-
4
- /**
5
- * Logs all the commands associated to a command buffer.
6
- * @param commandBuffer - The command buffer to log
7
- */
8
- export function logCommands(commandBuffer: Readonly<CommandBuffer>) {
9
- Logger.Log("----- Command buffer commands -----");
10
- commandBuffer.visitCommands((command) => {
11
- Logger.Log(` Owner: ${command.owner.blockType} (${command.owner.name}) - Command: ${command.name}`);
12
- });
13
- Logger.Log("-----------------------------------");
14
- }
1
+ import { Logger } from "core/Misc/logger.js";
2
+ import type { CommandBuffer } from "./commandBuffer.js";
3
+
4
+ /**
5
+ * Logs all the commands associated to a command buffer.
6
+ * @param commandBuffer - The command buffer to log
7
+ */
8
+ export function LogCommands(commandBuffer: Readonly<CommandBuffer>) {
9
+ Logger.Log("----- Command buffer commands -----");
10
+ commandBuffer.visitCommands((command) => {
11
+ Logger.Log(` Owner: ${command.owner.blockType} (${command.owner.name}) - Command: ${command.name}`);
12
+ });
13
+ Logger.Log("-----------------------------------");
14
+ }
@@ -1,3 +1,7 @@
1
- export * from "./command.js";
2
- export * from "./commandBuffer.js";
3
- export { logCommands } from "./commandBufferDebugger.js";
1
+ export * from "./command.js";
2
+ // Back compat for when camelCase was used
3
+ export { CreateCommand as createCommand } from "./command.js";
4
+ export * from "./commandBuffer.js";
5
+ export { LogCommands } from "./commandBufferDebugger.js";
6
+ // Back compat for when camelCase was used
7
+ export { LogCommands as logCommands } from "./commandBufferDebugger.js";