@combeenation/3d-viewer 12.4.1 → 12.4.3
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.
- package/README.md +9 -9
- package/dist/lib-cjs/api/classes/animationInterface.d.ts +8 -8
- package/dist/lib-cjs/api/classes/animationInterface.js +2 -2
- package/dist/lib-cjs/api/classes/dottedPath.d.ts +79 -79
- package/dist/lib-cjs/api/classes/dottedPath.js +166 -166
- package/dist/lib-cjs/api/classes/element.d.ts +153 -153
- package/dist/lib-cjs/api/classes/element.js +702 -702
- package/dist/lib-cjs/api/classes/event.d.ts +401 -401
- package/dist/lib-cjs/api/classes/event.js +424 -424
- package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
- package/dist/lib-cjs/api/classes/eventBroadcaster.js +49 -49
- package/dist/lib-cjs/api/classes/fuzzyMap.d.ts +7 -7
- package/dist/lib-cjs/api/classes/fuzzyMap.js +21 -21
- package/dist/lib-cjs/api/classes/parameter.d.ts +410 -410
- package/dist/lib-cjs/api/classes/parameter.js +642 -642
- package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
- package/dist/lib-cjs/api/classes/parameterObservable.js +72 -72
- package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
- package/dist/lib-cjs/api/classes/parameterizable.js +102 -102
- package/dist/lib-cjs/api/classes/placementAnimation.d.ts +45 -45
- package/dist/lib-cjs/api/classes/placementAnimation.js +176 -176
- package/dist/lib-cjs/api/classes/variant.d.ts +261 -261
- package/dist/lib-cjs/api/classes/variant.js +872 -872
- package/dist/lib-cjs/api/classes/variantInstance.d.ts +53 -53
- package/dist/lib-cjs/api/classes/variantInstance.js +125 -125
- package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
- package/dist/lib-cjs/api/classes/variantParameterizable.js +86 -86
- package/dist/lib-cjs/api/classes/viewer.d.ts +215 -215
- package/dist/lib-cjs/api/classes/viewer.js +708 -708
- package/dist/lib-cjs/api/classes/viewerError.d.ts +43 -43
- package/dist/lib-cjs/api/classes/viewerError.js +55 -55
- package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
- package/dist/lib-cjs/api/classes/viewerLight.js +344 -344
- package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
- package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
- package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -13
- package/dist/lib-cjs/api/internal/sceneSetup.js +227 -227
- package/dist/lib-cjs/api/manager/animationManager.d.ts +30 -30
- package/dist/lib-cjs/api/manager/animationManager.js +126 -126
- package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +80 -80
- package/dist/lib-cjs/api/manager/gltfExportManager.js +300 -299
- package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -1
- package/dist/lib-cjs/api/manager/sceneManager.d.ts +33 -33
- package/dist/lib-cjs/api/manager/sceneManager.js +128 -128
- package/dist/lib-cjs/api/manager/tagManager.d.ts +118 -118
- package/dist/lib-cjs/api/manager/tagManager.js +530 -530
- package/dist/lib-cjs/api/manager/textureLoadManager.d.ts +22 -22
- package/dist/lib-cjs/api/manager/textureLoadManager.js +107 -107
- package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +106 -106
- package/dist/lib-cjs/api/manager/variantInstanceManager.js +290 -290
- package/dist/lib-cjs/api/store/specStorage.d.ts +32 -32
- package/dist/lib-cjs/api/store/specStorage.js +65 -65
- package/dist/lib-cjs/api/util/babylonHelper.d.ts +238 -238
- package/dist/lib-cjs/api/util/babylonHelper.js +825 -825
- package/dist/lib-cjs/api/util/debugHelper.d.ts +9 -9
- package/dist/lib-cjs/api/util/debugHelper.js +93 -93
- package/dist/lib-cjs/api/util/deviceHelper.d.ts +9 -9
- package/dist/lib-cjs/api/util/deviceHelper.js +28 -28
- package/dist/lib-cjs/api/util/geometryHelper.d.ts +17 -17
- package/dist/lib-cjs/api/util/geometryHelper.js +112 -112
- package/dist/lib-cjs/api/util/globalTypes.d.ts +490 -490
- package/dist/lib-cjs/api/util/globalTypes.js +1 -1
- package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -58
- package/dist/lib-cjs/api/util/resourceHelper.js +214 -214
- package/dist/lib-cjs/api/util/sceneLoaderHelper.d.ts +58 -58
- package/dist/lib-cjs/api/util/sceneLoaderHelper.js +228 -228
- package/dist/lib-cjs/api/util/stringHelper.d.ts +13 -13
- package/dist/lib-cjs/api/util/stringHelper.js +32 -32
- package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
- package/dist/lib-cjs/api/util/structureHelper.js +57 -57
- package/dist/lib-cjs/buildinfo.json +3 -3
- package/dist/lib-cjs/commonjs.tsconfig.tsbuildinfo +1 -1
- package/dist/lib-cjs/index.d.ts +63 -63
- package/dist/lib-cjs/index.js +128 -128
- package/package.json +93 -92
- package/src/api/classes/animationInterface.ts +10 -10
- package/src/api/classes/dottedPath.ts +181 -181
- package/src/api/classes/element.ts +766 -766
- package/src/api/classes/event.ts +457 -457
- package/src/api/classes/eventBroadcaster.ts +52 -52
- package/src/api/classes/fuzzyMap.ts +21 -21
- package/src/api/classes/parameter.ts +686 -686
- package/src/api/classes/parameterObservable.ts +73 -73
- package/src/api/classes/parameterizable.ts +87 -87
- package/src/api/classes/placementAnimation.ts +162 -162
- package/src/api/classes/variant.ts +965 -965
- package/src/api/classes/variantInstance.ts +123 -123
- package/src/api/classes/variantParameterizable.ts +83 -83
- package/src/api/classes/viewer.ts +751 -751
- package/src/api/classes/viewerError.ts +63 -63
- package/src/api/classes/viewerLight.ts +335 -335
- package/src/api/internal/debugViewer.ts +90 -90
- package/src/api/internal/lensRendering.ts +9 -9
- package/src/api/internal/sceneSetup.ts +208 -208
- package/src/api/manager/animationManager.ts +143 -143
- package/src/api/manager/gltfExportManager.ts +337 -334
- package/src/api/manager/sceneManager.ts +134 -134
- package/src/api/manager/tagManager.ts +572 -572
- package/src/api/manager/textureLoadManager.ts +107 -107
- package/src/api/manager/variantInstanceManager.ts +306 -306
- package/src/api/store/specStorage.ts +68 -68
- package/src/api/util/babylonHelper.ts +915 -915
- package/src/api/util/debugHelper.ts +121 -121
- package/src/api/util/deviceHelper.ts +31 -31
- package/src/api/util/geometryHelper.ts +142 -142
- package/src/api/util/globalTypes.ts +566 -566
- package/src/api/util/resourceHelper.ts +201 -201
- package/src/api/util/sceneLoaderHelper.ts +247 -247
- package/src/api/util/stringHelper.ts +30 -30
- package/src/api/util/structureHelper.ts +62 -62
- package/src/buildinfo.json +3 -3
- package/src/dev.ts +70 -70
- package/src/index.ts +116 -116
- package/src/types.d.ts +49 -49
|
@@ -1,134 +1,134 @@
|
|
|
1
|
-
import { Event } from '../classes/event';
|
|
2
|
-
import { Parameter } from '../classes/parameter';
|
|
3
|
-
import { ParameterObservable } from '../classes/parameterObservable';
|
|
4
|
-
import { SpecStorage } from '../store/specStorage';
|
|
5
|
-
import { changeEnvironment } from '../util/babylonHelper';
|
|
6
|
-
import { mergeMaps } from '../util/resourceHelper';
|
|
7
|
-
import { TextureLoadManager } from './textureLoadManager';
|
|
8
|
-
import { Camera } from '@babylonjs/core/Cameras/camera';
|
|
9
|
-
import { Scene as BabylonScene } from '@babylonjs/core/scene';
|
|
10
|
-
import { cloneDeep, concat, merge } from 'lodash-es';
|
|
11
|
-
|
|
12
|
-
export class SceneManager extends ParameterObservable {
|
|
13
|
-
protected readonly _parameterObservers: Map<string, ParameterObserver[]> = new Map();
|
|
14
|
-
|
|
15
|
-
protected _textureLoadManager: TextureLoadManager | null = null;
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
* Constructor.
|
|
19
|
-
*/
|
|
20
|
-
protected constructor(public scene: BabylonScene) {
|
|
21
|
-
super();
|
|
22
|
-
this._textureLoadManager = TextureLoadManager.create(scene);
|
|
23
|
-
this.addParameterObservers();
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* Creates a {@link SceneManager} based on given Babylon.js scene.
|
|
28
|
-
*/
|
|
29
|
-
public static async create(scene: BabylonScene): Promise<SceneManager> {
|
|
30
|
-
const sceneManager = new SceneManager(scene);
|
|
31
|
-
|
|
32
|
-
await sceneManager.bootstrapParameters(SpecStorage.get<ParameterBag>('scene.parameters'));
|
|
33
|
-
return sceneManager;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
/**
|
|
37
|
-
* The active `Camera`.
|
|
38
|
-
*/
|
|
39
|
-
get activeCamera(): Camera {
|
|
40
|
-
if (!this.scene.activeCamera) {
|
|
41
|
-
throw new Error('Scene has no active camera.');
|
|
42
|
-
}
|
|
43
|
-
return this.scene.activeCamera;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
/**
|
|
47
|
-
* Places the given {@link ParameterBag} in the {@link SceneManager}'s parameters, replaces all patterns in the
|
|
48
|
-
* {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
|
|
49
|
-
*
|
|
50
|
-
* @emit {@link Event.SCENE_PARAMETER_COMMITTED}
|
|
51
|
-
*/
|
|
52
|
-
public async commitParameters(parameters?: ParameterBag): Promise<SceneManager> {
|
|
53
|
-
if (!parameters) {
|
|
54
|
-
parameters = {};
|
|
55
|
-
}
|
|
56
|
-
const oldParameters = cloneDeep(this.parameters);
|
|
57
|
-
merge(this.parameters, parameters);
|
|
58
|
-
|
|
59
|
-
// handle parameter observers
|
|
60
|
-
let observerPromises: Promise<ParameterObserverResult>[] = [];
|
|
61
|
-
for (const parameter in this.parameters) {
|
|
62
|
-
const oldParameterValue = oldParameters[parameter];
|
|
63
|
-
const newParameterValue = this.parameters[parameter];
|
|
64
|
-
this.assertParameter(Parameter.declarations, parameter, newParameterValue);
|
|
65
|
-
if (oldParameterValue === newParameterValue) {
|
|
66
|
-
continue;
|
|
67
|
-
}
|
|
68
|
-
// parameter changed
|
|
69
|
-
const parameterObservers = mergeMaps(this._parameterObservers, this.parameterObservers);
|
|
70
|
-
if (parameterObservers.has(parameter)) {
|
|
71
|
-
const observers = parameterObservers.get(parameter)!;
|
|
72
|
-
observerPromises = concat(
|
|
73
|
-
observerPromises,
|
|
74
|
-
observers.map(observer => {
|
|
75
|
-
const observerPromise = observer(this, oldParameterValue, newParameterValue);
|
|
76
|
-
return Promise.resolve(observerPromise).then(() => {
|
|
77
|
-
this.broadcastEvent(
|
|
78
|
-
Event.SCENE_PARAMETER_COMMITTED,
|
|
79
|
-
this,
|
|
80
|
-
parameter,
|
|
81
|
-
oldParameterValue,
|
|
82
|
-
newParameterValue
|
|
83
|
-
);
|
|
84
|
-
});
|
|
85
|
-
})
|
|
86
|
-
);
|
|
87
|
-
}
|
|
88
|
-
}
|
|
89
|
-
await Promise.all(observerPromises);
|
|
90
|
-
return this;
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
protected addParameterObservers(): SceneManager {
|
|
94
|
-
const handleEnvParamChange = async (
|
|
95
|
-
manager: SceneManager,
|
|
96
|
-
oldValue: Undefinable<ParameterValue>,
|
|
97
|
-
newValue: ParameterValue
|
|
98
|
-
) => {
|
|
99
|
-
const params = {
|
|
100
|
-
color: manager.parameters[Parameter.ENVIRONMENT_COLOR],
|
|
101
|
-
intensity: manager.parameters[Parameter.ENVIRONMENT_INTENSITY],
|
|
102
|
-
env: manager.parameters[Parameter.ENVIRONMENT],
|
|
103
|
-
background: manager.parameters[Parameter.ENVIRONMENT_BACKGROUND],
|
|
104
|
-
rotation: manager.parameters[Parameter.ENVIRONMENT_ROTATION],
|
|
105
|
-
useDefault: manager.parameters[Parameter.ENVIRONMENT_USEDEFAULT],
|
|
106
|
-
};
|
|
107
|
-
const envDef: EnvironmentDefinition = {
|
|
108
|
-
environmentColor: params.color ? Parameter.parseColor(params.color) : undefined,
|
|
109
|
-
environmentIntensity: params.intensity !== undefined ? Parameter.parseNumber(params.intensity) : undefined,
|
|
110
|
-
environment: params.env ? (params.env as string) : undefined,
|
|
111
|
-
environmentBackground: params.background ? (params.background as string) : undefined,
|
|
112
|
-
environmentRotation: params.rotation !== undefined ? Parameter.parseNumber(params.rotation) : undefined,
|
|
113
|
-
environmentUseDefault: params.useDefault ? Parameter.parseBoolean(params.useDefault) : undefined,
|
|
114
|
-
};
|
|
115
|
-
changeEnvironment(manager.scene, envDef);
|
|
116
|
-
};
|
|
117
|
-
|
|
118
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT_COLOR, [handleEnvParamChange]);
|
|
119
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT_ROTATION, [handleEnvParamChange]);
|
|
120
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT_USEDEFAULT, [handleEnvParamChange]);
|
|
121
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT, [handleEnvParamChange]);
|
|
122
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT_BACKGROUND, [handleEnvParamChange]);
|
|
123
|
-
this._parameterObservers.set(Parameter.ENVIRONMENT_INTENSITY, [handleEnvParamChange]);
|
|
124
|
-
return this;
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
/**
|
|
128
|
-
* Bootstrapping for parameters. It sets the `parametersInitialized` to true for all ancestors.
|
|
129
|
-
*/
|
|
130
|
-
protected async bootstrapParameters(parameters?: ParameterBag): Promise<SceneManager> {
|
|
131
|
-
await this.commitParameters(merge(cloneDeep(this.parameters), parameters));
|
|
132
|
-
return this;
|
|
133
|
-
}
|
|
134
|
-
}
|
|
1
|
+
import { Event } from '../classes/event';
|
|
2
|
+
import { Parameter } from '../classes/parameter';
|
|
3
|
+
import { ParameterObservable } from '../classes/parameterObservable';
|
|
4
|
+
import { SpecStorage } from '../store/specStorage';
|
|
5
|
+
import { changeEnvironment } from '../util/babylonHelper';
|
|
6
|
+
import { mergeMaps } from '../util/resourceHelper';
|
|
7
|
+
import { TextureLoadManager } from './textureLoadManager';
|
|
8
|
+
import { Camera } from '@babylonjs/core/Cameras/camera';
|
|
9
|
+
import { Scene as BabylonScene } from '@babylonjs/core/scene';
|
|
10
|
+
import { cloneDeep, concat, merge } from 'lodash-es';
|
|
11
|
+
|
|
12
|
+
export class SceneManager extends ParameterObservable {
|
|
13
|
+
protected readonly _parameterObservers: Map<string, ParameterObserver[]> = new Map();
|
|
14
|
+
|
|
15
|
+
protected _textureLoadManager: TextureLoadManager | null = null;
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Constructor.
|
|
19
|
+
*/
|
|
20
|
+
protected constructor(public scene: BabylonScene) {
|
|
21
|
+
super();
|
|
22
|
+
this._textureLoadManager = TextureLoadManager.create(scene);
|
|
23
|
+
this.addParameterObservers();
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Creates a {@link SceneManager} based on given Babylon.js scene.
|
|
28
|
+
*/
|
|
29
|
+
public static async create(scene: BabylonScene): Promise<SceneManager> {
|
|
30
|
+
const sceneManager = new SceneManager(scene);
|
|
31
|
+
|
|
32
|
+
await sceneManager.bootstrapParameters(SpecStorage.get<ParameterBag>('scene.parameters'));
|
|
33
|
+
return sceneManager;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* The active `Camera`.
|
|
38
|
+
*/
|
|
39
|
+
get activeCamera(): Camera {
|
|
40
|
+
if (!this.scene.activeCamera) {
|
|
41
|
+
throw new Error('Scene has no active camera.');
|
|
42
|
+
}
|
|
43
|
+
return this.scene.activeCamera;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Places the given {@link ParameterBag} in the {@link SceneManager}'s parameters, replaces all patterns in the
|
|
48
|
+
* {@link StructureJson} and broadcasts all {@link ParameterObserver}s.
|
|
49
|
+
*
|
|
50
|
+
* @emit {@link Event.SCENE_PARAMETER_COMMITTED}
|
|
51
|
+
*/
|
|
52
|
+
public async commitParameters(parameters?: ParameterBag): Promise<SceneManager> {
|
|
53
|
+
if (!parameters) {
|
|
54
|
+
parameters = {};
|
|
55
|
+
}
|
|
56
|
+
const oldParameters = cloneDeep(this.parameters);
|
|
57
|
+
merge(this.parameters, parameters);
|
|
58
|
+
|
|
59
|
+
// handle parameter observers
|
|
60
|
+
let observerPromises: Promise<ParameterObserverResult>[] = [];
|
|
61
|
+
for (const parameter in this.parameters) {
|
|
62
|
+
const oldParameterValue = oldParameters[parameter];
|
|
63
|
+
const newParameterValue = this.parameters[parameter];
|
|
64
|
+
this.assertParameter(Parameter.declarations, parameter, newParameterValue);
|
|
65
|
+
if (oldParameterValue === newParameterValue) {
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
// parameter changed
|
|
69
|
+
const parameterObservers = mergeMaps(this._parameterObservers, this.parameterObservers);
|
|
70
|
+
if (parameterObservers.has(parameter)) {
|
|
71
|
+
const observers = parameterObservers.get(parameter)!;
|
|
72
|
+
observerPromises = concat(
|
|
73
|
+
observerPromises,
|
|
74
|
+
observers.map(observer => {
|
|
75
|
+
const observerPromise = observer(this, oldParameterValue, newParameterValue);
|
|
76
|
+
return Promise.resolve(observerPromise).then(() => {
|
|
77
|
+
this.broadcastEvent(
|
|
78
|
+
Event.SCENE_PARAMETER_COMMITTED,
|
|
79
|
+
this,
|
|
80
|
+
parameter,
|
|
81
|
+
oldParameterValue,
|
|
82
|
+
newParameterValue
|
|
83
|
+
);
|
|
84
|
+
});
|
|
85
|
+
})
|
|
86
|
+
);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
await Promise.all(observerPromises);
|
|
90
|
+
return this;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
protected addParameterObservers(): SceneManager {
|
|
94
|
+
const handleEnvParamChange = async (
|
|
95
|
+
manager: SceneManager,
|
|
96
|
+
oldValue: Undefinable<ParameterValue>,
|
|
97
|
+
newValue: ParameterValue
|
|
98
|
+
) => {
|
|
99
|
+
const params = {
|
|
100
|
+
color: manager.parameters[Parameter.ENVIRONMENT_COLOR],
|
|
101
|
+
intensity: manager.parameters[Parameter.ENVIRONMENT_INTENSITY],
|
|
102
|
+
env: manager.parameters[Parameter.ENVIRONMENT],
|
|
103
|
+
background: manager.parameters[Parameter.ENVIRONMENT_BACKGROUND],
|
|
104
|
+
rotation: manager.parameters[Parameter.ENVIRONMENT_ROTATION],
|
|
105
|
+
useDefault: manager.parameters[Parameter.ENVIRONMENT_USEDEFAULT],
|
|
106
|
+
};
|
|
107
|
+
const envDef: EnvironmentDefinition = {
|
|
108
|
+
environmentColor: params.color ? Parameter.parseColor(params.color) : undefined,
|
|
109
|
+
environmentIntensity: params.intensity !== undefined ? Parameter.parseNumber(params.intensity) : undefined,
|
|
110
|
+
environment: params.env ? (params.env as string) : undefined,
|
|
111
|
+
environmentBackground: params.background ? (params.background as string) : undefined,
|
|
112
|
+
environmentRotation: params.rotation !== undefined ? Parameter.parseNumber(params.rotation) : undefined,
|
|
113
|
+
environmentUseDefault: params.useDefault ? Parameter.parseBoolean(params.useDefault) : undefined,
|
|
114
|
+
};
|
|
115
|
+
changeEnvironment(manager.scene, envDef);
|
|
116
|
+
};
|
|
117
|
+
|
|
118
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT_COLOR, [handleEnvParamChange]);
|
|
119
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT_ROTATION, [handleEnvParamChange]);
|
|
120
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT_USEDEFAULT, [handleEnvParamChange]);
|
|
121
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT, [handleEnvParamChange]);
|
|
122
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT_BACKGROUND, [handleEnvParamChange]);
|
|
123
|
+
this._parameterObservers.set(Parameter.ENVIRONMENT_INTENSITY, [handleEnvParamChange]);
|
|
124
|
+
return this;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Bootstrapping for parameters. It sets the `parametersInitialized` to true for all ancestors.
|
|
129
|
+
*/
|
|
130
|
+
protected async bootstrapParameters(parameters?: ParameterBag): Promise<SceneManager> {
|
|
131
|
+
await this.commitParameters(merge(cloneDeep(this.parameters), parameters));
|
|
132
|
+
return this;
|
|
133
|
+
}
|
|
134
|
+
}
|