@procore/bim-webviewer-sdk 15.4.0 → 15.5.0-rc.1

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 (34) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/Procore.Bim.Webviewer.d.ts +17 -75
  3. package/dist/Procore.Bim.Webviewer.js +1 -1
  4. package/dist/types/src/Webviewer.d.ts +1 -1
  5. package/dist/types/src/controllers/RenderController.d.ts +42 -43
  6. package/dist/types/src/controllers/RenderControllerProxy.d.ts +2 -2
  7. package/dist/types/src/controllers/RenderControllerWorker.d.ts +1 -1
  8. package/dist/types/src/navigation/NavigationModel.d.ts +16 -1
  9. package/dist/types/src/picking/PickingController.d.ts +3 -3
  10. package/dist/types/src/procoregl/Models/Models.d.ts +47 -17
  11. package/dist/types/src/procoregl/Models/__tests__/Models.test.d.ts +6 -1
  12. package/dist/types/src/procoregl/Models/translateVirtualMeshnodeIndex.d.ts +5 -0
  13. package/dist/types/src/procoregl/PartitionsRenderer.d.ts +14 -3
  14. package/dist/types/src/procoregl/PartitionsRendererImpl.d.ts +5 -8
  15. package/dist/types/src/procoregl/{KDTree.d.ts → SceneGraph/KDTree.d.ts} +2 -1
  16. package/dist/types/src/procoregl/{KDTreeNode.d.ts → SceneGraph/KDTreeNode.d.ts} +1 -1
  17. package/dist/types/src/procoregl/SceneGraph/__tests__/WASMTree.test.d.ts +1 -0
  18. package/dist/types/src/procoregl/SceneGraph/utils.d.ts +2 -0
  19. package/dist/types/src/procoregl/ViewerRenderer.d.ts +4 -7
  20. package/dist/types/src/procoregl/__tests__/MockMeshnode.d.ts +1 -0
  21. package/dist/types/src/pwfreader/PWF.d.ts +13 -37
  22. package/dist/types/src/pwfreader/shared/MeshServices.d.ts +1 -1
  23. package/dist/types/src/pwfreader/shared/Meshnode.d.ts +1 -0
  24. package/dist/types/src/pwfreader/streaming/StreamedMeshServices.d.ts +1 -1
  25. package/dist/types/src/utils/DebugGui/MainThreadDebugGui.d.ts +1 -1
  26. package/dist/types/src/utils/DebugGui/WorkerDebugGui.d.ts +1 -1
  27. package/dist/types/src/utils/DebugGui/guifyObject.d.ts +9 -3
  28. package/dist/types/src/utils/ZoomExtents/computeRefinedBbox.d.ts +2 -1
  29. package/dist/types/src/utils/ZoomExtents/createZoomExtentsDebugGui.d.ts +14 -7
  30. package/package.json +1 -1
  31. /package/dist/types/src/procoregl/{__tests__/KDTree.test.d.ts → Models/__tests__/translateVirtualMeshnodeIndex.test.d.ts} +0 -0
  32. /package/dist/types/src/procoregl/{WASMTree.d.ts → SceneGraph/WASMTree.d.ts} +0 -0
  33. /package/dist/types/src/procoregl/{__tests__/KDTreeNode.test.d.ts → SceneGraph/__tests__/KDTree.test.d.ts} +0 -0
  34. /package/dist/types/src/procoregl/{__tests__/WASMTree.test.d.ts → SceneGraph/__tests__/KDTreeNode.test.d.ts} +0 -0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
7
7
 
8
+ ## [15.5.0] - 2024-08-02
9
+
10
+ ### Added
11
+
12
+ - When `Webviewer` is initialized with multiple `resources`, they are now all rendered. Most functionality is not yet working for any resource but the first, but rendering is!
13
+
14
+ ### Fixed
15
+
16
+ - `camera.setPose` now sets the camera based on the "refined global bounding box", which is the global bounding box with "space junk" eliminated, rather than the raw global bounding box.
17
+ - This was a problem because `setPose` could set the camera extremely far from the actual model--to the point where you couldn't see anything--if there was some random object out in the void (i.e. "space junk").
18
+ - The space junk removal algorithm has been improved for models where there is space junk at various distances away. For example, one space junk at 50_000 feet away and one at 10_000 feet away for a model that is only 1000 feet across. The one at 10_000 feet should now be correctly identified as space junk.
19
+
8
20
  ## [15.4.0] - 2024-07-19
9
21
 
10
22
  ### Fixed
