@combeenation/3d-viewer 12.4.1-beta4 → 12.4.2-rc1

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 (116) hide show
  1. package/README.md +9 -9
  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 +153 -153
  7. package/dist/lib-cjs/api/classes/element.js +702 -702
  8. package/dist/lib-cjs/api/classes/event.d.ts +401 -401
  9. package/dist/lib-cjs/api/classes/event.js +424 -424
  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/fuzzyMap.d.ts +7 -7
  13. package/dist/lib-cjs/api/classes/fuzzyMap.js +21 -21
  14. package/dist/lib-cjs/api/classes/parameter.d.ts +410 -410
  15. package/dist/lib-cjs/api/classes/parameter.js +642 -642
  16. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  17. package/dist/lib-cjs/api/classes/parameterObservable.js +72 -72
  18. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  19. package/dist/lib-cjs/api/classes/parameterizable.js +102 -102
  20. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +45 -45
  21. package/dist/lib-cjs/api/classes/placementAnimation.js +176 -176
  22. package/dist/lib-cjs/api/classes/variant.d.ts +261 -261
  23. package/dist/lib-cjs/api/classes/variant.js +872 -872
  24. package/dist/lib-cjs/api/classes/variantInstance.d.ts +53 -53
  25. package/dist/lib-cjs/api/classes/variantInstance.js +125 -125
  26. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  27. package/dist/lib-cjs/api/classes/variantParameterizable.js +86 -86
  28. package/dist/lib-cjs/api/classes/viewer.d.ts +215 -215
  29. package/dist/lib-cjs/api/classes/viewer.js +708 -727
  30. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  31. package/dist/lib-cjs/api/classes/viewerError.d.ts +43 -43
  32. package/dist/lib-cjs/api/classes/viewerError.js +55 -55
  33. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  34. package/dist/lib-cjs/api/classes/viewerLight.js +344 -344
  35. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  36. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  37. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -13
  38. package/dist/lib-cjs/api/internal/sceneSetup.js +227 -227
  39. package/dist/lib-cjs/api/manager/animationManager.d.ts +30 -30
  40. package/dist/lib-cjs/api/manager/animationManager.js +126 -126
  41. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +89 -80
  42. package/dist/lib-cjs/api/manager/gltfExportManager.js +311 -299
  43. package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -1
  44. package/dist/lib-cjs/api/manager/sceneManager.d.ts +33 -33
  45. package/dist/lib-cjs/api/manager/sceneManager.js +128 -128
  46. package/dist/lib-cjs/api/manager/tagManager.d.ts +118 -118
  47. package/dist/lib-cjs/api/manager/tagManager.js +530 -530
  48. package/dist/lib-cjs/api/manager/textureLoadManager.d.ts +22 -22
  49. package/dist/lib-cjs/api/manager/textureLoadManager.js +107 -98
  50. package/dist/lib-cjs/api/manager/textureLoadManager.js.map +1 -1
  51. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +106 -106
  52. package/dist/lib-cjs/api/manager/variantInstanceManager.js +290 -290
  53. package/dist/lib-cjs/api/store/specStorage.d.ts +32 -32
  54. package/dist/lib-cjs/api/store/specStorage.js +65 -65
  55. package/dist/lib-cjs/api/util/babylonHelper.d.ts +238 -238
  56. package/dist/lib-cjs/api/util/babylonHelper.js +825 -825
  57. package/dist/lib-cjs/api/util/debugHelper.d.ts +9 -9
  58. package/dist/lib-cjs/api/util/debugHelper.js +93 -93
  59. package/dist/lib-cjs/api/util/deviceHelper.d.ts +9 -9
  60. package/dist/lib-cjs/api/util/deviceHelper.js +28 -28
  61. package/dist/lib-cjs/api/util/geometryHelper.d.ts +17 -17
  62. package/dist/lib-cjs/api/util/geometryHelper.js +112 -112
  63. package/dist/lib-cjs/api/util/globalTypes.d.ts +490 -490
  64. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  65. package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -58
  66. package/dist/lib-cjs/api/util/resourceHelper.js +214 -214
  67. package/dist/lib-cjs/api/util/sceneLoaderHelper.d.ts +58 -58
  68. package/dist/lib-cjs/api/util/sceneLoaderHelper.js +228 -228
  69. package/dist/lib-cjs/api/util/stringHelper.d.ts +13 -13
  70. package/dist/lib-cjs/api/util/stringHelper.js +32 -32
  71. package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
  72. package/dist/lib-cjs/api/util/structureHelper.js +57 -57
  73. package/dist/lib-cjs/buildinfo.json +3 -3
  74. package/dist/lib-cjs/commonjs.tsconfig.tsbuildinfo +1 -1
  75. package/dist/lib-cjs/index.d.ts +63 -63
  76. package/dist/lib-cjs/index.js +128 -128
  77. package/package.json +92 -92
  78. package/src/api/classes/animationInterface.ts +10 -10
  79. package/src/api/classes/dottedPath.ts +181 -181
  80. package/src/api/classes/element.ts +766 -766
  81. package/src/api/classes/event.ts +457 -457
  82. package/src/api/classes/eventBroadcaster.ts +52 -52
  83. package/src/api/classes/fuzzyMap.ts +21 -21
  84. package/src/api/classes/parameter.ts +686 -686
  85. package/src/api/classes/parameterObservable.ts +73 -73
  86. package/src/api/classes/parameterizable.ts +87 -87
  87. package/src/api/classes/placementAnimation.ts +162 -162
  88. package/src/api/classes/variant.ts +965 -965
  89. package/src/api/classes/variantInstance.ts +123 -123
  90. package/src/api/classes/variantParameterizable.ts +83 -83
  91. package/src/api/classes/viewer.ts +751 -774
  92. package/src/api/classes/viewerError.ts +63 -63
  93. package/src/api/classes/viewerLight.ts +335 -335
  94. package/src/api/internal/debugViewer.ts +90 -90
  95. package/src/api/internal/lensRendering.ts +9 -9
  96. package/src/api/internal/sceneSetup.ts +208 -208
  97. package/src/api/manager/animationManager.ts +143 -143
  98. package/src/api/manager/gltfExportManager.ts +350 -334
  99. package/src/api/manager/sceneManager.ts +134 -134
  100. package/src/api/manager/tagManager.ts +572 -572
  101. package/src/api/manager/textureLoadManager.ts +107 -96
  102. package/src/api/manager/variantInstanceManager.ts +306 -306
  103. package/src/api/store/specStorage.ts +68 -68
  104. package/src/api/util/babylonHelper.ts +915 -915
  105. package/src/api/util/debugHelper.ts +121 -121
  106. package/src/api/util/deviceHelper.ts +31 -31
  107. package/src/api/util/geometryHelper.ts +142 -142
  108. package/src/api/util/globalTypes.ts +566 -566
  109. package/src/api/util/resourceHelper.ts +201 -201
  110. package/src/api/util/sceneLoaderHelper.ts +247 -247
  111. package/src/api/util/stringHelper.ts +30 -30
  112. package/src/api/util/structureHelper.ts +62 -62
  113. package/src/buildinfo.json +3 -3
  114. package/src/dev.ts +70 -70
  115. package/src/index.ts +116 -116
  116. package/src/types.d.ts +49 -49
