@inweb/viewer-visualize 25.9.7 → 25.10.0

package/README.md

@@ -1,6 +1,6 @@
 # Viewer.visualize
 
-`Viewer.visualize` is JavaScript library implementating 3D viewer powered by [VisualizeJS](https://cloud.opendesign.com/docs/index.html#/visualizejs) for in-browser visualization of CAD and BIM data files.
+`Viewer.visualize` is JavaScript library for rendering CAD and BIM files in a browser using [VisualizeJS](https://cloud.opendesign.com/docs/index.html#/visualizejs).
 
 Core capabilities:
 

package/dist/viewer-visualize.js

@@ -17549,7 +17549,7 @@
          *   `Viewer.visualize` library you are using.
          */
         configure(params) {
-            this._visualizeJsUrl = params.visualizeJsUrl || "https://opencloud.azureedge.net/libs/visualizejs/master/Visualize.js";
+            this._visualizeJsUrl = params.visualizeJsUrl || "https://public-fhemb7e3embacwec.z02.azurefd.net/libs/visualizejs/master/Visualize.js";
             return this;
         }
         /**
@@ -17558,6 +17558,7 @@
          *
          * Fires:
          *
+         * - {@link InitializeEvent | initialize}
          * - {@link InitializeProgressEvent | initializeprogress}
          *
          * @param canvas -
@@ -17607,17 +17608,13 @@
             this.emitEvent({ type: "initialize" });
             return 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.cancel();
             this.emitEvent({ type: "dispose" });
             if (this.frameId)
                 cancelAnimationFrame(this.frameId);
             this.frameId = 0;
-            this.setActiveDragger("");
+            this.setActiveDragger();
             this.removeAllListeners();
             if (this._gestureManager)
                 this._gestureManager.dispose();
@@ -17941,24 +17938,10 @@
         registerDragger(name, dragger) {
             this.draggerFactory.set(name, dragger);
         }
-        /**
-         * Returns the active dragger instance, or `null` if there is no active dragger.
-         */
         activeDragger() {
             return this._activeDragger;
         }
-        /**
-         * 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) {
+        setActiveDragger(name = "") {
             var _a;
             if (((_a = this._activeDragger) === null || _a === void 0 ? void 0 : _a.name) !== name) {
                 if (this._activeDragger) {
@@ -17986,13 +17969,10 @@
             }
             return this._activeDragger;
         }
-        /**
-         * Resets the state of the active dragger.
-         */
         resetActiveDragger() {
             const dragger = this._activeDragger;
             if (dragger) {
-                this.setActiveDragger("");
+                this.setActiveDragger();
                 this.setActiveDragger(dragger.name);
             }
         }
@@ -18045,9 +18025,6 @@
             this._markup.syncOverlay();
             this.update();
         }
-        /**
-         * Returns `true` if current opened model is 3D model.
-         */
         is3D() {
             if (!this.visualizeJs)
                 return false;
@@ -18156,6 +18133,9 @@
          *
          * The file geometry data on the server must be converted to `VSFX` format.
          *
+         * To open a large file, enable {@link IOptions.enablePartialMode | partial load} 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()}.
@@ -18170,6 +18150,11 @@
          * - {@link GeometryEndEvent | geometryend}
          * - {@link GeometryErrorEvent | geometryerror}
          *
+         * @example <caption>Using partial load 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.
@@ -18287,9 +18272,6 @@
             }
             return this;
         }
-        /**
-         * Cancels asynchronous file loading started by {@link open | open()}.
-         */
         cancel() {
             var _a, _b, _c;
             (_a = this._abortControllerForReferences) === null || _a === void 0 ? void 0 : _a.abort();
@@ -18301,14 +18283,12 @@
             this.emitEvent({ type: "cancel" });
             return this;
         }
-        /**
-         * Unloads an open file and clears the canvas and markups.
-         */
         clear() {
             if (!this.visualizeJs)
                 return this;
             const visLib = this.visLib();
             const visViewer = visLib.getViewer();
+            this.setActiveDragger();
             this.clearOverlay();
             visViewer.clear();
             visViewer.createLocalDatabase();
@@ -18397,10 +18377,10 @@
          * To save a viewpoint to the server for a specific file, use the `File.saveViewpoint()`.
          */
         createViewpoint() {
-            const vp = this._markup.getViewpoint();
-            vp.orthogonal_camera = this.getOrthogonalCameraSettings();
-            vp.clipping_planes = this.getClippingPlanes();
-            return vp;
+            const viewpoint = this._markup.getViewpoint();
+            viewpoint.orthogonal_camera = this.getOrthogonalCameraSettings();
+            viewpoint.clipping_planes = this.getClippingPlanes();
+            return viewpoint;
         }
         getPoint3dFromArray(array) {
             return { x: array[0], y: array[1], z: array[2] };