@@ -1,6 +1,3 @@
1
- import { Matrix4 } from 'three/src/math/Matrix4';
2
- import { Vector3 as Vector3_2 } from 'three/src/math/Vector3';
3
-
4
1
  export declare const ACTION: {
5
2
  readonly NONE: -1;
6
3
  readonly PAN: 1;
@@ -254,26 +251,6 @@ declare type GPUMeshData = {
254
251
 
255
252
  export declare type HEX = `#${string}`;
256
253
 
257
- declare class KDTree {
258
- private MAX_CHILDREN_PER_NODE;
259
- private readonly root;
260
- private frustum;
261
- private queue;
262
- private readonly result;
263
- constructor();
264
- cullTree(cameraPosition: Vector3_2, frustumMatrix: Matrix4, detailsParam: number): {
265
- opaques: Set<Meshnode>;
266
- transparents: Set<Meshnode>;
267
- };
268
- buildTree(meshnodes: Meshnode[]): {
269
- isComplete: boolean;
270
- };
271
- collectMeshnodes(cameraPosition: Vector3_2, detailsFactor: number): {
272
- opaques: Set<Meshnode>;
273
- transparents: Set<Meshnode>;
274
- };
275
- }
276
-
277
254
  declare interface Logger {
278
255
  logError(error: any): void;
279
256
  }
@@ -364,6 +341,7 @@ declare class Meshnode {
364
341
  isNode(): boolean;
365
342
  isMeshnode(): this is Meshnode;
366
343
  index(): number;
344
+ virtualIndex(): number;
367
345
  meshGeometries(): MeshGeometry[];
368
346
  protected geometries(): MeshGeometry[];
369
347
  private meshData;
@@ -433,7 +411,7 @@ declare class MeshServices {
433
411
  isComplete: boolean;
434
412
  };
435
413
  private loadToGPU;
436
- getMeshVerticesAndFaces(meshOffset: number, _meshnodeOffset: number): MeshVerticesAndFaces;
414
+ getMeshVerticesAndFaces(meshOffset: number): MeshVerticesAndFaces;
437
415
  private loadMeshGeometryToGPU;
438
416
  }
439
417
 
@@ -733,7 +711,6 @@ export declare type PublicNode = {
733
711
  };
734
712
 
735
713
  declare class PWF {
736
- static SMALLEST_OBJECT_AT_10_FEET: number;
737
714
  static timeSince(time: any): string;
738
715
  static isPartitionProxiesAB(meshAB: any): boolean;
739
716
  constructor(params: any);
@@ -743,7 +720,6 @@ declare class PWF {
743
720
  offsetY: number;
744
721
  offsetZ: number;
745
722
  };
746
- sceneGraphName: any;
747
723
  isLogging: any;
748
724
  locale: any;
749
725
  downloadMetaData: any;
@@ -751,7 +727,6 @@ declare class PWF {
751
727
  nodeServices: NodeServices | null;
752
728
  meshnodeServices: StreamedMeshnodeServices | MeshnodeServices | null;
753
729
  meshServices: StreamedMeshServices | MeshServices | null;
754
- sceneGraph: WASMTree | KDTree | null;
755
730
  bvhTree: BVHTree | null;
756
731
  measureSet: any[];
757
732
  _gl: any;
@@ -761,6 +736,13 @@ declare class PWF {
761
736
  detailsInMotion: number;
762
737
  detailsAtRest: number;
763
738
  };
739
+ virtualMeshnodeIndexOffset: number;
740
+ resourceId: any;
741
+ pwfModel: {
742
+ nodes: never[];
743
+ meshnodes: never[];
744
+ meshes: never[];
745
+ };
764
746
  loadPWFVersion(version: any): void;
765
747
  version: typeof V1 | typeof V2 | undefined;
766
748
  setArrayBuffers(nodeAB: any, meshnodeAB: any, meshAB: any): void;
@@ -770,25 +752,10 @@ declare class PWF {
770
752
  meshAB: any;
771
753
  setPartitionedModelBuffers(nodeAB: any, meshnodeAB: any, partitionProxiesAB: any): void;
772
754
  partitionProxiesAB: ArrayBuffer | undefined;
773
- MODEL_PERFORMANCE_DATA: {
774
- model: string;
775
- numFaces: number;
776
- detailsInMotion: number;
777
- }[];
778
- interpolateDetailsFactor(faceCount: any): number | null;
779
- computeDetailsParam(totalFaces: any): {
780
- detailsInMotion: number | null;
781
- detailsAtRest: number;
782
- };
783
755
  getNumPartitions(): number;
784
756
  initPwfParser(): void;
785
757
  pwfModelParser: PWFModelParser | undefined;
786
758
  _numMeshes: number | undefined;
787
- pwfModel: {
788
- nodes: never[];
789
- meshnodes: never[];
790
- meshes: never[];
791
- } | undefined;
792
759
  parsePwfNodes(): {
793
760
  isComplete: boolean;
794
761
  };
@@ -801,21 +768,15 @@ declare class PWF {
801
768
  initMeshnodeServices(): void;
802
769
  initNodeTree(): {
803
770
  nodes: {
804
- [key: string]: Node_2 | Meshnode;
771
+ [key: string]: Meshnode | Node_2;
805
772
  };
806
773
  isComplete: boolean;
807
774
  };
808
775
  initNodeTreeBoundingBoxes(): {
809
776
  isComplete: boolean;
810
777
  };
811
- meshnodes: null;
812
- initSceneGraph(sceneGraphName: any): {
813
- isComplete: boolean;
814
- };
815
- sceneGraphFactory(impl: any): WASMTree | KDTree;
816
778
  allMeshnodes(): Meshnode[];
817
779
  getNodeServices(): NodeServices | null;
818
- getSceneGraph(): WASMTree | KDTree | null;
819
780
  getMeshnodeFromIndex(index: any): Meshnode;
820
781
  getParentNodeIds(nodeId: any): any[];
821
782
  getSubtreeNodeIds(nodeId: any): any[];
@@ -828,9 +789,9 @@ declare class PWF {
828
789
  refresh: boolean | undefined;
829
790
  hasMeasureIds(arr: any): boolean;
830
791
  removeMeasureIds(meshnodeIndices: any): void;
831
- getMeshnodeFromNodeId(nodeId: any): Node_2 | Meshnode;
792
+ getMeshnodeFromNodeId(nodeId: any): Meshnode | Node_2;
832
793
  getMeshnode(offset: any): Meshnode;
833
- getNode(offset: any): Node_2 | Meshnode;
794
+ getNode(offset: any): Meshnode | Node_2;
834
795
  numNodes(): number;
835
796
  numMeshnodes(): number;
836
797
  numMeshes(): number;
@@ -854,14 +815,9 @@ declare class PWF {
854
815
  root(): Node_2;
855
816
  forEachMeshnode(callback: any): void;
856
817
  forEachNode(callback: any): void;
857
- getMeshVerticesAndFaces(meshRef: any, meshnodeOffset: any): MeshVerticesAndFaces;
858
- findFirstObject(meshnodeIndex: any): Node_2;
859
- captureModelStats(): {
860
- [key: string]: any;
861
- };
862
- detailsParam: {
863
- [key: string]: any;
864
- } | undefined;
818
+ getMeshVerticesAndFaces(meshRef: any): MeshVerticesAndFaces;
819
+ findFirstObject(virtualMeshnodeIndex: any): Node_2;
820
+ captureModelStats(): number;
865
821
  captureStandardModelStats(pwfModel: any): number;
866
822
  capturePartitionedModelStats(pwfModel: any): number | undefined;
867
823
  numFirstObjects(): number;
@@ -1030,7 +986,7 @@ declare class StreamedMeshnodeServices extends MeshnodeServices {
1030
986
 
1031
987
  declare class StreamedMeshServices extends MeshServices {
1032
988
  constructor(pwf: PWF);
1033
- getMeshVerticesAndFaces(meshOffset: number, _meshnodeOffset: number): MeshVerticesAndFaces;
989
+ getMeshVerticesAndFaces(meshOffset: number): MeshVerticesAndFaces;
1034
990
  loadPartitionContainingMeshnode(streamedMeshnode: StreamedMeshnode): Promise<void>;
1035
991
  getMeshGeometryForOffsets(meshOffset: number, meshnodeOffset: number): StreamedMeshGeometry | undefined;
1036
992
  }
@@ -1131,20 +1087,6 @@ export declare type Visibility = {
1131
1087
  };
1132
1088
  };
1133
1089
 
1134
- declare class WASMTree {
1135
- static maxChunkSize: number;
1136
- meshnodes: any[];
1137
- currentIndex: number;
1138
- cullTree(cameraPosition: any, projectViewMatrix: any, detailsFactor: any): {
1139
- opaques: Set<any>;
1140
- transparents: Set<any>;
1141
- };
1142
- maxChunkSize: number;
1143
- buildTree(meshnodes: any): {
1144
- isComplete: boolean;
1145
- };
1146
- }
1147
-
1148
1090
  export declare type WebFormatExtractionItem = {
1149
1091
  item_type: 'WebFormat';
1150
1092
  artifact: {
@@ -1266,7 +1208,7 @@ export declare class Webviewer {
1266
1208
  position: Vector3;
1267
1209
  lookAt: Vector3;
1268
1210
  };
1269
- cameraUp?: Vector3 | undefined;
1211
+ cameraUp?: Vector3;
1270
1212
  }) => Promise<void>;
1271
1213
  };
1272
1214
  markup: {