@combeenation/3d-viewer 7.1.0 → 7.1.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 (117) hide show
  1. package/README.md +111 -111
  2. package/dist/lib-cjs/api/classes/animationInterface.d.ts +8 -8
  3. package/dist/lib-cjs/api/classes/animationInterface.js +2 -2
  4. package/dist/lib-cjs/api/classes/dottedPath.d.ts +79 -79
  5. package/dist/lib-cjs/api/classes/dottedPath.js +166 -166
  6. package/dist/lib-cjs/api/classes/element.d.ts +153 -153
  7. package/dist/lib-cjs/api/classes/element.js +672 -670
  8. package/dist/lib-cjs/api/classes/element.js.map +1 -1
  9. package/dist/lib-cjs/api/classes/event.d.ts +401 -396
  10. package/dist/lib-cjs/api/classes/event.js +424 -419
  11. package/dist/lib-cjs/api/classes/event.js.map +1 -1
  12. package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
  13. package/dist/lib-cjs/api/classes/eventBroadcaster.js +49 -49
  14. package/dist/lib-cjs/api/classes/fuzzyMap.d.ts +7 -7
  15. package/dist/lib-cjs/api/classes/fuzzyMap.js +21 -21
  16. package/dist/lib-cjs/api/classes/parameter.d.ts +351 -351
  17. package/dist/lib-cjs/api/classes/parameter.js +524 -517
  18. package/dist/lib-cjs/api/classes/parameter.js.map +1 -1
  19. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  20. package/dist/lib-cjs/api/classes/parameterObservable.js +72 -72
  21. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  22. package/dist/lib-cjs/api/classes/parameterizable.js +102 -102
  23. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +45 -45
  24. package/dist/lib-cjs/api/classes/placementAnimation.js +176 -176
  25. package/dist/lib-cjs/api/classes/variant.d.ts +253 -253
  26. package/dist/lib-cjs/api/classes/variant.js +858 -843
  27. package/dist/lib-cjs/api/classes/variant.js.map +1 -1
  28. package/dist/lib-cjs/api/classes/variantInstance.d.ts +53 -53
  29. package/dist/lib-cjs/api/classes/variantInstance.js +125 -125
  30. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  31. package/dist/lib-cjs/api/classes/variantParameterizable.js +86 -88
  32. package/dist/lib-cjs/api/classes/variantParameterizable.js.map +1 -1
  33. package/dist/lib-cjs/api/classes/viewer.d.ts +204 -199
  34. package/dist/lib-cjs/api/classes/viewer.js +682 -670
  35. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  36. package/dist/lib-cjs/api/classes/viewerError.d.ts +43 -0
  37. package/dist/lib-cjs/api/classes/viewerError.js +56 -0
  38. package/dist/lib-cjs/api/classes/viewerError.js.map +1 -0
  39. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  40. package/dist/lib-cjs/api/classes/viewerLight.js +348 -348
  41. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  42. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  43. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -13
  44. package/dist/lib-cjs/api/internal/sceneSetup.js +226 -226
  45. package/dist/lib-cjs/api/manager/animationManager.d.ts +30 -30
  46. package/dist/lib-cjs/api/manager/animationManager.js +126 -126
  47. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +79 -78
  48. package/dist/lib-cjs/api/manager/gltfExportManager.js +242 -241
  49. package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -1
  50. package/dist/lib-cjs/api/manager/sceneManager.d.ts +33 -33
  51. package/dist/lib-cjs/api/manager/sceneManager.js +128 -130
  52. package/dist/lib-cjs/api/manager/sceneManager.js.map +1 -1
  53. package/dist/lib-cjs/api/manager/tagManager.d.ts +116 -108
  54. package/dist/lib-cjs/api/manager/tagManager.js +444 -419
  55. package/dist/lib-cjs/api/manager/tagManager.js.map +1 -1
  56. package/dist/lib-cjs/api/manager/textureLoadManager.d.ts +22 -22
  57. package/dist/lib-cjs/api/manager/textureLoadManager.js +97 -97
  58. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +106 -102
  59. package/dist/lib-cjs/api/manager/variantInstanceManager.js +292 -284
  60. package/dist/lib-cjs/api/manager/variantInstanceManager.js.map +1 -1
  61. package/dist/lib-cjs/api/store/specStorage.d.ts +32 -32
  62. package/dist/lib-cjs/api/store/specStorage.js +65 -65
  63. package/dist/lib-cjs/api/util/babylonHelper.d.ts +235 -235
  64. package/dist/lib-cjs/api/util/babylonHelper.js +753 -753
  65. package/dist/lib-cjs/api/util/globalTypes.d.ts +441 -436
  66. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  67. package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -58
  68. package/dist/lib-cjs/api/util/resourceHelper.js +203 -203
  69. package/dist/lib-cjs/api/util/sceneLoaderHelper.d.ts +44 -44
  70. package/dist/lib-cjs/api/util/sceneLoaderHelper.js +175 -175
  71. package/dist/lib-cjs/api/util/stringHelper.d.ts +13 -13
  72. package/dist/lib-cjs/api/util/stringHelper.js +32 -32
  73. package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
  74. package/dist/lib-cjs/api/util/structureHelper.js +57 -48
  75. package/dist/lib-cjs/api/util/structureHelper.js.map +1 -1
  76. package/dist/lib-cjs/buildinfo.json +3 -3
  77. package/dist/lib-cjs/commonjs.tsconfig.tsbuildinfo +1 -1
  78. package/dist/lib-cjs/index.d.ts +54 -53
  79. package/dist/lib-cjs/index.js +117 -114
  80. package/dist/lib-cjs/index.js.map +1 -1
  81. package/package.json +81 -81
  82. package/src/api/classes/animationInterface.ts +10 -10
  83. package/src/api/classes/dottedPath.ts +181 -181
  84. package/src/api/classes/element.ts +733 -731
  85. package/src/api/classes/event.ts +457 -452
  86. package/src/api/classes/eventBroadcaster.ts +52 -52
  87. package/src/api/classes/fuzzyMap.ts +21 -21
  88. package/src/api/classes/parameter.ts +561 -554
  89. package/src/api/classes/parameterObservable.ts +73 -73
  90. package/src/api/classes/parameterizable.ts +87 -87
  91. package/src/api/classes/placementAnimation.ts +162 -162
  92. package/src/api/classes/variant.ts +949 -933
  93. package/src/api/classes/variantInstance.ts +123 -123
  94. package/src/api/classes/variantParameterizable.ts +83 -85
  95. package/src/api/classes/viewer.ts +760 -743
  96. package/src/api/classes/viewerError.ts +63 -0
  97. package/src/api/classes/viewerLight.ts +339 -339
  98. package/src/api/internal/debugViewer.ts +90 -90
  99. package/src/api/internal/lensRendering.ts +9 -9
  100. package/src/api/internal/sceneSetup.ts +205 -205
  101. package/src/api/manager/animationManager.ts +143 -143
  102. package/src/api/manager/gltfExportManager.ts +237 -236
  103. package/src/api/manager/sceneManager.ts +134 -136
  104. package/src/api/manager/tagManager.ts +477 -451
  105. package/src/api/manager/textureLoadManager.ts +95 -95
  106. package/src/api/manager/variantInstanceManager.ts +309 -297
  107. package/src/api/store/specStorage.ts +68 -68
  108. package/src/api/util/babylonHelper.ts +823 -823
  109. package/src/api/util/globalTypes.ts +508 -503
  110. package/src/api/util/resourceHelper.ts +191 -191
  111. package/src/api/util/sceneLoaderHelper.ts +170 -170
  112. package/src/api/util/stringHelper.ts +30 -30
  113. package/src/api/util/structureHelper.ts +58 -49
  114. package/src/buildinfo.json +3 -3
  115. package/src/dev.ts +62 -62
  116. package/src/index.ts +103 -100
  117. package/src/types.d.ts +38 -38
