@combeenation/3d-viewer 4.0.0-alpha9 → 4.0.0-beta4

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