@combeenation/3d-viewer 9.2.1-alpha1 → 10.0.0-alpha3

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 (113) hide show
  1. package/README.md +9 -111
  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 +666 -667
  8. package/dist/lib-cjs/api/classes/element.js.map +1 -1
  9. package/dist/lib-cjs/api/classes/event.d.ts +401 -401
  10. package/dist/lib-cjs/api/classes/event.js +424 -424
  11. package/dist/lib-cjs/api/classes/eventBroadcaster.d.ts +26 -26
  12. package/dist/lib-cjs/api/classes/eventBroadcaster.js +49 -49
  13. package/dist/lib-cjs/api/classes/fuzzyMap.d.ts +7 -7
  14. package/dist/lib-cjs/api/classes/fuzzyMap.js +21 -21
  15. package/dist/lib-cjs/api/classes/parameter.d.ts +410 -410
  16. package/dist/lib-cjs/api/classes/parameter.js +642 -642
  17. package/dist/lib-cjs/api/classes/parameterObservable.d.ts +36 -36
  18. package/dist/lib-cjs/api/classes/parameterObservable.js +72 -72
  19. package/dist/lib-cjs/api/classes/parameterizable.d.ts +15 -15
  20. package/dist/lib-cjs/api/classes/parameterizable.js +102 -102
  21. package/dist/lib-cjs/api/classes/placementAnimation.d.ts +45 -45
  22. package/dist/lib-cjs/api/classes/placementAnimation.js +176 -176
  23. package/dist/lib-cjs/api/classes/variant.d.ts +261 -261
  24. package/dist/lib-cjs/api/classes/variant.js +871 -870
  25. package/dist/lib-cjs/api/classes/variant.js.map +1 -1
  26. package/dist/lib-cjs/api/classes/variantInstance.d.ts +53 -53
  27. package/dist/lib-cjs/api/classes/variantInstance.js +125 -125
  28. package/dist/lib-cjs/api/classes/variantParameterizable.d.ts +17 -17
  29. package/dist/lib-cjs/api/classes/variantParameterizable.js +86 -86
  30. package/dist/lib-cjs/api/classes/viewer.d.ts +211 -213
  31. package/dist/lib-cjs/api/classes/viewer.js +736 -717
  32. package/dist/lib-cjs/api/classes/viewer.js.map +1 -1
  33. package/dist/lib-cjs/api/classes/viewerError.d.ts +43 -43
  34. package/dist/lib-cjs/api/classes/viewerError.js +55 -55
  35. package/dist/lib-cjs/api/classes/viewerLight.d.ts +66 -66
  36. package/dist/lib-cjs/api/classes/viewerLight.js +344 -348
  37. package/dist/lib-cjs/api/classes/viewerLight.js.map +1 -1
  38. package/dist/lib-cjs/api/internal/lensRendering.d.ts +8 -8
  39. package/dist/lib-cjs/api/internal/lensRendering.js +11 -11
  40. package/dist/lib-cjs/api/internal/sceneSetup.d.ts +13 -13
  41. package/dist/lib-cjs/api/internal/sceneSetup.js +224 -226
  42. package/dist/lib-cjs/api/internal/sceneSetup.js.map +1 -1
  43. package/dist/lib-cjs/api/manager/animationManager.d.ts +30 -30
  44. package/dist/lib-cjs/api/manager/animationManager.js +126 -126
  45. package/dist/lib-cjs/api/manager/gltfExportManager.d.ts +102 -102
  46. package/dist/lib-cjs/api/manager/gltfExportManager.js +322 -316
  47. package/dist/lib-cjs/api/manager/gltfExportManager.js.map +1 -1
  48. package/dist/lib-cjs/api/manager/sceneManager.d.ts +33 -33
  49. package/dist/lib-cjs/api/manager/sceneManager.js +128 -128
  50. package/dist/lib-cjs/api/manager/tagManager.d.ts +118 -118
  51. package/dist/lib-cjs/api/manager/tagManager.js +535 -535
  52. package/dist/lib-cjs/api/manager/textureLoadManager.d.ts +22 -22
  53. package/dist/lib-cjs/api/manager/textureLoadManager.js +98 -98
  54. package/dist/lib-cjs/api/manager/variantInstanceManager.d.ts +106 -106
  55. package/dist/lib-cjs/api/manager/variantInstanceManager.js +290 -290
  56. package/dist/lib-cjs/api/store/specStorage.d.ts +32 -32
  57. package/dist/lib-cjs/api/store/specStorage.js +65 -65
  58. package/dist/lib-cjs/api/util/babylonHelper.d.ts +238 -238
  59. package/dist/lib-cjs/api/util/babylonHelper.js +826 -826
  60. package/dist/lib-cjs/api/util/geometryHelper.d.ts +7 -7
  61. package/dist/lib-cjs/api/util/geometryHelper.js +115 -115
  62. package/dist/lib-cjs/api/util/globalTypes.d.ts +484 -484
  63. package/dist/lib-cjs/api/util/globalTypes.js +1 -1
  64. package/dist/lib-cjs/api/util/resourceHelper.d.ts +58 -58
  65. package/dist/lib-cjs/api/util/resourceHelper.js +214 -214
  66. package/dist/lib-cjs/api/util/sceneLoaderHelper.d.ts +44 -44
  67. package/dist/lib-cjs/api/util/sceneLoaderHelper.js +175 -175
  68. package/dist/lib-cjs/api/util/stringHelper.d.ts +13 -13
  69. package/dist/lib-cjs/api/util/stringHelper.js +32 -32
  70. package/dist/lib-cjs/api/util/structureHelper.d.ts +9 -9
  71. package/dist/lib-cjs/api/util/structureHelper.js +64 -64
  72. package/dist/lib-cjs/buildinfo.json +3 -3
  73. package/dist/lib-cjs/commonjs.tsconfig.tsbuildinfo +1 -1
  74. package/dist/lib-cjs/index.d.ts +54 -54
  75. package/dist/lib-cjs/index.js +117 -117
  76. package/package.json +84 -82
  77. package/src/api/classes/animationInterface.ts +10 -10
  78. package/src/api/classes/dottedPath.ts +181 -181
  79. package/src/api/classes/element.ts +723 -723
  80. package/src/api/classes/event.ts +457 -457
  81. package/src/api/classes/eventBroadcaster.ts +52 -52
  82. package/src/api/classes/fuzzyMap.ts +21 -21
  83. package/src/api/classes/parameter.ts +686 -686
  84. package/src/api/classes/parameterObservable.ts +73 -73
  85. package/src/api/classes/parameterizable.ts +87 -87
  86. package/src/api/classes/placementAnimation.ts +162 -162
  87. package/src/api/classes/variant.ts +964 -963
  88. package/src/api/classes/variantInstance.ts +123 -123
  89. package/src/api/classes/variantParameterizable.ts +83 -83
  90. package/src/api/classes/viewer.ts +786 -770
  91. package/src/api/classes/viewerError.ts +63 -63
  92. package/src/api/classes/viewerLight.ts +335 -339
  93. package/src/api/internal/debugViewer.ts +90 -90
  94. package/src/api/internal/lensRendering.ts +9 -9
  95. package/src/api/internal/sceneSetup.ts +203 -205
  96. package/src/api/manager/animationManager.ts +143 -143
  97. package/src/api/manager/gltfExportManager.ts +312 -306
  98. package/src/api/manager/sceneManager.ts +134 -134
  99. package/src/api/manager/tagManager.ts +576 -576
  100. package/src/api/manager/textureLoadManager.ts +96 -96
  101. package/src/api/manager/variantInstanceManager.ts +306 -306
  102. package/src/api/store/specStorage.ts +68 -68
  103. package/src/api/util/babylonHelper.ts +915 -915
  104. package/src/api/util/geometryHelper.ts +140 -140
  105. package/src/api/util/globalTypes.ts +560 -560
  106. package/src/api/util/resourceHelper.ts +201 -201
  107. package/src/api/util/sceneLoaderHelper.ts +170 -170
  108. package/src/api/util/stringHelper.ts +30 -30
  109. package/src/api/util/structureHelper.ts +63 -63
  110. package/src/buildinfo.json +3 -3
  111. package/src/dev.ts +70 -62
  112. package/src/index.ts +103 -103
  113. package/src/types.d.ts +49 -38