@@ -1,95 +1,95 @@
1
- import { Event } from '../classes/event';
2
- import { EventBroadcaster } from '../classes/eventBroadcaster';
3
- import { isTextureWithOnLoadObservable } from '../util/babylonHelper';
4
- import { sleep } from '../util/resourceHelper';
5
- import { BaseTexture } from '@babylonjs/core/Materials/Textures/baseTexture';
6
- import { Scene as BabylonScene } from '@babylonjs/core/scene';
7
-
8
- /**
9
- * Keeps track of all texture loading/ready states and fires {@link Event.TEXTURE_LOADING_START} and
10
- * {@link Event.TEXTURE_LOADING_END} events.
11
- */
12
- export class TextureLoadManager extends EventBroadcaster {
13
- // We're keeping track of all "loading textures" in this map ourselves instead of relying on information from
14
- // `scene.textures` as that proved to be rather unreliable for our use cases.
15
- // E.g. see this forums post for some more information:
16
- // https://forum.babylonjs.com/t/using-scene-createdefaultenvironment-removes-textures-from-scene/35267
17
- private readonly _loadingTextures: Map<number, BaseTexture> = new Map();
18
-
19
- // Whenever we fire the {@link Event.TEXTURE_LOADING_START} event, we're starting a polling service which checks all
20
- // x ms if all awaited textures are in "ready state" or not.
21
- // This is basically just an additional safety net in addition to our `onLoadObservable`s and was added to prevent
22
- // situations where a {@link Event.TEXTURE_LOADING_START} event is fired without an accompanying
23
- // {@link Event.TEXTURE_LOADING_END} as that is a situation which can lead to load masks being endlessly shown in a
24
- // cfgr.
25
- // In theory this shouldn't be necessary, but we've already discovered some quirks and inconsistent behavior around
26
- // the texture load observables etc. and I felt more save with this safety net in place.
27
- private _readyStatePollingIntervalMs = 200;
28
- private _readyStatePollingId = 0;
29
-
30
- private constructor(public scene: BabylonScene) {
31
- super();
32
- this.scene.onNewTextureAddedObservable.add(texture => this.onTextureAdded(texture));
33
- }
34
-
35
- public static create(scene: BabylonScene): TextureLoadManager {
36
- const loadMgr = new TextureLoadManager(scene);
37
- return loadMgr;
38
- }
39
-
40
- private startReadyStatePollingIfNeeded() {
41
- if (!this._readyStatePollingId) {
42
- this._readyStatePollingId = window.setInterval(
43
- () => this.checkLoadingTexturesState(),
44
- this._readyStatePollingIntervalMs
45
- );
46
- }
47
- }
48
-
49
- private endReadyStatePollingIfNeeded() {
50
- if (this._readyStatePollingId) {
51
- window.clearInterval(this._readyStatePollingId);
52
- this._readyStatePollingId = 0;
53
- }
54
- }
55
-
56
- /**
57
- * Checks the "ready state" of all textures inside the `this._loadingTextures` map, removes the ready ones and fires
58
- * the {@link Event.TEXTURE_LOADING_END} event if no more textures are loading (i.e. "all ready").
59
- */
60
- private checkLoadingTexturesState() {
61
- const allTexturesReadyBefore = !this._loadingTextures.size;
62
- if (allTexturesReadyBefore) return;
63
-
64
- // Remove textures which are in "ready state" from the map
65
- for (const [id, texture] of this._loadingTextures) {
66
- if (texture.isReady()) this._loadingTextures.delete(id);
67
- }
68
-
69
- const allTexturesReadyAfter = !this._loadingTextures.size;
70
- if (allTexturesReadyAfter) {
71
- this.broadcastEvent(Event.TEXTURE_LOADING_END);
72
- this.endReadyStatePollingIfNeeded();
73
- }
74
- }
75
-
76
- private async onTextureAdded(texture: BaseTexture) {
77
- // Workaround:
78
- // The texture object is not fully created when the "added observable" is called. E.g. the function
79
- // `onLoadObservable` is not there at that point.
80
- // More details: https://forum.babylonjs.com/t/basetexture-whenallready-returns-too-early/34501/4
81
- await sleep(0);
82
-
83
- // Some textures are already in "ready state" after the sleep -> We don't care for them anymore as well as for
84
- // textures which don't come with an `onLoadObservable` (i.e. not of class {@link Texture}).
85
- if (texture.isReady() || !isTextureWithOnLoadObservable(texture)) return;
86
-
87
- const noCurrentLoadingTextures = !this._loadingTextures.size;
88
- if (noCurrentLoadingTextures) {
89
- this.broadcastEvent(Event.TEXTURE_LOADING_START);
90
- this.startReadyStatePollingIfNeeded();
91
- }
92
- this._loadingTextures.set(texture.uniqueId, texture);
93
- texture.onLoadObservable.addOnce(texture => this.checkLoadingTexturesState());
94
- }
95
- }
1
+ import { Event } from '../classes/event';
2
+ import { EventBroadcaster } from '../classes/eventBroadcaster';
3
+ import { isTextureWithOnLoadObservable } from '../util/babylonHelper';
4
+ import { sleep } from '../util/resourceHelper';
5
+ import { BaseTexture } from '@babylonjs/core/Materials/Textures/baseTexture';
6
+ import { Scene as BabylonScene } from '@babylonjs/core/scene';
7
+
8
+ /**
9
+ * Keeps track of all texture loading/ready states and fires {@link Event.TEXTURE_LOADING_START} and
10
+ * {@link Event.TEXTURE_LOADING_END} events.
11
+ */
12
+ export class TextureLoadManager extends EventBroadcaster {
13
+ // We're keeping track of all "loading textures" in this map ourselves instead of relying on information from
14
+ // `scene.textures` as that proved to be rather unreliable for our use cases.
15
+ // E.g. see this forums post for some more information:
16
+ // https://forum.babylonjs.com/t/using-scene-createdefaultenvironment-removes-textures-from-scene/35267
17
+ private readonly _loadingTextures: Map<number, BaseTexture> = new Map();
18
+
19
+ // Whenever we fire the {@link Event.TEXTURE_LOADING_START} event, we're starting a polling service which checks all
20
+ // x ms if all awaited textures are in "ready state" or not.
21
+ // This is basically just an additional safety net in addition to our `onLoadObservable`s and was added to prevent
22
+ // situations where a {@link Event.TEXTURE_LOADING_START} event is fired without an accompanying
23
+ // {@link Event.TEXTURE_LOADING_END} as that is a situation which can lead to load masks being endlessly shown in a
24
+ // cfgr.
25
+ // In theory this shouldn't be necessary, but we've already discovered some quirks and inconsistent behavior around
26
+ // the texture load observables etc. and I felt more save with this safety net in place.
27
+ private _readyStatePollingIntervalMs = 200;
28
+ private _readyStatePollingId = 0;
29
+
30
+ private constructor(public scene: BabylonScene) {
31
+ super();
32
+ this.scene.onNewTextureAddedObservable.add(texture => this.onTextureAdded(texture));
33
+ }
34
+
35
+ public static create(scene: BabylonScene): TextureLoadManager {
36
+ const loadMgr = new TextureLoadManager(scene);
37
+ return loadMgr;
38
+ }
39
+
40
+ private startReadyStatePollingIfNeeded() {
41
+ if (!this._readyStatePollingId) {
42
+ this._readyStatePollingId = window.setInterval(
43
+ () => this.checkLoadingTexturesState(),
44
+ this._readyStatePollingIntervalMs
45
+ );
46
+ }
47
+ }
48
+
49
+ private endReadyStatePollingIfNeeded() {
50
+ if (this._readyStatePollingId) {
51
+ window.clearInterval(this._readyStatePollingId);
52
+ this._readyStatePollingId = 0;
53
+ }
54
+ }
55
+
56
+ /**
57
+ * Checks the "ready state" of all textures inside the `this._loadingTextures` map, removes the ready ones and fires
58
+ * the {@link Event.TEXTURE_LOADING_END} event if no more textures are loading (i.e. "all ready").
59
+ */
60
+ private checkLoadingTexturesState() {
61
+ const allTexturesReadyBefore = !this._loadingTextures.size;
62
+ if (allTexturesReadyBefore) return;
63
+
64
+ // Remove textures which are in "ready state" from the map
65
+ for (const [id, texture] of this._loadingTextures) {
66
+ if (texture.isReady()) this._loadingTextures.delete(id);
67
+ }
68
+
69
+ const allTexturesReadyAfter = !this._loadingTextures.size;
70
+ if (allTexturesReadyAfter) {
71
+ this.broadcastEvent(Event.TEXTURE_LOADING_END);
72
+ this.endReadyStatePollingIfNeeded();
73
+ }
74
+ }
75
+
76
+ private async onTextureAdded(texture: BaseTexture) {
77
+ // Workaround:
78
+ // The texture object is not fully created when the "added observable" is called. E.g. the function
79
+ // `onLoadObservable` is not there at that point.
80
+ // More details: https://forum.babylonjs.com/t/basetexture-whenallready-returns-too-early/34501/4
81
+ await sleep(0);
82
+
83
+ // Some textures are already in "ready state" after the sleep -> We don't care for them anymore as well as for
84
+ // textures which don't come with an `onLoadObservable` (i.e. not of class {@link Texture}).
85
+ if (texture.isReady() || !isTextureWithOnLoadObservable(texture)) return;
86
+
87
+ const noCurrentLoadingTextures = !this._loadingTextures.size;
88
+ if (noCurrentLoadingTextures) {
89
+ this.broadcastEvent(Event.TEXTURE_LOADING_START);
90
+ this.startReadyStatePollingIfNeeded();
91
+ }
92
+ this._loadingTextures.set(texture.uniqueId, texture);
93
+ texture.onLoadObservable.addOnce(texture => this.checkLoadingTexturesState());
94
+ }
95
+ }