@combeenation/3d-viewer 6.1.0 → 6.2.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 (97) 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 +149 -149
  7. package/dist/lib-cjs/api/classes/element.js +669 -669
  8. package/dist/lib-cjs/api/classes/event.d.ts +342 -342
  9. package/dist/lib-cjs/api/classes/event.js +365 -365
  10. package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
  11. package/dist/lib-cjs/api/classes/eventBroadcaster.js +49 -49
  12. package/dist/lib-cjs/api/classes/parameter.d.ts +339 -339
  13. package/dist/lib-cjs/api/classes/parameter.js +464 -464
  14. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  15. package/dist/lib-cjs/api/classes/parameterObservable.js +97 -97
  16. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  17. package/dist/lib-cjs/api/classes/parameterizable.js +102 -102
  18. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +45 -45
  19. package/dist/lib-cjs/api/classes/placementAnimation.js +176 -176
  20. package/dist/lib-cjs/api/classes/variant.d.ts +238 -234
  21. package/dist/lib-cjs/api/classes/variant.js +841 -828
  22. package/dist/lib-cjs/api/classes/variant.js.map +1 -1
  23. package/dist/lib-cjs/api/classes/variantInstance.d.ts +44 -44
  24. package/dist/lib-cjs/api/classes/variantInstance.js +105 -105
  25. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  26. package/dist/lib-cjs/api/classes/variantParameterizable.js +88 -88
  27. package/dist/lib-cjs/api/classes/viewer.d.ts +192 -187
  28. package/dist/lib-cjs/api/classes/viewer.js +639 -594
  29. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  30. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  31. package/dist/lib-cjs/api/classes/viewerLight.js +348 -348
  32. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  33. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  34. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -13
  35. package/dist/lib-cjs/api/internal/sceneSetup.js +226 -226
  36. package/dist/lib-cjs/api/manager/animationManager.d.ts +30 -30
  37. package/dist/lib-cjs/api/manager/animationManager.js +126 -126
  38. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +78 -78
  39. package/dist/lib-cjs/api/manager/gltfExportManager.js +241 -241
  40. package/dist/lib-cjs/api/manager/sceneManager.d.ts +33 -33
  41. package/dist/lib-cjs/api/manager/sceneManager.js +130 -130
  42. package/dist/lib-cjs/api/manager/textureLoadManager.d.ts +22 -22
  43. package/dist/lib-cjs/api/manager/textureLoadManager.js +97 -97
  44. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +92 -92
  45. package/dist/lib-cjs/api/manager/variantInstanceManager.js +260 -260
  46. package/dist/lib-cjs/api/store/specStorage.d.ts +24 -24
  47. package/dist/lib-cjs/api/store/specStorage.js +50 -50
  48. package/dist/lib-cjs/api/util/babylonHelper.d.ts +187 -187
  49. package/dist/lib-cjs/api/util/babylonHelper.js +596 -596
  50. package/dist/lib-cjs/api/util/globalTypes.d.ts +387 -383
  51. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  52. package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -58
  53. package/dist/lib-cjs/api/util/resourceHelper.js +203 -203
  54. package/dist/lib-cjs/api/util/sceneLoaderHelper.d.ts +42 -42
  55. package/dist/lib-cjs/api/util/sceneLoaderHelper.js +139 -139
  56. package/dist/lib-cjs/api/util/stringHelper.d.ts +9 -9
  57. package/dist/lib-cjs/api/util/stringHelper.js +25 -25
  58. package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
  59. package/dist/lib-cjs/api/util/structureHelper.js +48 -48
  60. package/dist/lib-cjs/buildinfo.json +3 -3
  61. package/dist/lib-cjs/commonjs.tsconfig.tsbuildinfo +1 -1
  62. package/dist/lib-cjs/index.d.ts +51 -51
  63. package/dist/lib-cjs/index.js +110 -110
  64. package/package.json +81 -81
  65. package/src/api/classes/animationInterface.ts +10 -10
  66. package/src/api/classes/dottedPath.ts +181 -181
  67. package/src/api/classes/element.ts +717 -717
  68. package/src/api/classes/event.ts +385 -385
  69. package/src/api/classes/eventBroadcaster.ts +52 -52
  70. package/src/api/classes/parameter.ts +497 -497
  71. package/src/api/classes/parameterObservable.ts +100 -100
  72. package/src/api/classes/parameterizable.ts +87 -87
  73. package/src/api/classes/placementAnimation.ts +162 -162
  74. package/src/api/classes/variant.ts +910 -896
  75. package/src/api/classes/variantInstance.ts +97 -97
  76. package/src/api/classes/variantParameterizable.ts +85 -85
  77. package/src/api/classes/viewer.ts +720 -672
  78. package/src/api/classes/viewerLight.ts +339 -339
  79. package/src/api/internal/debugViewer.ts +90 -90
  80. package/src/api/internal/lensRendering.ts +9 -9
  81. package/src/api/internal/sceneSetup.ts +205 -205
  82. package/src/api/manager/animationManager.ts +143 -143
  83. package/src/api/manager/gltfExportManager.ts +236 -236
  84. package/src/api/manager/sceneManager.ts +132 -132
  85. package/src/api/manager/textureLoadManager.ts +95 -95
  86. package/src/api/manager/variantInstanceManager.ts +265 -265
  87. package/src/api/store/specStorage.ts +51 -51
  88. package/src/api/util/babylonHelper.ts +663 -663
  89. package/src/api/util/globalTypes.ts +437 -432
  90. package/src/api/util/resourceHelper.ts +191 -191
  91. package/src/api/util/sceneLoaderHelper.ts +137 -137
  92. package/src/api/util/stringHelper.ts +23 -23
  93. package/src/api/util/structureHelper.ts +49 -49
  94. package/src/buildinfo.json +3 -3
  95. package/src/dev.ts +61 -61
  96. package/src/index.ts +96 -96
  97. package/src/types.d.ts +28 -28
