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

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 (106) hide show
  1. package/README.md +114 -112
  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 -125
  7. package/dist/lib-cjs/api/classes/element.js +743 -682
  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 -312
  12. package/dist/lib-cjs/api/classes/event.js +371 -357
  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 +259 -165
  17. package/dist/lib-cjs/api/classes/parameter.js +387 -267
  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 +101 -126
  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 +149 -138
  26. package/dist/lib-cjs/api/classes/placementAnimation.js.map +1 -1
  27. package/dist/lib-cjs/api/classes/variant.d.ts +234 -190
  28. package/dist/lib-cjs/api/classes/variant.js +1147 -873
  29. package/dist/lib-cjs/api/classes/variant.js.map +1 -1
  30. package/dist/lib-cjs/api/classes/variantInstance.d.ts +45 -41
  31. package/dist/lib-cjs/api/classes/variantInstance.js +108 -98
  32. package/dist/lib-cjs/api/classes/variantInstance.js.map +1 -1
  33. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  34. package/dist/lib-cjs/api/classes/variantParameterizable.js +92 -92
  35. package/dist/lib-cjs/api/classes/viewer.d.ts +131 -128
  36. package/dist/lib-cjs/api/classes/viewer.js +560 -486
  37. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  38. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -65
  39. package/dist/lib-cjs/api/classes/viewerLight.js +389 -322
  40. package/dist/lib-cjs/api/classes/viewerLight.js.map +1 -1
  41. package/dist/lib-cjs/api/internal/debugViewer.d.ts +13 -13
  42. package/dist/lib-cjs/api/internal/debugViewer.js +87 -87
  43. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  44. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  45. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +10 -6
  46. package/dist/lib-cjs/api/internal/sceneSetup.js +231 -227
  47. package/dist/lib-cjs/api/internal/sceneSetup.js.map +1 -1
  48. package/dist/lib-cjs/api/manager/animationManager.d.ts +29 -29
  49. package/dist/lib-cjs/api/manager/animationManager.js +121 -121
  50. package/dist/lib-cjs/api/manager/sceneManager.d.ts +32 -32
  51. package/dist/lib-cjs/api/manager/sceneManager.js +132 -132
  52. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +90 -90
  53. package/dist/lib-cjs/api/manager/variantInstanceManager.js +321 -321
  54. package/dist/lib-cjs/api/store/specStorage.d.ts +24 -24
  55. package/dist/lib-cjs/api/store/specStorage.js +51 -51
  56. package/dist/lib-cjs/api/util/babylonHelper.d.ts +175 -125
  57. package/dist/lib-cjs/api/util/babylonHelper.js +520 -368
  58. package/dist/lib-cjs/api/util/babylonHelper.js.map +1 -1
  59. package/dist/lib-cjs/api/util/globalTypes.d.ts +333 -279
  60. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  61. package/dist/lib-cjs/api/util/resourceHelper.d.ts +53 -51
  62. package/dist/lib-cjs/api/util/resourceHelper.js +240 -243
  63. package/dist/lib-cjs/api/util/resourceHelper.js.map +1 -1
  64. package/dist/lib-cjs/api/util/stringHelper.d.ts +9 -9
  65. package/dist/lib-cjs/api/util/stringHelper.js +25 -25
  66. package/dist/lib-cjs/buildinfo.json +3 -3
  67. package/dist/lib-cjs/index.d.ts +48 -46
  68. package/dist/lib-cjs/index.js +86 -82
  69. package/dist/lib-cjs/index.js.map +1 -1
  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 +644 -617
  74. package/src/api/classes/event.ts +370 -355
  75. package/src/api/classes/eventBroadcaster.ts +54 -54
  76. package/src/api/classes/parameter.ts +408 -277
  77. package/src/api/classes/parameterObservable.ts +99 -121
  78. package/src/api/classes/{elementParameterizable.ts → parameterizable.ts} +89 -78
  79. package/src/api/classes/placementAnimation.ts +143 -133
  80. package/src/api/classes/variant.ts +817 -670
  81. package/src/api/classes/variantInstance.ts +88 -81
  82. package/src/api/classes/variantParameterizable.ts +73 -0
  83. package/src/api/classes/viewer.ts +478 -421
  84. package/src/api/classes/viewerLight.ts +330 -0
  85. package/src/api/internal/debugViewer.ts +81 -81
  86. package/src/api/internal/lensRendering.ts +10 -10
  87. package/src/api/internal/sceneSetup.ts +194 -204
  88. package/src/api/manager/animationManager.ts +116 -116
  89. package/src/api/manager/sceneManager.ts +105 -105
  90. package/src/api/manager/variantInstanceManager.ts +236 -236
  91. package/src/api/store/specStorage.ts +53 -53
  92. package/src/api/util/babylonHelper.ts +553 -392
  93. package/src/api/util/globalTypes.ts +380 -319
  94. package/src/api/util/resourceHelper.ts +184 -187
  95. package/src/api/util/stringHelper.ts +26 -0
  96. package/src/buildinfo.json +2 -2
  97. package/src/commonjs.tsconfig.json +13 -13
  98. package/src/declaration.tsconfig.json +10 -10
  99. package/src/dev.ts +42 -46
  100. package/src/es6.tsconfig.json +13 -13
  101. package/src/index.ts +91 -87
  102. package/src/pagesconfig.json +61 -57
  103. package/src/tsconfig.json +43 -43
  104. package/src/tsconfig.types.json +9 -9
  105. package/src/types.d.ts +4 -4
  106. package/dist/webpack-stats.json +0 -0
@@ -1,128 +1,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
- }
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
+ }