@@ -1,140 +1,140 @@
1
- import { MorphTargetManager } from '@babylonjs/core';
2
- import { VertexBuffer } from '@babylonjs/core/Buffers/buffer';
3
- import { Vector3 } from '@babylonjs/core/Maths/math.vector';
4
- import type { Geometry } from '@babylonjs/core/Meshes';
5
- import { InstancedMesh } from '@babylonjs/core/Meshes/instancedMesh';
6
- import { Mesh } from '@babylonjs/core/Meshes/mesh';
7
- import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
8
- import type { MorphTarget } from '@babylonjs/core/Morph';
9
- import type { FloatArray } from '@babylonjs/core/types';
10
-
11
- /**
12
- * Removes morph targets and sets transformation values back to their default values.
13
- * The effects from morph targets and tranformation values will be "baked" in the geometry, so that the final appearance
14
- * of the meshes stay the same.
15
- */
16
- const bakeGeometryOfAllMeshes = function (scene: Scene) {
17
- // instanced meshes have to be converted, since they share the geometry of the source mesh, which would lead to issues
18
- // when baking the transformation values
19
- scene.meshes.forEach(mesh => {
20
- if (mesh instanceof InstancedMesh) {
21
- convertInstancedMeshToMesh(mesh);
22
- }
23
- });
24
-
25
- // do the geometry baking for all meshes in the scene
26
- scene.meshes.forEach(mesh => {
27
- if (mesh instanceof Mesh) {
28
- bakeGeometryOfMesh(mesh);
29
- }
30
- });
31
-
32
- // some nodes (mostly transform nodes), are not affected by the baking algorithm since they have no geometry
33
- // => reset their transformation manually
34
- const allNodes = scene.getNodes().filter(node => node instanceof TransformNode) as TransformNode[];
35
- allNodes.forEach(node => {
36
- resetTransformation(node);
37
- });
38
- };
39
-
40
- const convertInstancedMeshToMesh = function (instancedMesh: InstancedMesh) {
41
- // first create a clone of the source mesh
42
- const newMesh = instancedMesh.sourceMesh.clone(`${instancedMesh.name}`, instancedMesh.parent);
43
- // apply the transformation data
44
- newMesh.position = instancedMesh.position;
45
- newMesh.rotation = instancedMesh.rotation;
46
- newMesh.rotationQuaternion = instancedMesh.rotationQuaternion;
47
- newMesh.scaling = instancedMesh.scaling;
48
- // also sync the enabled state from the original instanced mesh
49
- newMesh.setEnabled(instancedMesh.isEnabled(false));
50
-
51
- // re-assign children of the original mesh, since that one won't be used anymore
52
- instancedMesh.getChildren(undefined).forEach(childNode => (childNode.parent = newMesh));
53
- // finally delete the original instanced mesh
54
- instancedMesh.dispose();
55
- };
56
-
57
- const bakeGeometryOfMesh = function (mesh: Mesh) {
58
- if (!mesh.geometry) {
59
- // no geometry available, nothing to do
60
- return;
61
- }
62
-
63
- // geometries can be shared across multiple meshes, first make them unique to avoid side-effects
64
- mesh.makeGeometryUnique();
65
-
66
- const morphTargetManager = mesh.morphTargetManager;
67
- const geometry = mesh.geometry;
68
-
69
- if (morphTargetManager?.numTargets) {
70
- // apply morph target vertices data to mesh geometry
71
- // mostly only the "PositionKind" is implemented
72
- bakeMorphTargetManagerIntoVertices(VertexBuffer.PositionKind, morphTargetManager, geometry);
73
- bakeMorphTargetManagerIntoVertices(VertexBuffer.NormalKind, morphTargetManager, geometry);
74
- bakeMorphTargetManagerIntoVertices(VertexBuffer.TangentKind, morphTargetManager, geometry);
75
- bakeMorphTargetManagerIntoVertices(VertexBuffer.UVKind, morphTargetManager, geometry);
76
-
77
- // remove morph target manager with all it's morph targets
78
- mesh.morphTargetManager = null;
79
- }
80
-
81
- // bake the transformation data in the mesh geometry, fortunately there is already a help function from Babylon.js
82
- mesh.bakeCurrentTransformIntoVertices();
83
- };
84
-
85
- /**
86
- * @param kind morph targets can affect various vertices kinds, whereas "position" is the most common one
87
- * still other kinds (like normals or tangents) can be affected as well and can be provided on this input
88
- */
89
- const bakeMorphTargetManagerIntoVertices = function (
90
- kind: string,
91
- morphTargetManager: MorphTargetManager,
92
- geometry: Geometry
93
- ) {
94
- const origVerticesData = geometry.getVerticesData(kind);
95
- if (!origVerticesData) {
96
- // no vertices data for this kind availabe on the mesh geometry
97
- return;
98
- }
99
-
100
- let verticesData = [...origVerticesData];
101
- for (let i = 0; i < morphTargetManager.numTargets; i++) {
102
- const target = morphTargetManager.getTarget(i);
103
- const targetVerticesData = getVerticesDataFromMorphTarget(kind, target);
104
- if (targetVerticesData) {
105
- // vertices data of this kind are implemented on the morph target
106
- // add the influence of this morph target to the vertices data
107
- // formula is taken from: https://doc.babylonjs.com/features/featuresDeepDive/mesh/morphTargets#basics
108
- verticesData = verticesData.map(
109
- (oldVal, idx) => oldVal + (targetVerticesData[idx] - origVerticesData[idx]) * target.influence
110
- );
111
- }
112
- }
113
-
114
- // apply the updated vertices data
115
- geometry.setVerticesData(kind, verticesData);
116
- };
117
-
118
- const getVerticesDataFromMorphTarget = function (kind: string, morphTarget: MorphTarget): Nullable<FloatArray> {
119
- switch (kind) {
120
- case VertexBuffer.PositionKind:
121
- return morphTarget.getPositions();
122
- case VertexBuffer.NormalKind:
123
- return morphTarget.getNormals();
124
- case VertexBuffer.TangentKind:
125
- return morphTarget.getTangents();
126
- case VertexBuffer.UVKind:
127
- return morphTarget.getUVs();
128
- }
129
-
130
- return null;
131
- };
132
-
133
- const resetTransformation = function (node: TransformNode) {
134
- node.position = new Vector3(0, 0, 0);
135
- node.rotation = new Vector3(0, 0, 0);
136
- node.rotationQuaternion = null;
137
- node.scaling = new Vector3(1, 1, 1);
138
- };
139
-
140
- export { bakeGeometryOfAllMeshes };
1
+ import { MorphTargetManager } from '@babylonjs/core';
2
+ import { VertexBuffer } from '@babylonjs/core/Buffers/buffer';
3
+ import { Vector3 } from '@babylonjs/core/Maths/math.vector';
4
+ import type { Geometry } from '@babylonjs/core/Meshes';
5
+ import { InstancedMesh } from '@babylonjs/core/Meshes/instancedMesh';
6
+ import { Mesh } from '@babylonjs/core/Meshes/mesh';
7
+ import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
8
+ import type { MorphTarget } from '@babylonjs/core/Morph';
9
+ import type { FloatArray } from '@babylonjs/core/types';
10
+
11
+ /**
12
+ * Removes morph targets and sets transformation values back to their default values.
13
+ * The effects from morph targets and tranformation values will be "baked" in the geometry, so that the final appearance
14
+ * of the meshes stay the same.
15
+ */
16
+ const bakeGeometryOfAllMeshes = function (scene: Scene) {
17
+ // instanced meshes have to be converted, since they share the geometry of the source mesh, which would lead to issues
18
+ // when baking the transformation values
19
+ scene.meshes.forEach(mesh => {
20
+ if (mesh instanceof InstancedMesh) {
21
+ convertInstancedMeshToMesh(mesh);
22
+ }
23
+ });
24
+
25
+ // do the geometry baking for all meshes in the scene
26
+ scene.meshes.forEach(mesh => {
27
+ if (mesh instanceof Mesh) {
28
+ bakeGeometryOfMesh(mesh);
29
+ }
30
+ });
31
+
32
+ // some nodes (mostly transform nodes), are not affected by the baking algorithm since they have no geometry
33
+ // => reset their transformation manually
34
+ const allNodes = scene.getNodes().filter(node => node instanceof TransformNode) as TransformNode[];
35
+ allNodes.forEach(node => {
36
+ resetTransformation(node);
37
+ });
38
+ };
39
+
40
+ const convertInstancedMeshToMesh = function (instancedMesh: InstancedMesh) {
41
+ // first create a clone of the source mesh
42
+ const newMesh = instancedMesh.sourceMesh.clone(`${instancedMesh.name}`, instancedMesh.parent);
43
+ // apply the transformation data
44
+ newMesh.position = instancedMesh.position;
45
+ newMesh.rotation = instancedMesh.rotation;
46
+ newMesh.rotationQuaternion = instancedMesh.rotationQuaternion;
47
+ newMesh.scaling = instancedMesh.scaling;
48
+ // also sync the enabled state from the original instanced mesh
49
+ newMesh.setEnabled(instancedMesh.isEnabled(false));
50
+
51
+ // re-assign children of the original mesh, since that one won't be used anymore
52
+ instancedMesh.getChildren(undefined).forEach(childNode => (childNode.parent = newMesh));
53
+ // finally delete the original instanced mesh
54
+ instancedMesh.dispose();
55
+ };
56
+
57
+ const bakeGeometryOfMesh = function (mesh: Mesh) {
58
+ if (!mesh.geometry) {
59
+ // no geometry available, nothing to do
60
+ return;
61
+ }
62
+
63
+ // geometries can be shared across multiple meshes, first make them unique to avoid side-effects
64
+ mesh.makeGeometryUnique();
65
+
66
+ const morphTargetManager = mesh.morphTargetManager;
67
+ const geometry = mesh.geometry;
68
+
69
+ if (morphTargetManager?.numTargets) {
70
+ // apply morph target vertices data to mesh geometry
71
+ // mostly only the "PositionKind" is implemented
72
+ bakeMorphTargetManagerIntoVertices(VertexBuffer.PositionKind, morphTargetManager, geometry);
73
+ bakeMorphTargetManagerIntoVertices(VertexBuffer.NormalKind, morphTargetManager, geometry);
74
+ bakeMorphTargetManagerIntoVertices(VertexBuffer.TangentKind, morphTargetManager, geometry);
75
+ bakeMorphTargetManagerIntoVertices(VertexBuffer.UVKind, morphTargetManager, geometry);
76
+
77
+ // remove morph target manager with all it's morph targets
78
+ mesh.morphTargetManager = null;
79
+ }
80
+
81
+ // bake the transformation data in the mesh geometry, fortunately there is already a help function from Babylon.js
82
+ mesh.bakeCurrentTransformIntoVertices();
83
+ };
84
+
85
+ /**
86
+ * @param kind morph targets can affect various vertices kinds, whereas "position" is the most common one
87
+ * still other kinds (like normals or tangents) can be affected as well and can be provided on this input
88
+ */
89
+ const bakeMorphTargetManagerIntoVertices = function (
90
+ kind: string,
91
+ morphTargetManager: MorphTargetManager,
92
+ geometry: Geometry
93
+ ) {
94
+ const origVerticesData = geometry.getVerticesData(kind);
95
+ if (!origVerticesData) {
96
+ // no vertices data for this kind availabe on the mesh geometry
97
+ return;
98
+ }
99
+
100
+ let verticesData = [...origVerticesData];
101
+ for (let i = 0; i < morphTargetManager.numTargets; i++) {
102
+ const target = morphTargetManager.getTarget(i);
103
+ const targetVerticesData = getVerticesDataFromMorphTarget(kind, target);
104
+ if (targetVerticesData) {
105
+ // vertices data of this kind are implemented on the morph target
106
+ // add the influence of this morph target to the vertices data
107
+ // formula is taken from: https://doc.babylonjs.com/features/featuresDeepDive/mesh/morphTargets#basics
108
+ verticesData = verticesData.map(
109
+ (oldVal, idx) => oldVal + (targetVerticesData[idx] - origVerticesData[idx]) * target.influence
110
+ );
111
+ }
112
+ }
113
+
114
+ // apply the updated vertices data
115
+ geometry.setVerticesData(kind, verticesData);
116
+ };
117
+
118
+ const getVerticesDataFromMorphTarget = function (kind: string, morphTarget: MorphTarget): Nullable<FloatArray> {
119
+ switch (kind) {
120
+ case VertexBuffer.PositionKind:
121
+ return morphTarget.getPositions();
122
+ case VertexBuffer.NormalKind:
123
+ return morphTarget.getNormals();
124
+ case VertexBuffer.TangentKind:
125
+ return morphTarget.getTangents();
126
+ case VertexBuffer.UVKind:
127
+ return morphTarget.getUVs();
128
+ }
129
+
130
+ return null;
131
+ };
132
+
133
+ const resetTransformation = function (node: TransformNode) {
134
+ node.position = new Vector3(0, 0, 0);
135
+ node.rotation = new Vector3(0, 0, 0);
136
+ node.rotationQuaternion = null;
137
+ node.scaling = new Vector3(1, 1, 1);
138
+ };
139
+
140
+ export { bakeGeometryOfAllMeshes };