@inweb/viewer-visualize 25.9.8 → 25.11.0

package/lib/Viewer/Commands/index.d.ts

@@ -1,5 +1,6 @@
 import "./ApplyModelTransform";
 import "./ClearMarkup";
+import "./ClearSelected";
 import "./ClearSlices";
 import "./CreatePreview";
 import "./Explode";
@@ -16,7 +17,6 @@ import "./SetDefaultViewPosition";
 import "./SetMarkupColor";
 import "./SetSelected";
 import "./ShowAll";
-import "./Unselect";
 import "./ZoomToExtents";
 import "./ZoomToObjects";
 import "./ZoomToSelected";

package/lib/Viewer/Draggers/Actions/PanAction.d.ts

@@ -10,8 +10,8 @@ export declare class PanAction {
     private _getViewParams;
     private _setViewParams;
     constructor(m_module: any, subject: Viewer, beginInteractivity: () => void, endInteractivity: () => void, getViewParams: () => ViewParams, setViewParams: (params: ViewParams) => void);
-    beginAction(x: number, y: number): void;
-    action(x: number, y: number): void;
+    beginAction(x: number, y: number, absoluteX: number, absoluteY: number): void;
+    action(x: number, y: number, absoluteX: number, absoluteY: number): void;
     endAction(): void;
     private screenToWorld;
 }

package/lib/Viewer/Draggers/Actions/ZoomAction.d.ts

@@ -3,5 +3,5 @@ export declare class ZoomAction {
     private _m_module;
     private _subject;
     constructor(m_module: any, subject: Viewer);
-    action(x: number, y: number, zoomFactor: number): void;
+    action(x: number, y: number, zoomFactor: number, absoluteX: number, absoluteY: number): void;
 }

package/lib/Viewer/Draggers/Common/OdBaseDragger.d.ts

