bimatter-viewer-react 0.5.9 → 0.5.11

package/README.md

@@ -222,94 +222,6 @@ function App() {
 }
 ```
 
-## Viewer API
-
-```ts
-viewerRef.current?.camera.fitCamera();
-viewerRef.current?.camera.getIntersection();
-viewerRef.current?.camera.getIntersection(true);
-
-viewerRef.current?.geometryUtils.showAll();
-viewerRef.current?.geometryUtils.showByIds([1, 2, 3]);
-viewerRef.current?.geometryUtils.hideByIds([1, 2, 3]);
-viewerRef.current?.geometryUtils.hideSelected();
-viewerRef.current?.geometryUtils.isolateByIds([1, 2, 3]);
-viewerRef.current?.geometryUtils.isolateSelected();
-viewerRef.current?.geometryUtils.resetIsolation();
-viewerRef.current?.geometryUtils.getAllIds();
-viewerRef.current?.geometryUtils.setIfcSpacesVisibility(false);
-viewerRef.current?.geometryUtils.getIfcSpacesVisibility();
-viewerRef.current?.geometryUtils.toggleIIfcSpacesVisibility();
-
-viewerRef.current?.selector.setSelected(0, [10, 20], true);
-viewerRef.current?.selector.addSelected(0, [30]);
-viewerRef.current?.selector.removeSelected(0, [10]);
-viewerRef.current?.selector.resetSelection();
-viewerRef.current?.selector.getSelected();
-viewerRef.current?.selector.collector().ofType("IfcWall").toElements();
-viewerRef.current?.selector.setSelectionColor("#1194bd");
-viewerRef.current?.selector.getSelectionColor();
-viewerRef.current?.selector.setPreselectionColor("#68c6e3");
-viewerRef.current?.selector.getPreselectionColor();
-
-viewerRef.current?.colors.setColor(0, [10, 20], "#ff3355");
-viewerRef.current?.colors.clearColor(0, [10]);
-viewerRef.current?.colors.clearModelColors(0);
-viewerRef.current?.colors.clearAllColors();
-
-viewerRef.current?.converter.convertToBmt({
-    activeView: true,
-    useMinVersion: true,
-});
-viewerRef.current?.converter.convertIfcFileToBmt(files, {
-    useIfcColors: true,
-    useIfcElementAssembly: true,
-    useIfcSpace: true,
-    useMinVersion: true,
-});
-
-viewerRef.current?.clipping.createPlane();
-viewerRef.current?.clipping.createClippingRectangle();
-viewerRef.current?.clipping.toggle();
-viewerRef.current?.clipping.setActive(true);
-viewerRef.current?.clipping.setEdgesActive(true);
-viewerRef.current?.clipping.setHelpersActive(true);
-viewerRef.current?.clipping.deleteAllPlanes();
-
-viewerRef.current?.dimensions.setActive(true);
-viewerRef.current?.dimensions.toggle();
-viewerRef.current?.dimensions.cancelDrawing();
-viewerRef.current?.dimensions.changeAxes();
-viewerRef.current?.dimensions.delete();
-viewerRef.current?.dimensions.deleteAll();
-viewerRef.current?.dimensions.setUnit("mm");
-viewerRef.current?.dimensions.setColor("#111827");
-viewerRef.current?.dimensions.setWidth(1);
-viewerRef.current?.dimensions.setSnapDistance(1);
-viewerRef.current?.dimensions.setEndpointScaleFactor(0.015);
-viewerRef.current?.dimensions.getDimensions();
-
-viewerRef.current?.properties.getModelProps();
-viewerRef.current?.properties.getModelStructure();
-viewerRef.current?.properties.exportExcel(0);
-viewerRef.current?.properties.exportAllExcel();
-viewerRef.current?.utils.getUserDevice();
-viewerRef.current?.utils.getDefaultHotkeysEnabled();
-viewerRef.current?.utils.setDefaultHotkeysEnabled(false);
-viewerRef.current?.utils.toggleDefaultHotkeys();
-viewerRef.current?.utils.getShowStats();
-viewerRef.current?.utils.setShowStats(true);
-viewerRef.current?.utils.getShowNavCube();
-viewerRef.current?.utils.setShowNavCube(false);
-viewerRef.current?.utils.toggleShowNavCube();
-viewerRef.current?.utils.getShowGridAxes();
-viewerRef.current?.utils.setShowGridAxes(true);
-viewerRef.current?.utils.toggleShowGridAxes();
-viewerRef.current?.utils.getGridAxesVisibility();
-viewerRef.current?.utils.setGridAxesVisibility({ top: false, bottom: true });
-viewerRef.current?.utils.setGridAxisVisibility("left", false);
-```
-
 ## Geometry Utils
 
 Use `ref` to call viewer actions:
@@ -522,12 +434,25 @@ const basicWallIds = viewerRef.current?.selector
     .ofType("IfcWall")
     .Where((element) => element.props.Name.startsWith("basic wall"))
     .toElementsIds();
+
+const levels = viewerRef.current?.properties.getAllLevels(true);
+const firstLevel = levels?.[0]?.[0];
+
+const firstLevelWallIds = firstLevel
+    ? viewerRef.current?.selector
+          .collector()
+          .ofLevel(firstLevel)
+          .ofType("IfcWall")
+          .toElementsIds()
+    : [];
 ```
 
 Without `ofModel()`, `toElements()` returns `{ [modelID]: { elementID, props }[] }` and `toElementsIds()` returns `{ [modelID]: number[] }`.
 
 With `ofModel(0)`, `toElements()` returns `{ elementID, props }[]` and `toElementsIds()` returns `number[]`.
 