@@ -1,143 +1,143 @@
1
- import { AnimationInterface } from '../classes/animationInterface';
2
- import { PlacementAnimation } from '../classes/placementAnimation';
3
- import { Animation as BabylonAnimation } from '@babylonjs/core/Animations/animation';
4
- import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
5
- import { Scene as BabylonScene, Scene } from '@babylonjs/core/scene';
6
- import { Nullable } from '@babylonjs/core/types';
7
- //import { CustomEase } from 'gsap/CustomEase';
8
- //import { ExpoScaleEase, RoughEase, SlowMo } from 'gsap/EasePack';
9
- import { remove } from 'lodash-es';
10
-
11
- //gsap.registerPlugin( CustomEase, ExpoScaleEase, RoughEase, SlowMo );
12
-
13
- export class AnimationManager {
14
- public animations: AnimationInterface[] = [];
15
-
16
- /**
17
- * Constructor.
18
- */
19
- protected constructor(protected scene: Scene) {}
20
-
21
- /**
22
- * Creates an {@link AnimationManager} based on given BabylonJS scene.
23
- */
24
- public static async create(scene: BabylonScene): Promise<AnimationManager> {
25
- return new AnimationManager(scene);
26
- }
27
-
28
- /**
29
- * @deprecated Use viewer.moveCameraTo().
30
- */
31
- public resetCamera(animate: boolean = false) {
32
- //TODO currently only works for arcrotate. are there any other cameras?
33
- const activeCamera = this.scene.activeCamera as Nullable<ArcRotateCamera>;
34
- if (!activeCamera) {
35
- throw new Error('There is no active camera');
36
- }
37
-
38
- const initAlpha = activeCamera.metadata.alpha;
39
- const initBeta = activeCamera.metadata.beta;
40
- const initRadius = activeCamera.metadata.radius;
41
-
42
- if (animate) {
43
- this.animateArcRotateCamera(initAlpha, initBeta, initRadius);
44
- } else {
45
- activeCamera.alpha = initAlpha;
46
- activeCamera.beta = initBeta;
47
- activeCamera.radius = initRadius;
48
- }
49
- }
50
-
51
- /**
52
- * @deprecated Use viewer.moveCameraTo().
53
- */
54
- public animateArcRotateCamera(targetAlpha: number, targetBeta: number, targetRadius: number) {
55
- const activeCamera = this.scene.activeCamera as Nullable<ArcRotateCamera>;
56
- if (!activeCamera) {
57
- throw new Error('There is no active camera');
58
- }
59
- const alphaAnimation = new BabylonAnimation(
60
- 'alphaAnimation',
61
- 'alpha',
62
- 30,
63
- BabylonAnimation.ANIMATIONTYPE_FLOAT,
64
- BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
65
- );
66
- const betaAnimation = new BabylonAnimation(
67
- 'betaAnimation',
68
- 'beta',
69
- 30,
70
- BabylonAnimation.ANIMATIONTYPE_FLOAT,
71
- BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
72
- );
73
- const radiusAnimation = new BabylonAnimation(
74
- 'radiusAnimation',
75
- 'radius',
76
- 30,
77
- BabylonAnimation.ANIMATIONTYPE_FLOAT,
78
- BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
79
- );
80
- alphaAnimation.setKeys([
81
- {
82
- frame: 0,
83
- value: activeCamera.alpha,
84
- },
85
- {
86
- frame: 100,
87
- value: targetAlpha,
88
- },
89
- ]);
90
- betaAnimation.setKeys([
91
- {
92
- frame: 0,
93
- value: activeCamera.beta,
94
- },
95
- {
96
- frame: 100,
97
- value: targetBeta,
98
- },
99
- ]);
100
- radiusAnimation.setKeys([
101
- {
102
- frame: 0,
103
- value: activeCamera.radius,
104
- },
105
- {
106
- frame: 100,
107
- value: targetRadius,
108
- },
109
- ]);
110
- activeCamera.animations.push(alphaAnimation);
111
- activeCamera.animations.push(betaAnimation);
112
- activeCamera.animations.push(radiusAnimation);
113
-
114
- const animation = this.scene.beginAnimation(activeCamera, 0, 100, false, 10);
115
- animation.disposeOnEnd = true;
116
- }
117
-
118
- /**
119
- * Stops and kills all running animations.
120
- */
121
- public killAllAnimations() {
122
- this.animations.forEach(animation => animation.kill());
123
- this.animations = [];
124
- }
125
-
126
- /**
127
- * @see {@link PlacementAnimation.play}
128
- */
129
- public async animateToPlacement(
130
- mutable: object,
131
- placement: PlacementDefinition | string,
132
- animation?: AnimationDefinition | string
133
- ): Promise<AnimationInterface> {
134
- const _animation = new PlacementAnimation(mutable, placement, animation);
135
- this.animations.push(_animation);
136
- const animationPromise = _animation.play();
137
- animationPromise.then(a => {
138
- remove(this.animations, _a => _a === a);
139
- a.kill();
140
- });
141
- return await animationPromise;
142
- }
143
- }
1
+ import { AnimationInterface } from '../classes/animationInterface';
2
+ import { PlacementAnimation } from '../classes/placementAnimation';
3
+ import { Animation as BabylonAnimation } from '@babylonjs/core/Animations/animation';
4
+ import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
5
+ import { Scene as BabylonScene, Scene } from '@babylonjs/core/scene';
6
+ import { Nullable } from '@babylonjs/core/types';
7
+ //import { CustomEase } from 'gsap/CustomEase';
8
+ //import { ExpoScaleEase, RoughEase, SlowMo } from 'gsap/EasePack';
9
+ import { remove } from 'lodash-es';
10
+
11
+ //gsap.registerPlugin( CustomEase, ExpoScaleEase, RoughEase, SlowMo );
12
+
13
+ export class AnimationManager {
14
+ public animations: AnimationInterface[] = [];
15
+
16
+ /**
17
+ * Constructor.
18
+ */
19
+ protected constructor(protected scene: Scene) {}
20
+
21
+ /**
22
+ * Creates an {@link AnimationManager} based on given BabylonJS scene.
23
+ */
24
+ public static async create(scene: BabylonScene): Promise<AnimationManager> {
25
+ return new AnimationManager(scene);
26
+ }
27
+
28
+ /**
29
+ * @deprecated Use viewer.moveCameraTo().
30
+ */
31
+ public resetCamera(animate: boolean = false) {
32
+ //TODO currently only works for arcrotate. are there any other cameras?
33
+ const activeCamera = this.scene.activeCamera as Nullable<ArcRotateCamera>;
34
+ if (!activeCamera) {
35
+ throw new Error('There is no active camera');
36
+ }
37
+
38
+ const initAlpha = activeCamera.metadata.alpha;
39
+ const initBeta = activeCamera.metadata.beta;
40
+ const initRadius = activeCamera.metadata.radius;
41
+
42
+ if (animate) {
43
+ this.animateArcRotateCamera(initAlpha, initBeta, initRadius);
44
+ } else {
45
+ activeCamera.alpha = initAlpha;
46
+ activeCamera.beta = initBeta;
47
+ activeCamera.radius = initRadius;
48
+ }
49
+ }
50
+
51
+ /**
52
+ * @deprecated Use viewer.moveCameraTo().
53
+ */
54
+ public animateArcRotateCamera(targetAlpha: number, targetBeta: number, targetRadius: number) {
55
+ const activeCamera = this.scene.activeCamera as Nullable<ArcRotateCamera>;
56
+ if (!activeCamera) {
57
+ throw new Error('There is no active camera');
58
+ }
59
+ const alphaAnimation = new BabylonAnimation(
60
+ 'alphaAnimation',
61
+ 'alpha',
62
+ 30,
63
+ BabylonAnimation.ANIMATIONTYPE_FLOAT,
64
+ BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
65
+ );
66
+ const betaAnimation = new BabylonAnimation(
67
+ 'betaAnimation',
68
+ 'beta',
69
+ 30,
70
+ BabylonAnimation.ANIMATIONTYPE_FLOAT,
71
+ BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
72
+ );
73
+ const radiusAnimation = new BabylonAnimation(
74
+ 'radiusAnimation',
75
+ 'radius',
76
+ 30,
77
+ BabylonAnimation.ANIMATIONTYPE_FLOAT,
78
+ BabylonAnimation.ANIMATIONLOOPMODE_CONSTANT
79
+ );
80
+ alphaAnimation.setKeys([
81
+ {
82
+ frame: 0,
83
+ value: activeCamera.alpha,
84
+ },
85
+ {
86
+ frame: 100,
87
+ value: targetAlpha,
88
+ },
89
+ ]);
90
+ betaAnimation.setKeys([
91
+ {
92
+ frame: 0,
93
+ value: activeCamera.beta,
94
+ },
95
+ {
96
+ frame: 100,
97
+ value: targetBeta,
98
+ },
99
+ ]);
100
+ radiusAnimation.setKeys([
101
+ {
102
+ frame: 0,
103
+ value: activeCamera.radius,
104
+ },
105
+ {
106
+ frame: 100,
107
+ value: targetRadius,
108
+ },
109
+ ]);
110
+ activeCamera.animations.push(alphaAnimation);
111
+ activeCamera.animations.push(betaAnimation);
112
+ activeCamera.animations.push(radiusAnimation);
113
+
114
+ const animation = this.scene.beginAnimation(activeCamera, 0, 100, false, 10);
115
+ animation.disposeOnEnd = true;
116
+ }
117
+
118
+ /**
119
+ * Stops and kills all running animations.
120
+ */
121
+ public killAllAnimations() {
122
+ this.animations.forEach(animation => animation.kill());
123
+ this.animations = [];
124
+ }
125
+
126
+ /**
127
+ * @see {@link PlacementAnimation.play}
128
+ */
129
+ public async animateToPlacement(
130
+ mutable: object,
131
+ placement: PlacementDefinition | string,
132
+ animation?: AnimationDefinition | string
133
+ ): Promise<AnimationInterface> {
134
+ const _animation = new PlacementAnimation(mutable, placement, animation);
135
+ this.animations.push(_animation);
136
+ const animationPromise = _animation.play();
137
+ animationPromise.then(a => {
138
+ remove(this.animations, _a => _a === a);
139
+ a.kill();
140
+ });
141
+ return await animationPromise;
142
+ }
143
+ }