@@ -23,7 +23,7 @@ export declare class OdBaseDragger extends OdaGeAction {
     protected dblclick(ev: MouseEvent): void;
     protected start(x: number, y: number, absoluteX?: number, absoluteY?: number): void;
     protected drag(x: number, y: number, absoluteX?: number, absoluteY?: number): void;
-    protected end(x: number, y: number): void;
+    protected end(x: number, y: number, absoluteX?: number, absoluteY?: number): void;
     protected beginInteractivity: () => void;
     protected endInteractivity: () => void;
     protected getActiveMarkupEntity(entityName: string): any;

package/lib/Viewer/Draggers/MeasureLineDragger/index.d.ts

@@ -10,6 +10,8 @@ export declare class MeasureLineDragger extends OdBaseDragger {
     protected items: MeasureLineItem[];
     protected m_overlayElement: HTMLElement;
     protected previewMeasureLine: MeasureLineItem;
+    protected conversionFactor: number;
+    protected oldRulerUnit: string;
     constructor(subject: Viewer);
     initialize(): void;
     dispose(): void;
@@ -21,4 +23,6 @@ export declare class MeasureLineDragger extends OdBaseDragger {
     end(): void;
     createNewMeasureIfNeed(): void;
     createMeasureLine(): MeasureLineItem;
+    optionsChange(event: any): void;
+    getKUnitByName(unitName: string): any;
 }

package/lib/Viewer/Draggers/OdOrbitDragger.d.ts

@@ -9,6 +9,6 @@ export declare class OdOrbitDragger extends OdBaseDragger {
     constructor(subject: Viewer);
     start(x: number, y: number): void;
     setDefaultViewParams(): void;
-    drag(x: number, y: number, dltX: number, dltY: number): void;
+    drag(x: number, y: number): void;
     end(): void;
 }

package/lib/Viewer/Draggers/OdPanDragger.d.ts

@@ -5,7 +5,7 @@ export declare class OdPanDragger extends OdBaseDragger {
     private _panAction;
     protected m_start: Point3d;
     constructor(subject: Viewer);
-    start(x: number, y: number): void;
-    drag(x: number, y: number, dltX: number, dltY: number): void;
+    start(x: number, y: number, absoluteX: number, absoluteY: number): void;
+    drag(x: number, y: number, absoluteX: number, absoluteY: number): void;
     end(x: number, y: number): void;
 }

package/lib/Viewer/Draggers/OdZoomDragger.d.ts

@@ -4,8 +4,11 @@ export declare class OdZoomDragger extends OdBaseDragger {
     private _zoomAction;
     protected pressX: number;
     protected pressY: number;
+    protected absoluteX: number;
+    protected absoluteY: number;
+    protected prevY: number;
     constructor(subject: Viewer);
-    start(x: number, y: number): void;
-    drag(x: number, y: number, dltX: number, dltY: number): void;
+    start(x: number, y: number, absoluteX?: number, absoluteY?: number): void;
+    drag(x: number, y: number): void;
     end(): void;
 }

package/lib/Viewer/Draggers/OdZoomWindowDragger/index.d.ts

@@ -8,6 +8,6 @@ export declare class OdZoomWindowDragger extends OdBaseDragger {
     protected m_maxY: number;
     constructor(subject: Viewer);
     start(x: number, y: number): void;
-    drag(x: number, y: number, dltX: number, dltY: number): void;
+    drag(x: number, y: number): void;
     end(x: number, y: number): void;
 }

package/lib/Viewer/Draggers/OrbitAroundBuildingDragger.d.ts

@@ -12,7 +12,7 @@ export declare class OrbitAroundBuildingDragger extends OdBaseDragger {
     constructor(viewer: Viewer);
     start(x: number, y: number): void;
     setDefaultViewParams(): void;
-    drag(x: number, y: number, dltX: number, dltY: number): void;
+    drag(x: number, y: number): void;
     end(): void;
     getCenter(): any;
 }

package/lib/Viewer/Viewer.d.ts

@@ -82,6 +82,7 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      *
      * Fires:
      *
+     * - {@link InitializeEvent | initialize}
      * - {@link InitializeProgressEvent | initializeprogress}
      *
      * @param canvas -
@@ -91,10 +92,6 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      *   of the `VisualizeJS` library.
      */
     initialize(canvas: HTMLCanvasElement, onProgress?: (event: ProgressEvent) => void): Promise<this>;
-    /**
-     * Unloads an open file, clears the canvas and markups, and releases resources allocated by
-     * this viewer instance. Call this method before release the `Viewer` instance.
-     */
     dispose(): this;
     /**
      * Returns `true` if `VisualizeJS` module has been loaded and initialized.
@@ -181,25 +178,8 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * @param dragger - Dragger class.
      */
     registerDragger(name: string, dragger: typeof Dragger): void;
-    /**
-     * Returns the active dragger instance, or `null` if there is no active dragger.
-     */
     activeDragger(): IDragger | null;
-    /**
-     * Changes the active dragger. Viewer must be initialized before enable dragger or exception is thrown.
-     *
-     * Fires:
-     *
-     * - {@link ChangeActiveDraggerEvent | changeactivedragger}
-     *
-     * @param name - Dragger name. Can be one of the {@link draggers} list.
-     * @returns Returns the new active dragger instance or `null` if there is no dragger with the
-     *   given name.
-     */
-    setActiveDragger(name: string): IDragger | null;
-    /**
-     * Resets the state of the active dragger.
-     */
+    setActiveDragger(name?: string): IDragger | null;
     resetActiveDragger(): void;
     /**
      * Removes all cutting planes.
@@ -213,9 +193,6 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * Creates an overlay view. Overlay view is used to draw cutting planes and `Visualize` markups.
      */
     syncOverlay(): any;
-    /**
-     * Returns `true` if current opened model is 3D model.
-     */
     is3D(): boolean;
     screenToWorld(position: {
         x: number;
@@ -238,20 +215,14 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
         y: number;
         z: number;
     };
-    /**
-     * Returns a list of original handles for the selected objects.
-     */
     getSelected(): string[];
-    /**
-     * Selects the model objects by original handles that are obtained using `File.searchProperties()`.
-     *
-     * Fires:
-     *
-     * - {@link SelectEvent | select}
-     *
-     * @param handles - The list of original handles.
-     */
     setSelected(handles?: string[]): void;
+    clearSelected(): void;
+    hideSelected(): void;
+    isolateSelected(): void;
+    showAll(): void;
+    explode(index?: number): void;
+    collect(): void;
     loadReferences(model: Model | File | Assembly): Promise<this>;
     applyModelTransformMatrix(model: Model | Assembly): void;
     applySceneGraphSettings(options?: IOptions): void;
@@ -260,6 +231,9 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      *
      * The file geometry data on the server must be converted to `VSFX` format.
      *
+     * To open a large file, enable {@link IOptions.enablePartialMode | partial streaming} mode
+     * before opening (see example below).
+     *
      * This method requires a `Client` instance to be specified when creating the viewer to load
      * model reference files from the Open Cloud Server. For a standalone viewer instance use
      * {@link openVsfFile | openVsfFile()} or {@link openVsfxFile | openVsfxFile()}.
@@ -274,6 +248,11 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * - {@link GeometryEndEvent | geometryend}
      * - {@link GeometryErrorEvent | geometryerror}
      *
+     * @example <caption>Using partial streaming mode to open a large file from a server.</caption>
+     *   viewer.options.enableStreamingMode = true;
+     *   viewer.options.enablePartialMode = true;
+     *   await viewer.open(file);
+     *
      * @param file - File, assembly or specific model to load. If a `File` instance with multiple
      *   models is specified, the default model will be loaded. If there is no default model,
      *   first availiable model will be loaded.
@@ -283,7 +262,7 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * Loads a `VSF` file into the viewer.
      *
      * This method does not support {@link IOptions.enableStreamingMode | streaming} or
-     * {@link IOptions.enablePartialMode | partial load} mode.
+     * {@link IOptions.enablePartialMode | partial streaming} mode.
      *
      * Fires:
      *
@@ -301,7 +280,7 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * Loads a `VSFX` file into the viewer.
      *
      * This method does not support {@link IOptions.enableStreamingMode | streaming} or
-     * {@link IOptions.enablePartialMode | partial load} mode.
+     * {@link IOptions.enablePartialMode | partial streaming} mode.
      *
      * Fires:
      *
@@ -315,16 +294,10 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * @param buffer - Binary data buffer to load.
      */
     openVsfxFile(buffer: Uint8Array | ArrayBuffer): this;
-    /**
-     * Cancels asynchronous file loading started by {@link open | open()}.
-     */
     cancel(): this;
-    /**
-     * Unloads an open file and clears the canvas and markups.
-     */
     clear(): this;
     /**
-     * Returns the color of new markup objects.
+     * Deprecated since `25.11`. Use {@link IMarkup.getMarkupColor | markup.getMarkupColor()} instead.
      */
     getMarkupColor(): {
         r: number;
@@ -332,31 +305,16 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
         b: number;
     };
     /**
-     * Sets the color of new markup objects.
-     *
-     * Fires:
-     *
-     * - {@link ChangeMarkupColorEvent | changemarkupcolor}
-     *
-     * @param r - The `red` component of the color, as a number between 0 and 255.
-     * @param g - The `green` component of the color, as a number between 0 and 255.
-     * @param b - The `blue` component of the color, as a number between 0 and 255.
+     * Deprecated since `25.11`. Use {@link IMarkup.setMarkupColor | markup.setMarkupColor()} instead.
      */
     setMarkupColor(r?: number, g?: number, b?: number): void;
     /**
-     * Colors all markup objects with the specified color.
-     *
-     * @param r - The `red` component of the color, as a number between 0 and 255.
-     * @param g - The `green` component of the color, as a number between 0 and 255.
-     * @param b - The `blue` component of the color, as a number between 0 and 255.
+     * Deprecated since `25.11`. Use {@link IMarkup.colorizeAllMarkup | markup.colorizeAllMarkup()} instead.
      */
     colorizeAllMarkup(r?: number, g?: number, b?: number): void;
     /**
-     * Colors the selected markup objects with the specified color.
-     *
-     * @param r - `Red` part of color.
-     * @param g - `Green` part of color.
-     * @param b - `Blue` part of color.
+     * Deprecated since `25.11`. Use
+     * {@link IMarkup.colorizeSelectedMarkups | markup.colorizeSelectedMarkups()} instead.
      */
     colorizeSelectedMarkups(r?: number, g?: number, b?: number): void;
     /**
@@ -388,11 +346,12 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * Executes the command denoted by the given command. If the command is not found, tries to
      * set active dragger with the specified name.
      *
-     * The following commands are registered by default:
+     * The following commands are available by default:
      *
      * - `applyModelTransform`
      * - `autoTransformAllModelsToCentralPoint`
      * - `clearMarkup`
+     * - `clearSelected`
      * - `clearSlices`
      * - `createPreview`
      * - `explode`
@@ -409,7 +368,6 @@ export declare class Viewer extends EventEmitter2<ViewerEventMap & CanvasEventMa
      * - `setMarkupColor`
      * - `setSelected`
      * - `showAll`
-     * - `unselect`
      * - `zoomToExtents`
      * - `zoomToObjects`
      * - `zoomToSelected`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inweb/viewer-visualize",
-  "version": "25.9.8",
+  "version": "25.11.0",
   "description": "3D viewer powered by VisualizeJS",
   "homepage": "https://cloud.opendesign.com/docs/index.html",
   "license": "SEE LICENSE IN LICENSE",
@@ -29,10 +29,10 @@
     "docs": "typedoc"
   },
   "dependencies": {
-    "@inweb/client": "~25.9.8",
-    "@inweb/eventemitter2": "~25.9.8",
-    "@inweb/markup": "~25.9.8",
-    "@inweb/viewer-core": "~25.9.8"
+    "@inweb/client": "~25.11.0",
+    "@inweb/eventemitter2": "~25.11.0",
+    "@inweb/markup": "~25.11.0",
+    "@inweb/viewer-core": "~25.11.0"
   },
-  "visualizeJS": "https://opencloud.azureedge.net/libs/visualizejs/master/Visualize.js"
+  "visualizeJS": "https://public-fhemb7e3embacwec.z02.azurefd.net/libs/visualizejs/master/Visualize.js"
 }

package/src/Viewer/Commands/{Unselect.ts → ClearSelected.ts}

@@ -24,14 +24,15 @@
 import { commands } from "@inweb/viewer-core";
 import { Viewer } from "../Viewer";
 
-function unselect(viewer: Viewer): void {
+function clearSelected(viewer: Viewer): void {
   if (!viewer.visualizeJs) return;
 
   const visViewer = viewer.visViewer();
   visViewer.unselect();
 
   viewer.update();
-  viewer.emitEvent({ type: "select", data: visViewer.getSelected(), handles: [] });
+  viewer.emitEvent({ type: "select", data: undefined, handles: [] });
 }
 
-commands("VisualizeJS").registerCommand("unselect", unselect);
+commands("VisualizeJS").registerCommand("clearSelected", clearSelected);
+commands("VisualizeJS").registerCommandAlias("clearSelected", "unselect");

package/src/Viewer/Commands/Explode.ts

@@ -31,7 +31,7 @@ function explode(viewer: Viewer, index = 0): void {
   visViewer.explode(index);
 
   viewer.update();
-  viewer.emit({ type: "explode", data: index });
+  viewer.emitEvent({ type: "explode", data: index });
 }
 
 commands("VisualizeJS").registerCommand("explode", explode);

package/src/Viewer/Commands/HideSelected.ts

@@ -31,7 +31,8 @@ function hideSelected(viewer: Viewer): void {
   visViewer.hideSelectedObjects(false);
 
   viewer.update();
-  viewer.emit({ type: "hide" });
+  viewer.emitEvent({ type: "hide" });
+  viewer.emitEvent({ type: "select", data: undefined, handles: [] });
 }
 
 commands("VisualizeJS").registerCommand("hideSelected", hideSelected);

package/src/Viewer/Commands/IsolateSelected.ts

@@ -31,7 +31,7 @@ function isolateSelected(viewer: Viewer): void {
   visViewer.isolateSelectedObjects(false);
 
   viewer.update();
-  viewer.emit({ type: "isolate" });
+  viewer.emitEvent({ type: "isolate" });
 }
 
 commands("VisualizeJS").registerCommand("isolateSelected", isolateSelected);

package/src/Viewer/Commands/ResetView.ts

@@ -31,7 +31,7 @@ function resetView(viewer: Viewer): void {
   viewer.executeCommand("clearSlices");
   viewer.executeCommand("clearOverlay");
   viewer.executeCommand("setMarkupColor");
-  viewer.executeCommand("unselect");
+  viewer.executeCommand("clearSelected");
   viewer.executeCommand("showAll");
   viewer.executeCommand("explode", 0);
   viewer.executeCommand("zoomToExtents", true);

package/src/Viewer/Commands/ShowAll.ts

@@ -31,7 +31,7 @@ function showAll(viewer: Viewer): void {
   visViewer.unisolateSelectedObjects(false);
 
   viewer.update();
-  viewer.emit({ type: "showall" });
+  viewer.emitEvent({ type: "showall" });
 }
 
 commands("VisualizeJS").registerCommand("showAll", showAll);

package/src/Viewer/Commands/index.ts

@@ -23,6 +23,7 @@
 
 import "./ApplyModelTransform";
 import "./ClearMarkup";
+import "./ClearSelected";
 import "./ClearSlices";
 import "./CreatePreview";
 import "./Explode";
@@ -39,7 +40,6 @@ import "./SetDefaultViewPosition";
 import "./SetMarkupColor";
 import "./SetSelected";
 import "./ShowAll";
-import "./Unselect";
 import "./ZoomToExtents";
 import "./ZoomToObjects";
 import "./ZoomToSelected";

package/src/Viewer/Draggers/Actions/PanAction.ts

@@ -51,13 +51,13 @@ export class PanAction {
     this._setViewParams = setViewParams;
   }
 
-  public beginAction(x: number, y: number) {
+  public beginAction(x: number, y: number, absoluteX: number, absoluteY: number) {
     this._m_start = this.screenToWorld(x, y);
-    this._deltaScreenPosition = { x, y };
+    this._deltaScreenPosition = { x: absoluteX, y: absoluteY };
     this._beginInteractivity();
   }
 
-  public action(x: number, y: number) {
+  public action(x: number, y: number, absoluteX: number, absoluteY: number) {
     const { Vector3d } = this._m_module;
     const params = this._getViewParams();
     const pt = this.screenToWorld(x, y);
@@ -83,13 +83,13 @@ export class PanAction {
     this._subject.activeDragger()?.updatePreview();
     this._subject.emitEvent({
       type: "pan",
-      x,
-      y,
-      dX: x - this._deltaScreenPosition.x,
-      dY: y - this._deltaScreenPosition.y,
+      x: absoluteX,
+      y: absoluteY,
+      dX: absoluteX - this._deltaScreenPosition.x,
+      dY: absoluteY - this._deltaScreenPosition.y,
     });
 
-    this._deltaScreenPosition = { x, y };
+    this._deltaScreenPosition = { x: absoluteX, y: absoluteY };
   }
 
   public endAction() {

package/src/Viewer/Draggers/Actions/ZoomAction.ts

@@ -32,7 +32,7 @@ export class ZoomAction {
     this._subject = subject;
   }
 
-  public action(x: number, y: number, zoomFactor: number) {
+  public action(x: number, y: number, zoomFactor: number, absoluteX: number, absoluteY: number) {
     const viewer = this._m_module.getViewer();
     viewer.zoomAt(zoomFactor, x, y);
 
@@ -41,6 +41,8 @@ export class ZoomAction {
     this._subject.emitEvent({
       type: "zoomat",
       data: zoomFactor,
+      x: absoluteX,
+      y: absoluteY,
     });
   }
 }

package/src/Viewer/Draggers/Common/GestureManager.ts

@@ -167,7 +167,7 @@ export class GestureManager extends OdBaseDragger {
     const zoomSpeed = (currentDistance - previousDistance) / 700;
     const zoomFactor = 1 + zoomSpeed;
     const middlePoint = this.getMiddlePoint(this._currentEvents);
-    this._zoomAction.action(middlePoint.x, middlePoint.y, zoomFactor);
+    this._zoomAction.action(middlePoint.x, middlePoint.y, zoomFactor, middlePoint.x, middlePoint.y);
     this.subject.update();
   }
 
@@ -177,10 +177,10 @@ export class GestureManager extends OdBaseDragger {
       this._lastGestureAction = GestureAction.Pan;
       OdBaseDragger.isGestureActive = true;
 
-      this._panAction.beginAction(currentPoint.x, currentPoint.y);
+      this._panAction.beginAction(currentPoint.x, currentPoint.y, currentPoint.x, currentPoint.y);
     }
 
-    this._panAction.action(currentPoint.x, currentPoint.y);
+    this._panAction.action(currentPoint.x, currentPoint.y, currentPoint.x, currentPoint.y);
     this.subject.update();
   }
 

package/src/Viewer/Draggers/Common/OdBaseDragger.ts

@@ -96,7 +96,7 @@ export class OdBaseDragger extends OdaGeAction {
     (ev.target as HTMLElement).releasePointerCapture(ev.pointerId);
 
     const relCoord = this.relativeCoords(ev);
-    this.end(relCoord.x, relCoord.y);
+    this.end(relCoord.x, relCoord.y, ev.clientX, ev.clientY);
     this.isDragging = false;
     this.subject.update();
   }
@@ -115,7 +115,7 @@ export class OdBaseDragger extends OdaGeAction {
     }
 
     const relCoord = this.relativeCoords(ev);
-    this.drag(relCoord.x, relCoord.y, ev.movementX, ev.movementY);
+    this.drag(relCoord.x, relCoord.y, ev.clientX, ev.clientY);
     if (this.isDragging) {
       this.subject.update();
     }
@@ -177,7 +177,7 @@ export class OdBaseDragger extends OdaGeAction {
 
   protected drag(x: number, y: number, absoluteX = 0, absoluteY = 0): void {}
 
-  protected end(x: number, y: number): void {}
+  protected end(x: number, y: number, absoluteX = 0, absoluteY = 0): void {}
 
   protected beginInteractivity = () => {
     const viewer = this.getViewer();

package/src/Viewer/Draggers/MeasureLineDragger/MeasureLineItem.ts

@@ -186,7 +186,12 @@ export class MeasureLineItem {
   }
 
   getDistance(): number {
-    return utils.getDistance(this.startPoint, this.endPoint, this.moduleInstance) / this.scale;
+    let distance = utils.getDistance(this.startPoint, this.endPoint, this.moduleInstance);
+    if (Math.abs(this.scale - 1.0) > 10e-5) {
+      distance = (distance / this.scale).toFixed(2);
+    }
+
+    return distance;
   }
 
   setStartPoint(gePoint: number[]): void {