+With `ofLevel(level)`, `toElements()` returns `{ elementID, props }[]` and `toElementsIds()` returns `number[]`. Use `properties.getAllLevels(true)` so each level includes `elements`.
+
 `ofType()` accepts `IfcClass | string`, so TypeScript suggests IFC classes like `"IfcWall"` while still allowing custom type strings.
 
 ## Stats And Profiling

package/lib/api/ViewerApi.d.ts

@@ -24,7 +24,7 @@ export type ViewerGeometryUtilsApi = {
     toggleIIfcSpacesVisibility: () => void;
 };
 export type ViewerSelectorApi = {
-    addSelected: (modelID: number, ids: number[]) => void;
+    addSelected: (modelID: number, ids: number[], setTarget?: boolean, fitTarget?: boolean) => void;
     collector: () => FilteredElementsCollector;
     getPreselectionColor: () => ColorRepresentation;
     getSelectionColor: () => ColorRepresentation;
@@ -33,7 +33,10 @@ export type ViewerSelectorApi = {
     resetSelection: (modelID?: number) => void;
     setPreselectionColor: (color: ColorRepresentation) => void;
     setSelectionColor: (color: ColorRepresentation) => void;
-    setSelected: (modelID: number, ids: number[], reset?: boolean) => void;
+    setSelected: (modelID: number, ids: number[], reset?: boolean, setTarget?: boolean, fitTarget?: boolean) => void;
+};
+export type ViewerSceneSelectorApi = {
+    setTargetToSelection: (selection: ViewerSelection, fitTarget?: boolean) => void;
 };
 export type ViewerColorsApi = {
     clearAllColors: () => void;
@@ -85,6 +88,7 @@ export type ViewerSceneApi = {
     converter: ViewerConverterApi;
     dimensions: ViewerDimensionsApi;
     geometryUtils: ViewerGeometryUtilsApi;
+    selector: ViewerSceneSelectorApi;
 };
 export declare function serializeSelected(selected: SelectedStore): ViewerSelection;
 export declare function createSelectedStore(selection: ViewerSelection): SelectedStore;