@@ -1,153 +1,153 @@
1
- import { VariantParameterizable } from './../classes/variantParameterizable';
2
- import { DottedPath } from './dottedPath';
3
- import { Variant } from './variant';
4
- import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
5
- import { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
6
- import { Mesh } from '@babylonjs/core/Meshes/mesh';
7
- import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
8
- /**
9
- * An {@link Element} of a {@link Variant}. Acts as a container for diverse definitions. Lives only in the context of a
10
- * {@link Variant}.
11
- *
12
- * When used in typings, refer to via its alias {@link VariantElement} to prevent name clashes with the web APIs
13
- * [Element](https://developer.mozilla.org/en-US/docs/Web/API/Element) class
14
- */
15
- export declare class Element extends VariantParameterizable {
16
- readonly variant: Variant;
17
- readonly name: string;
18
- readonly nodes: TransformNode[];
19
- protected readonly _dottedNodes: Map<DottedPath, TransformNode>;
20
- protected _highlightLayer?: HighlightLayer;
21
- /**
22
- * Constructor.
23
- */
24
- protected constructor(variant: Variant, name: string);
25
- /**
26
- * Creates an {@link Element} with given name.
27
- */
28
- static create(variant: Variant, name: string): Promise<Element>;
29
- /**
30
- * The {@link DottedPath} in the built tree of {@link Element}s.
31
- * E.g. "_.top-1.sub-2.sub-sub-3.el-1"
32
- */
33
- get dottedPath(): DottedPath;
34
- /**
35
- * The id representing a {@link DottedPath}.
36
- */
37
- get id(): string;
38
- /**
39
- * The {@link ElementDefinition} of the {@link Element}.
40
- */
41
- get definition(): ElementDefinition;
42
- /**
43
- * The {@link PathDefinitions} of the {@link Element}.
44
- */
45
- get pathDefinitions(): PathDefinitions;
46
- /**
47
- * The {@link TraceableDefinitions} of the {@link Element}.
48
- */
49
- get traceableDefinitions(): TraceableDefinitions;
50
- /**
51
- * The {@link PaintableDefinition} of the {@link Element}.
52
- */
53
- get paintableDefinitions(): PaintableDefinitions;
54
- /**
55
- * The inherited {@link ParameterBag}.
56
- * Merges the {@link Variant}'s parameters and those from the {@link Element}.
57
- */
58
- get inheritedParameters(): ParameterBag;
59
- /**
60
- * The actual {@link TransformNode}s that make up this {@link Element}.
61
- */
62
- get nodesFlat(): TransformNode[];
63
- /**
64
- * The actual {@link Mesh}es that make up this {@link Element}.
65
- * Handy for e.g. creating a bounding box around an entire element.
66
- */
67
- get meshesFlat(): Mesh[];
68
- /**
69
- * The actual {@link AbstractMesh}es that make up this {@link Element}.
70
- * I.e. (real) Meshes as well as InstancedMeshes.
71
- */
72
- get abstractMeshesFlat(): AbstractMesh[];
73
- /**
74
- * The meshes of this {@link Element}.
75
- */
76
- get meshes(): Mesh[];
77
- /**
78
- * @protected
79
- */
80
- set highlightLayer(layer: HighlightLayer | undefined);
81
- get highlightLayer(): HighlightLayer | undefined;
82
- /**
83
- * Destroys this {@link Element} and dispose all nodes.
84
- */
85
- destroy(): Element;
86
- /**
87
- * Gets a node by its {@link DottedPath}.
88
- */
89
- getNode(dottedPath: DottedPathArgument): TransformNode;
90
- /**
91
- * Gets a mesh by its {@link DottedPath}.
92
- */
93
- getMesh(dottedPath: DottedPathArgument): Promise<Mesh | null>;
94
- /**
95
- * Gets a {@link PaintableDefinition} by its name.
96
- */
97
- getPaintableDefinition(name: string): PaintableDefinition;
98
- /**
99
- * Gets a {@link TraceableDefinition} by its name.
100
- */
101
- getTraceableDefinition(name: string): TraceableDefinition;
102
- /**
103
- * Gets the paintable Node by its name.
104
- */
105
- getPaintableNode(name: string): TransformNode;
106
- /**
107
- * Gets the traceable Node by its name.
108
- */
109
- getTraceableNode(name: string): TransformNode;
110
- /**
111
- * @see {@link VariantParameterizable.commitParameters}
112
- * @emit {@link Event.ELEMENT_PARAMETER_COMMITTED}
113
- */
114
- commitParameters(parameters?: ParameterBag): Promise<VariantParameterizable>;
115
- /**
116
- * Adds an observer function for camera matrix changes.
117
- * The `observer` gets 2 parameters: the `AbstractMesh` and a `ClientRect` object.
118
- */
119
- addTraceableObserver(traceable: string, observer: CallableFunction, payload?: any): Element;
120
- /**
121
- * Draws a `ImageBitmap` or `OffscreenCanvas` onto a `paintable` defined via {@link PaintableDefinition}.
122
- */
123
- drawPaintable(paintable: string, imageSource: HTMLImageElement): Element;
124
- /**
125
- * Draws a SVG string onto a `paintable` defined via {@link PaintableDefinition}.
126
- */
127
- drawPaintableFromSvg(paintable: string, svgSource: string): Promise<Element>;
128
- /**
129
- * Draws an Image from source (URL/URI) onto a `paintable` defined via {@link PaintableDefinition}.
130
- */
131
- drawPaintableFromImgSrc(paintable: string, imgSource: string): Promise<Element>;
132
- /**
133
- * Adds observers for loading missing materials where needed
134
- */
135
- protected addMissingMaterialObservers(): void;
136
- /**
137
- * Adds the default {@link ParameterObserver}s which are called every time {@link commitParameters} is called.
138
- */
139
- protected addParameterObservers(): Element;
140
- /**
141
- * Filter for nodes that are not defined or excluded in the `pathDefinitions`.
142
- */
143
- protected filterNode(node: TransformNode): boolean;
144
- /**
145
- * Asserts whether all {@link pathDefinitions} link to a valid `Node` path.
146
- * @protected
147
- */
148
- protected assertPathDefinitions(): void;
149
- /**
150
- * Handles callback for given light parameter.
151
- */
152
- private castShadowValueHandler;
153
- }
1
+ import { VariantParameterizable } from './../classes/variantParameterizable';
2
+ import { DottedPath } from './dottedPath';
3
+ import { Variant } from './variant';
4
+ import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
5
+ import { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
6
+ import { Mesh } from '@babylonjs/core/Meshes/mesh';
7
+ import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
8
+ /**
9
+ * An {@link Element} of a {@link Variant}. Acts as a container for diverse definitions. Lives only in the context of a
10
+ * {@link Variant}.
11
+ *
12
+ * When used in typings, refer to via its alias {@link VariantElement} to prevent name clashes with the web APIs
13
+ * [Element](https://developer.mozilla.org/en-US/docs/Web/API/Element) class
14
+ */
15
+ export declare class Element extends VariantParameterizable {
16
+ readonly variant: Variant;
17
+ readonly name: string;
18
+ readonly nodes: TransformNode[];
19
+ protected readonly _dottedNodes: Map<DottedPath, TransformNode>;
20
+ protected _highlightLayer?: HighlightLayer;
21
+ /**
22
+ * Constructor.
23
+ */
24
+ protected constructor(variant: Variant, name: string);
25
+ /**
26
+ * Creates an {@link Element} with given name.
27
+ */
28
+ static create(variant: Variant, name: string): Promise<Element>;
29
+ /**
30
+ * The {@link DottedPath} in the built tree of {@link Element}s.
31
+ * E.g. "_.top-1.sub-2.sub-sub-3.el-1"
32
+ */
33
+ get dottedPath(): DottedPath;
34
+ /**
35
+ * The id representing a {@link DottedPath}.
36
+ */
37
+ get id(): string;
38
+ /**
39
+ * The {@link ElementDefinition} of the {@link Element}.
40
+ */
41
+ get definition(): ElementDefinition;
42
+ /**
43
+ * The {@link PathDefinitions} of the {@link Element}.
44
+ */
45
+ get pathDefinitions(): PathDefinitions;
46
+ /**
47
+ * The {@link TraceableDefinitions} of the {@link Element}.
48
+ */
49
+ get traceableDefinitions(): TraceableDefinitions;
50
+ /**
51
+ * The {@link PaintableDefinition} of the {@link Element}.
52
+ */
53
+ get paintableDefinitions(): PaintableDefinitions;
54
+ /**
55
+ * The inherited {@link ParameterBag}.
56
+ * Merges the {@link Variant}'s parameters and those from the {@link Element}.
57
+ */
58
+ get inheritedParameters(): ParameterBag;
59
+ /**
60
+ * The actual {@link TransformNode}s that make up this {@link Element}.
61
+ */
62
+ get nodesFlat(): TransformNode[];
63
+ /**
64
+ * The actual {@link Mesh}es that make up this {@link Element}.
65
+ * Handy for e.g. creating a bounding box around an entire element.
66
+ */
67
+ get meshesFlat(): Mesh[];
68
+ /**
69
+ * The actual {@link AbstractMesh}es that make up this {@link Element}.
70
+ * I.e. (real) Meshes as well as InstancedMeshes.
71
+ */
72
+ get abstractMeshesFlat(): AbstractMesh[];
73
+ /**
74
+ * The meshes of this {@link Element}.
75
+ */
76
+ get meshes(): Mesh[];
77
+ /**
78
+ * @protected
79
+ */
80
+ set highlightLayer(layer: HighlightLayer | undefined);
81
+ get highlightLayer(): HighlightLayer | undefined;
82
+ /**
83
+ * Destroys this {@link Element} and dispose all nodes.
84
+ */
85
+ destroy(): Element;
86
+ /**
87
+ * Gets a node by its {@link DottedPath}.
88
+ */
89
+ getNode(dottedPath: DottedPathArgument): TransformNode;
90
+ /**
91
+ * Gets a mesh by its {@link DottedPath}.
92
+ */
93
+ getMesh(dottedPath: DottedPathArgument): Promise<Mesh | null>;
94
+ /**
95
+ * Gets a {@link PaintableDefinition} by its name.
96
+ */
97
+ getPaintableDefinition(name: string): PaintableDefinition;
98
+ /**
99
+ * Gets a {@link TraceableDefinition} by its name.
100
+ */
101
+ getTraceableDefinition(name: string): TraceableDefinition;
102
+ /**
103
+ * Gets the paintable Node by its name.
104
+ */
105
+ getPaintableNode(name: string): TransformNode;
106
+ /**
107
+ * Gets the traceable Node by its name.
108
+ */
109
+ getTraceableNode(name: string): TransformNode;
110
+ /**
111
+ * @see {@link VariantParameterizable.commitParameters}
112
+ * @emit {@link Event.ELEMENT_PARAMETER_COMMITTED}
113
+ */
114
+ commitParameters(parameters?: ParameterBag): Promise<VariantParameterizable>;
115
+ /**
116
+ * Adds an observer function for camera matrix changes.
117
+ * The `observer` gets 2 parameters: the `AbstractMesh` and a `ClientRect` object.
118
+ */
119
+ addTraceableObserver(traceable: string, observer: CallableFunction, payload?: any): Element;
120
+ /**
121
+ * Draws a `ImageBitmap` or `OffscreenCanvas` onto a `paintable` defined via {@link PaintableDefinition}.
122
+ */
123
+ drawPaintable(paintable: string, imageSource: HTMLImageElement): Element;
124
+ /**
125
+ * Draws a SVG string onto a `paintable` defined via {@link PaintableDefinition}.
126
+ */
127
+ drawPaintableFromSvg(paintable: string, svgSource: string): Promise<Element>;
128
+ /**
129
+ * Draws an Image from source (URL/URI) onto a `paintable` defined via {@link PaintableDefinition}.
130
+ */
131
+ drawPaintableFromImgSrc(paintable: string, imgSource: string): Promise<Element>;
132
+ /**
133
+ * Adds observers for loading missing materials where needed
134
+ */
135
+ protected addMissingMaterialObservers(): void;
136
+ /**
137
+ * Adds the default {@link ParameterObserver}s which are called every time {@link commitParameters} is called.
138
+ */
139
+ protected addParameterObservers(): Element;
140
+ /**
141
+ * Filter for nodes that are not defined or excluded in the `pathDefinitions`.
142
+ */
143
+ protected filterNode(node: TransformNode): boolean;
144
+ /**
145
+ * Asserts whether all {@link pathDefinitions} link to a valid `Node` path.
146
+ * @protected
147
+ */
148
+ protected assertPathDefinitions(): void;
149
+ /**
150
+ * Handles callback for given light parameter.
151
+ */
152
+ private castShadowValueHandler;
153
+ }