@combeenation/3d-viewer 4.0.0-rc1 → 4.1.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 (103) hide show
  1. package/README.md +114 -114
  2. package/dist/lib-cjs/api/classes/animationInterface.d.ts +8 -8
  3. package/dist/lib-cjs/api/classes/animationInterface.js +1 -1
  4. package/dist/lib-cjs/api/classes/dottedPath.d.ts +79 -79
  5. package/dist/lib-cjs/api/classes/dottedPath.js +190 -190
  6. package/dist/lib-cjs/api/classes/element.d.ts +130 -130
  7. package/dist/lib-cjs/api/classes/element.js +746 -743
  8. package/dist/lib-cjs/api/classes/element.js.map +1 -1
  9. package/dist/lib-cjs/api/classes/elementParameterizable.d.ts +14 -14
  10. package/dist/lib-cjs/api/classes/elementParameterizable.js +134 -134
  11. package/dist/lib-cjs/api/classes/event.d.ts +326 -326
  12. package/dist/lib-cjs/api/classes/event.js +371 -371
  13. package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
  14. package/dist/lib-cjs/api/classes/eventBroadcaster.js +53 -53
  15. package/dist/lib-cjs/api/classes/parameter.d.ts +259 -259
  16. package/dist/lib-cjs/api/classes/parameter.js +387 -387
  17. package/dist/lib-cjs/api/classes/parameter.js.map +1 -1
  18. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  19. package/dist/lib-cjs/api/classes/parameterObservable.js +101 -101
  20. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  21. package/dist/lib-cjs/api/classes/parameterizable.js +149 -149
  22. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +43 -38
  23. package/dist/lib-cjs/api/classes/placementAnimation.js +160 -149
  24. package/dist/lib-cjs/api/classes/placementAnimation.js.map +1 -1
  25. package/dist/lib-cjs/api/classes/variant.d.ts +234 -234
  26. package/dist/lib-cjs/api/classes/variant.js +1147 -1147
  27. package/dist/lib-cjs/api/classes/variantInstance.d.ts +45 -45
  28. package/dist/lib-cjs/api/classes/variantInstance.js +108 -108
  29. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  30. package/dist/lib-cjs/api/classes/variantParameterizable.js +99 -92
  31. package/dist/lib-cjs/api/classes/variantParameterizable.js.map +1 -1
  32. package/dist/lib-cjs/api/classes/viewer.d.ts +131 -131
  33. package/dist/lib-cjs/api/classes/viewer.js +567 -567
  34. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  35. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  36. package/dist/lib-cjs/api/classes/viewerLight.js +392 -389
  37. package/dist/lib-cjs/api/classes/viewerLight.js.map +1 -1
  38. package/dist/lib-cjs/api/internal/debugViewer.d.ts +13 -13
  39. package/dist/lib-cjs/api/internal/debugViewer.js +87 -87
  40. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  41. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  42. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +10 -10
  43. package/dist/lib-cjs/api/internal/sceneSetup.js +231 -231
  44. package/dist/lib-cjs/api/manager/animationManager.d.ts +29 -29
  45. package/dist/lib-cjs/api/manager/animationManager.js +121 -121
  46. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +35 -0
  47. package/dist/lib-cjs/api/manager/gltfExportManager.js +108 -0
  48. package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -0
  49. package/dist/lib-cjs/api/manager/sceneManager.d.ts +32 -32
  50. package/dist/lib-cjs/api/manager/sceneManager.js +132 -132
  51. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +90 -90
  52. package/dist/lib-cjs/api/manager/variantInstanceManager.js +321 -321
  53. package/dist/lib-cjs/api/store/specStorage.d.ts +24 -24
  54. package/dist/lib-cjs/api/store/specStorage.js +51 -51
  55. package/dist/lib-cjs/api/util/babylonHelper.d.ts +166 -175
  56. package/dist/lib-cjs/api/util/babylonHelper.js +500 -520
  57. package/dist/lib-cjs/api/util/babylonHelper.js.map +1 -1
  58. package/dist/lib-cjs/api/util/globalTypes.d.ts +338 -333
  59. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  60. package/dist/lib-cjs/api/util/resourceHelper.d.ts +53 -53
  61. package/dist/lib-cjs/api/util/resourceHelper.js +240 -240
  62. package/dist/lib-cjs/api/util/stringHelper.d.ts +9 -9
  63. package/dist/lib-cjs/api/util/stringHelper.js +25 -25
  64. package/dist/lib-cjs/buildinfo.json +3 -3
  65. package/dist/lib-cjs/index.d.ts +48 -48
  66. package/dist/lib-cjs/index.js +86 -86
  67. package/package.json +83 -83
  68. package/src/api/classes/animationInterface.ts +11 -11
  69. package/src/api/classes/dottedPath.ts +189 -189
  70. package/src/api/classes/element.ts +648 -644
  71. package/src/api/classes/event.ts +370 -370
  72. package/src/api/classes/eventBroadcaster.ts +54 -54
  73. package/src/api/classes/parameter.ts +408 -408
  74. package/src/api/classes/parameterObservable.ts +99 -99
  75. package/src/api/classes/parameterizable.ts +89 -89
  76. package/src/api/classes/placementAnimation.ts +157 -143
  77. package/src/api/classes/variant.ts +817 -817
  78. package/src/api/classes/variantInstance.ts +88 -88
  79. package/src/api/classes/variantParameterizable.ts +80 -73
  80. package/src/api/classes/viewer.ts +487 -487
  81. package/src/api/classes/viewerLight.ts +334 -330
  82. package/src/api/internal/debugViewer.ts +81 -81
  83. package/src/api/internal/lensRendering.ts +10 -10
  84. package/src/api/internal/sceneSetup.ts +193 -193
  85. package/src/api/manager/animationManager.ts +116 -116
  86. package/src/api/manager/sceneManager.ts +105 -105
  87. package/src/api/manager/variantInstanceManager.ts +236 -236
  88. package/src/api/store/specStorage.ts +53 -53
  89. package/src/api/util/babylonHelper.ts +534 -555
  90. package/src/api/util/globalTypes.ts +385 -379
  91. package/src/api/util/resourceHelper.ts +184 -184
  92. package/src/api/util/stringHelper.ts +25 -25
  93. package/src/buildinfo.json +2 -2
  94. package/src/commonjs.tsconfig.json +13 -13
  95. package/src/declaration.tsconfig.json +10 -10
  96. package/src/dev.ts +42 -42
  97. package/src/es6.tsconfig.json +13 -13
  98. package/src/index.ts +91 -91
  99. package/src/pagesconfig.json +65 -61
  100. package/src/tsconfig.json +43 -43
  101. package/src/tsconfig.types.json +9 -9
  102. package/src/types.d.ts +4 -4
  103. package/dist/webpack-stats.json +0 -0
@@ -1,131 +1,131 @@
1
- import { Engine } from '@babylonjs/core/Engines/engine';
2
- import { Mesh } from '@babylonjs/core/Meshes/mesh';
3
- import { Scene } from '@babylonjs/core/scene';
4
- import { AnimationManager } from '../manager/animationManager';
5
- import { SceneManager } from '../manager/sceneManager';
6
- import { VariantInstanceManager } from '../manager/variantInstanceManager';
7
- import { EventBroadcaster } from './eventBroadcaster';
8
- import { VariantInstance } from './variantInstance';
9
- /**
10
- * The main exposed object. This is the entry point into the application
11
- *
12
- * ```js
13
- * const canvas = document.getElementById( 'babylon-canvas' );
14
- * const viewer = Viewer( canvas, '/path/to/index.json' );
15
- * ```
16
- * The class does nothing on its own and needs to {@link bootstrap}
17
- */
18
- export declare class Viewer extends EventBroadcaster {
19
- readonly canvas: HTMLCanvasElement;
20
- protected structureJson: string | StructureJson;
21
- protected _scene: Scene | null;
22
- protected _animationManager: AnimationManager | null;
23
- protected _sceneManager: SceneManager | null;
24
- protected _variantInstances: VariantInstanceManager | null;
25
- static version: string;
26
- /**
27
- * Constructor
28
- */
29
- constructor(canvas: HTMLCanvasElement, structureJson: string | StructureJson);
30
- /**
31
- * Gets the BabylonJS Scene that is attached to the instance.
32
- *
33
- * @throws Error if the `scene` has not been initialized.
34
- */
35
- get scene(): Scene;
36
- get sceneManager(): SceneManager;
37
- /**
38
- * Gets the BabylonJS Engine that is attached to the viewer.
39
- */
40
- get engine(): Engine;
41
- /**
42
- * Gets the {@link VariantInstanceManager} attached to the viewer.
43
- *
44
- * @throws Error if the {@link VariantInstanceManager} has not been initialized.
45
- */
46
- get variantInstances(): VariantInstanceManager;
47
- /**
48
- * Gets the {@link AnimationManager} attached to the viewer.
49
- *
50
- * @throws Error if the {@link AnimationManager} has not been initialized.
51
- */
52
- get animationManager(): AnimationManager;
53
- /**
54
- * Starts the application. This will
55
- * * load the given "index" JSON file
56
- * * setup the scene with the "scene" JSON file
57
- * * create an (optional) default setup with different variant settings
58
- * * sets up resizing by attaching a debounced version of {@link resize}
59
- *
60
- * @throws Error if any of the files is not found/valid
61
- *
62
- * @emits {@link Event.BOOTSTRAP_START}
63
- * @emits {@link Event.BOOTSTRAP_END}
64
- */
65
- bootstrap(): Promise<Viewer>;
66
- /**
67
- * Destroys all registered {@link VariantInstance}s that are registered
68
- */
69
- destroyVariantInstances(): Viewer;
70
- /**
71
- * Trigger a resize event for the `Engine`
72
- */
73
- resize(): Viewer;
74
- /**
75
- * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
76
- * {@link DottedPath}s.
77
- */
78
- getNode(variantInstanceName: string, elementDottedPath: DottedPathArgument, nodeDottedPath: DottedPathArgument): Promise<TransformNode>;
79
- /**
80
- * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
81
- * {@link DottedPath}s.
82
- */
83
- getMesh(variantInstanceName: string, elementDottedPath: DottedPathArgument, meshDottedPath: DottedPathArgument): Promise<Mesh | null>;
84
- /**
85
- * Switches the camera
86
- *
87
- * @emits {@link Event.CAMERA_SWITCHED}
88
- */
89
- switchCamera(newCamera: string, reset?: boolean): Viewer;
90
- /**
91
- * Moves or animates the active camera to given `placement`.
92
- */
93
- moveActiveCameraTo(placement: string | PlacementDefinition, animation?: string | AnimationDefinition): Promise<AnimationInterface>;
94
- /**
95
- * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
96
- */
97
- screenshot(settings?: ScreenshotSettings): Promise<string>;
98
- /**
99
- * Calculates the bounding box from all visible meshes on the scene.
100
- */
101
- calculateBoundingBox(): Promise<Mesh>;
102
- /**
103
- * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning.
104
- */
105
- autofocusActiveCamera(settings?: AutofocusSettings): Promise<void>;
106
- /**
107
- * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
108
- * environment
109
- */
110
- reset(): Promise<Viewer>;
111
- /**
112
- * Destroys
113
- *
114
- * * all {@link VariantInstance}s using {@link destroyVariantInstances}
115
- * * calling `dispose` on the `Engine` and `Scene`
116
- */
117
- destroy(): Viewer;
118
- /**
119
- * Show coordinate system with given dimension (for debugging purpose).
120
- */
121
- showWorldCoordinates(dimension: number): void;
122
- /**
123
- * @emits {@link Event.SCENE_PROCESSING_START}
124
- * @emits {@link Event.SCENE_PROCESSING_END}
125
- */
126
- protected initScene(): Promise<Scene>;
127
- /**
128
- * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
129
- */
130
- protected createVariantInstances(): Promise<VariantInstance[]>;
131
- }
1
+ import { Engine } from '@babylonjs/core/Engines/engine';
2
+ import { Mesh } from '@babylonjs/core/Meshes/mesh';
3
+ import { Scene } from '@babylonjs/core/scene';
4
+ import { AnimationManager } from '../manager/animationManager';
5
+ import { SceneManager } from '../manager/sceneManager';
6
+ import { VariantInstanceManager } from '../manager/variantInstanceManager';
7
+ import { EventBroadcaster } from './eventBroadcaster';
8
+ import { VariantInstance } from './variantInstance';
9
+ /**
10
+ * The main exposed object. This is the entry point into the application
11
+ *
12
+ * ```js
13
+ * const canvas = document.getElementById( 'babylon-canvas' );
14
+ * const viewer = Viewer( canvas, '/path/to/index.json' );
15
+ * ```
16
+ * The class does nothing on its own and needs to {@link bootstrap}
17
+ */
18
+ export declare class Viewer extends EventBroadcaster {
19
+ readonly canvas: HTMLCanvasElement;
20
+ protected structureJson: string | StructureJson;
21
+ protected _scene: Scene | null;
22
+ protected _animationManager: AnimationManager | null;
23
+ protected _sceneManager: SceneManager | null;
24
+ protected _variantInstances: VariantInstanceManager | null;
25
+ static version: string;
26
+ /**
27
+ * Constructor
28
+ */
29
+ constructor(canvas: HTMLCanvasElement, structureJson: string | StructureJson);
30
+ /**
31
+ * Gets the BabylonJS Scene that is attached to the instance.
32
+ *
33
+ * @throws Error if the `scene` has not been initialized.
34
+ */
35
+ get scene(): Scene;
36
+ get sceneManager(): SceneManager;
37
+ /**
38
+ * Gets the BabylonJS Engine that is attached to the viewer.
39
+ */
40
+ get engine(): Engine;
41
+ /**
42
+ * Gets the {@link VariantInstanceManager} attached to the viewer.
43
+ *
44
+ * @throws Error if the {@link VariantInstanceManager} has not been initialized.
45
+ */
46
+ get variantInstances(): VariantInstanceManager;
47
+ /**
48
+ * Gets the {@link AnimationManager} attached to the viewer.
49
+ *
50
+ * @throws Error if the {@link AnimationManager} has not been initialized.
51
+ */
52
+ get animationManager(): AnimationManager;
53
+ /**
54
+ * Starts the application. This will
55
+ * * load the given "index" JSON file
56
+ * * setup the scene with the "scene" JSON file
57
+ * * create an (optional) default setup with different variant settings
58
+ * * sets up resizing by attaching a debounced version of {@link resize}
59
+ *
60
+ * @throws Error if any of the files is not found/valid
61
+ *
62
+ * @emits {@link Event.BOOTSTRAP_START}
63
+ * @emits {@link Event.BOOTSTRAP_END}
64
+ */
65
+ bootstrap(): Promise<Viewer>;
66
+ /**
67
+ * Destroys all registered {@link VariantInstance}s that are registered
68
+ */
69
+ destroyVariantInstances(): Viewer;
70
+ /**
71
+ * Trigger a resize event for the `Engine`
72
+ */
73
+ resize(): Viewer;
74
+ /**
75
+ * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
76
+ * {@link DottedPath}s.
77
+ */
78
+ getNode(variantInstanceName: string, elementDottedPath: DottedPathArgument, nodeDottedPath: DottedPathArgument): Promise<TransformNode>;
79
+ /**
80
+ * A convenience method for directly getting a Node from a {@link VariantInstance} and an {@link Element} by its
81
+ * {@link DottedPath}s.
82
+ */
83
+ getMesh(variantInstanceName: string, elementDottedPath: DottedPathArgument, meshDottedPath: DottedPathArgument): Promise<Mesh | null>;
84
+ /**
85
+ * Switches the camera
86
+ *
87
+ * @emits {@link Event.CAMERA_SWITCHED}
88
+ */
89
+ switchCamera(newCamera: string, reset?: boolean): Viewer;
90
+ /**
91
+ * Moves or animates the active camera to given `placement`.
92
+ */
93
+ moveActiveCameraTo(placement: string | PlacementDefinition, animation?: string | AnimationDefinition): Promise<AnimationInterface>;
94
+ /**
95
+ * Takes a sceenshot the the current scene. The result is a string containing a base64 encoded image
96
+ */
97
+ screenshot(settings?: ScreenshotSettings): Promise<string>;
98
+ /**
99
+ * Calculates the bounding box from all visible meshes on the scene.
100
+ */
101
+ calculateBoundingBox(): Promise<Mesh>;
102
+ /**
103
+ * Focuses the camera to see every visible mesh in scene and tries to optimize wheel precision and panning.
104
+ */
105
+ autofocusActiveCamera(settings?: AutofocusSettings): Promise<void>;
106
+ /**
107
+ * Resets everything by calling {@link destroy} to clear all references and {@link bootstrap} to setup a clean
108
+ * environment
109
+ */
110
+ reset(): Promise<Viewer>;
111
+ /**
112
+ * Destroys
113
+ *
114
+ * * all {@link VariantInstance}s using {@link destroyVariantInstances}
115
+ * * calling `dispose` on the `Engine` and `Scene`
116
+ */
117
+ destroy(): Viewer;
118
+ /**
119
+ * Show coordinate system with given dimension (for debugging purpose).
120
+ */
121
+ showWorldCoordinates(dimension: number): void;
122
+ /**
123
+ * @emits {@link Event.SCENE_PROCESSING_START}
124
+ * @emits {@link Event.SCENE_PROCESSING_END}
125
+ */
126
+ protected initScene(): Promise<Scene>;
127
+ /**
128
+ * Batch creation of multiple {@link VariantInstance} objects with a {@link SetupJson} object passed
129
+ */
130
+ protected createVariantInstances(): Promise<VariantInstance[]>;
131
+ }