larvitar 4.0.0-alpha.13 → 4.0.0-alpha.15

package/dist/imaging/tools/default.d.ts

@@ -2,7 +2,7 @@
  *  @desc  This file provides definitions
  *         for default tools
  */
-import type { CursorOptions, ToolConfig, ToolMouseKeys, ToolSettings, ToolStyle } from "./types";
+import type { CursorOptions, ToolConfig, ToolMouseKeys, ToolSettings, ToolStyle, ToolStyle3D } from "./types";
 declare const DEFAULT_TOOLS_3D: {
     [key: string]: ToolConfig;
 };
@@ -41,30 +41,7 @@ declare const dvToolsMPR: {
  * Arial, Lucida Grande, sans-serif;
  */
 declare const DEFAULT_STYLE: ToolStyle;
-declare const DEFAULT_STYLE_3D: {
-    global: {
-        angleArcLineDash: string;
-        color: string;
-        colorHighlighted: string;
-        colorLocked: string;
-        colorSelected: string;
-        lineDash: string;
-        lineWidth: string;
-        markerSize: string;
-        shadow: boolean;
-        textBoxBackground: string;
-        textBoxColor: string;
-        textBoxColorHighlighted: string;
-        textBoxColorLocked: string;
-        textBoxColorSelected: string;
-        textBoxFontFamily: string;
-        textBoxFontSize: string;
-        textBoxLinkLineDash: string;
-        textBoxLinkLineWidth: string;
-        textBoxShadow: boolean;
-        textBoxVisibility: boolean;
-    };
-};
+declare const DEFAULT_STYLE_3D: ToolStyle3D;
 /**
  * Tools default settings
  */
@@ -114,5 +91,5 @@ declare const registerExternalTool: (toolName: string, toolClass: any, toolVersi
         }
       };
  */
-export declare const registerCursor: (toolName: string, iconContent: string, cursorOptions?: CursorOptions) => void;
+export declare const registerCursor: (toolName: string, iconContent: string, viewBox?: CursorOptions) => void;
 export { DEFAULT_TOOLS, DEFAULT_TOOLS_3D, DEFAULT_TOOLS_MPR, DEFAULT_STYLE, DEFAULT_STYLE_3D, DEFAULT_SETTINGS, DEFAULT_MOUSE_KEYS, dvTools, dvTools3D, dvToolsMPR, getDefaultToolsByType, setDefaultToolsProps, registerExternalTool };

package/dist/imaging/tools/types.d.ts

@@ -24,6 +24,30 @@ export type ToolConfig = {
     currentMode?: string;
     offset?: number;
 };
+export type ToolStyle3D = {
+    global: {
+        angleArcLineDash: string;
+        color: string;
+        colorHighlighted: string;
+        colorLocked: string;
+        colorSelected: string;
+        lineDash: string;
+        lineWidth: string;
+        markerSize: string;
+        shadow: boolean;
+        textBoxBackground: string;
+        textBoxColor: string;
+        textBoxColorHighlighted: string;
+        textBoxColorLocked: string;
+        textBoxColorSelected: string;
+        textBoxFontFamily: string;
+        textBoxFontSize: string;
+        textBoxLinkLineDash: string;
+        textBoxLinkLineWidth: string;
+        textBoxShadow: boolean;
+        textBoxVisibility: boolean;
+    };
+};
 export type ToolStyle = {
     width: number;
     color: string;

package/dist/imaging3d/imageRendering.d.ts

@@ -62,7 +62,7 @@ export declare const loadAndCacheVolume: (series: Series) => Promise<cornerstone
  * @returns
  */
 export declare const setVolumeForRenderingEngine: (volumeId: string, renderingEngineId: string) => void;
-export declare const renderMpr: (series: Series, renderingEngineId: string, options?: RenderProps) => Promise<unknown>;
+export declare const renderMpr: (series: Series, renderingEngineId: string, options?: RenderProps) => Promise<cornerstone.RenderingEngine>;
 /**
  * Unload a MPR rendering engine
  * @instance
@@ -79,3 +79,11 @@ export declare const unloadMpr: (renderingEngineId: string) => void;
  * @returns {void}
  */
 export declare const resizeRenderingEngine: (renderingEngineId: string) => void;
+/**
+ * Reset viewport values (contrast, pan and zoom)
+ * @instance
+ * @function resetViewports
+ * @param {Array} elementIds - The array of hmtl div ids
+ * @param {Array} keys - The array of viewport sections to resets (default is all)
+ */
+export declare const resetViewports: (elementIds: string[], keys?: Array<"contrast" | "pan" | "zoom">) => void;

package/dist/imaging3d/tools/main.d.ts

@@ -4,7 +4,7 @@
  */
 import * as cornerstone from "@cornerstonejs/core";
 import * as cornerstoneTools from "@cornerstonejs/tools";
-import type { ToolConfig, ToolSettings, ToolStyle } from "../../imaging/tools/types";
+import type { ToolConfig, ToolSettings, ToolStyle3D } from "../../imaging/tools/types";
 import type { RenderingEngine } from "@cornerstonejs/core";
 /**
  * Initialize cornerstone tools with default configuration (extended with custom configuration)
@@ -13,13 +13,13 @@ import type { RenderingEngine } from "@cornerstonejs/core";
  * @param {ToolStyle} style - the style object (see tools/default.js)
  * @example larvitar.initializeCSTools({showSVGCursors:false}, {color: "0000FF"});
  */
-export declare const initializeCSTools: (settings?: ToolSettings, style?: ToolStyle) => Promise<void>;
+export declare const initializeCSTools: (settings?: ToolSettings, style?: ToolStyle3D) => Promise<void>;
 /**
  * Set cornerstone tools custom configuration (extend default configuration)
  * @function setToolsStyle
  * @param {Object} style - the style object (see tools/defaults.js)
  */
-export declare const setToolsStyle: (style?: ToolStyle) => void;
+export declare const setToolsStyle: (style?: ToolStyle3D) => void;
 /**
  * Add a cornerstone 3D tool (grab it from original library or dvision custom 3D or MPR tools)
  * @param {String} toolName
@@ -57,6 +57,22 @@ export declare const setToolDisabled: (toolName: string, groupId?: string, reset
  * @param sourceViewportId - the id of the source viewport from where the camera position will be taken
  */
 export declare const syncViewportsCamera: (id: string | undefined, targetViewportId: string, sourceViewportId: string) => void;
+/**
+ * @function syncViewportsVOI
+ * @desc  Synchronizes the contrast of two (volume) viewports
+ * @param id - unique id for the synchronizer @default "default"
+ * @param targetViewportId - the id of the target viewport where the camera will be synced
+ * @param sourceViewportId - the id of the source viewport from where the camera position will be taken
+ */
+export declare const syncViewportsVOI: (id: string | undefined, targetViewportId: string, sourceViewportId: string) => void;
+/**
+ * @function syncViewports
+ * @desc  Synchronizes the camera position and contrast of two (volume) viewports
+ * @param id - unique id for the synchronizer @default "default"
+ * @param targetViewportId - the id of the target viewport where the camera will be synced
+ * @param sourceViewportId - the id of the source viewport from where the camera position will be taken
+ */
+export declare const syncViewports: (id: string | undefined, targetViewportId: string, sourceViewportId: string) => void;
 /**
  * Create a tool group and add the specified viewports and tools to it.
  * @function createToolGroup

package/dist/imaging3d/types.d.ts

@@ -1,6 +1,6 @@
 import { Enums } from "@cornerstonejs/core";
 export type { Types, VolumeViewport, StackViewport, BaseVolumeViewport } from "@cornerstonejs/core";
-export type { IEnabledElement, Point2, Point3 } from "@cornerstonejs/core/dist/esm/types";
+export type { IEnabledElement, Point2, Point3, ICamera } from "@cornerstonejs/core/dist/esm/types";
 export type { Annotation, CanvasCoordinates, EventTypes, InteractionTypes, PublicToolProps, SVGDrawingHelper, TextBoxHandle, ToolHandle, ToolProps } from "@cornerstonejs/tools/dist/esm/types";
 export type { Handles } from "@cornerstonejs/tools/dist/esm/types/AnnotationTypes";
 export type { ROICachedStats } from "@cornerstonejs/tools/dist/esm/types/ToolSpecificAnnotationTypes";

package/dist/index.d.ts

@@ -45,7 +45,7 @@ import { registerStreamingImageVolume as _registerStreamingImageVolume } from ".
 import { loadAndCacheMetadata as _loadAndCacheMetadata } from "./imaging3d/imageLoading";
 import { readFiles as _readFiles } from "./imaging3d/imageParsing";
 import { convertMetadata as _convertMetadata } from "./imaging3d/imageParsing";
-import { renderImage as _renderImage } from "./imaging3d/imageRendering";
+import { renderImage as _renderImage, resetViewports as _resetViewports } from "./imaging3d/imageRendering";
 import { initializeRenderingEngine as _initializeRenderingEngine } from "./imaging3d/imageRendering";
 import { destroyRenderingEngine as _destroyRenderingEngine } from "./imaging3d/imageRendering";
 import { initializeVolumeViewports as _initializeVolumeViewports } from "./imaging3d/imageRendering";
@@ -55,10 +55,10 @@ import { resizeRenderingEngine as _resizeRenderingEngine } from "./imaging3d/ima
 import { renderMpr as _renderMpr } from "./imaging3d/imageRendering";
 import { prefetchMetadataInformation as _prefetchMetadataInformation } from "./imaging3d/multiframe";
 import { convertMultiframeImageIds as _convertMultiframeImageIds } from "./imaging3d/multiframe";
-import { addDefaultTools as _addDefaultTools, initializeCSTools as _initializeCSTools, addTool as _addTool, setToolActive as _setToolActive, setToolPassive as _setToolPassive, setToolEnabled as _setToolEnabled, setToolDisabled as _setToolDisabled, syncViewportsCamera as _syncViewportsCamera, createToolGroup as _createToolGroup, destroyToolGroup as _destroyToolGroup, setSlab as _setSlab, setWWWL as _setWWWL } from "./imaging3d/tools/main";
+import { addDefaultTools as _addDefaultTools, initializeCSTools as _initializeCSTools, addTool as _addTool, setToolActive as _setToolActive, setToolPassive as _setToolPassive, setToolEnabled as _setToolEnabled, setToolDisabled as _setToolDisabled, syncViewportsCamera as _syncViewportsCamera, syncViewportsVOI as _syncViewportsVOI, syncViewports as _syncViewports, createToolGroup as _createToolGroup, destroyToolGroup as _destroyToolGroup, setSlab as _setSlab, setWWWL as _setWWWL } from "./imaging3d/tools/main";
 import _CustomWWWLTool from "./imaging3d/tools/custom/exampleCustomTool";
 import { updateImageManager, populateImageManager, getImageManager, resetImageManager, removeDataFromImageManager, getDataFromImageManager, getSopInstanceUIDFromImageManager, getImageTracker, populateGSPSManager, getGSPSManager, resetGSPSManager, getFileManager, resetFileManager, populateFileManager, getDataFromFileManager } from "./imaging/imageManagers";
-export { _cornerstone, _cornerstoneDICOMImageLoader, _cornerstoneTools, _initializeCSTools, _initializeImageLoader, _readFiles, _renderImage, _renderMpr, _initializeRenderingEngine, _destroyRenderingEngine, _resizeRenderingEngine, _initializeVolumeViewports, _loadAndCacheVolume, _setVolumeForRenderingEngine, _registerStreamingImageVolume, _convertMetadata, _loadAndCacheMetadata, _prefetchMetadataInformation, _convertMultiframeImageIds, _addDefaultTools, _addTool, _setToolActive, _setToolPassive, _setToolEnabled, _setToolDisabled, _syncViewportsCamera, _createToolGroup, _destroyToolGroup, _setWWWL, _setSlab, _CustomWWWLTool, VERSION, cornerstone, cornerstoneTools, parseDicom, cornerstoneFileImageLoader, segModule, cornerstoneDICOMImageLoader, checkAndClearMemory, checkMemoryAllocation, getUsedMemory, getAvailableMemory, getPerformanceMonitor, activatePerformanceMonitor, deactivatePerformanceMonitor, store, parseECG, renderECG, unrenderECG, syncECGFrame, updateECGMarker, updateECGTotalTime, getDefaultECGLayout, getImagePresets, setImagePreset, setImageCustomPreset, getNormalOrientation, getMinPixelValue, getMaxPixelValue, getPixelRepresentation, getTypedArrayFromDataType, getSortedStack, randomId, getMeanValue, getReslicedMetadata, getReslicedPixeldata, getDistanceBetweenSlices, getImageMetadata, buildHeader, getCachedPixelData, buildData, buildDataAsync, importNRRDImage, exportImageToBase64, exportImageToBase64OriginalSizes, anonymize, customizeByteArray, buildLayer, updateLayer, getActiveLayer, setActiveLayer, initializeImageLoader, initializeWebImageLoader, initializeFileImageLoader, registerNRRDImageLoader, registerResliceLoader, registerMultiFrameImageLoader, registerSingleFrameImageLoader, registerDsaImageLoader, updateLoadedStack, reset, readFile, readFiles, parseDataSet, clearImageParsing, convertQidoMetadata, clearImageCache, clearStandardImageCache, clearDSAImageCache, loadAndCacheImages, renderFileImage, renderDICOMPDF, renderWebImage, disableViewport, unloadViewport, resizeViewport, renderImage, redrawImage, resetViewports, updateViewportData, toggleMouseToolsListeners, storeViewportData, invertImage, flipImageHorizontal, flipImageVertical, rotateImageLeft, rotateImageRight, updateImageManager, populateImageManager, getImageManager, resetImageManager, removeDataFromImageManager, getDataFromImageManager, getSopInstanceUIDFromImageManager, getImageTracker, populateGSPSManager, getGSPSManager, resetGSPSManager, populateFileManager, getFileManager, resetFileManager, getDataFromFileManager, resliceSeries, getColormapsList, applyColorMap, addColorMap, fillPixelData, HSVToRGB, parseContours, getImageFrame, buildNrrdImage, getNrrdImageId, loadNrrdImage, getImageIdFromSlice, getSliceNumberFromImageId, getNrrdSerieDimensions, loadReslicedImage, getDicomImageId, cacheImage, cacheImages, loadAndCacheImageStack, loadAndCacheDsaImageStack, loadMultiFrameImage, buildMultiFrameImage, getMultiFrameImageId, clearMultiFrameCache, setSingleFrameCache, clearSingleFrameCache, loadSingleFrameImage, populateDsaImageIds, resetFileLoader, getFileCustomImageId, applyDSAShift, addDiameterTool, addContoursTool, addMaskEditingTool, getCurrentMaskData, addStackStateToElement, addSeedsTool, clearMeasurements, getToolState, clearToolStateByName, updateDiameterTool, addToolStateSingleSlice, clearCornerstoneElements, syncToolStack, updateStackToolState, setSegmentationConfig, csToolsUpdateStack, initializeCSTools, setToolsStyle, addDefaultTools, addTool, setToolActive, setToolDisabled, setToolEnabled, setToolPassive, DEFAULT_TOOLS, dvTools, getDefaultToolsByType, setDefaultToolsProps, registerExternalTool, registerCursor, addMouseKeyHandlers, removeMouseKeyHandlers, initSegmentationModule, addSegmentationMask, setActiveLabelmap, setActiveSegment, undoLastStroke, redoLastStroke, setBrushProps, hexToRgb, rgbToHex, clearSegmentationState, deleteMask, enableBrushTool, disableBrushTool, toggleContourMode, toggleVisibility, getActiveLabelmapBuffer, updateTemporalViewportData, logger, setLogLevel };
+export { _cornerstone, _cornerstoneDICOMImageLoader, _cornerstoneTools, _initializeCSTools, _initializeImageLoader, _readFiles, _renderImage, _resetViewports, _renderMpr, _initializeRenderingEngine, _destroyRenderingEngine, _resizeRenderingEngine, _initializeVolumeViewports, _loadAndCacheVolume, _setVolumeForRenderingEngine, _registerStreamingImageVolume, _convertMetadata, _loadAndCacheMetadata, _prefetchMetadataInformation, _convertMultiframeImageIds, _addDefaultTools, _addTool, _setToolActive, _setToolPassive, _setToolEnabled, _setToolDisabled, _syncViewportsCamera, _syncViewportsVOI, _syncViewports, _createToolGroup, _destroyToolGroup, _setWWWL, _setSlab, _CustomWWWLTool, VERSION, cornerstone, cornerstoneTools, parseDicom, cornerstoneFileImageLoader, segModule, cornerstoneDICOMImageLoader, checkAndClearMemory, checkMemoryAllocation, getUsedMemory, getAvailableMemory, getPerformanceMonitor, activatePerformanceMonitor, deactivatePerformanceMonitor, store, parseECG, renderECG, unrenderECG, syncECGFrame, updateECGMarker, updateECGTotalTime, getDefaultECGLayout, getImagePresets, setImagePreset, setImageCustomPreset, getNormalOrientation, getMinPixelValue, getMaxPixelValue, getPixelRepresentation, getTypedArrayFromDataType, getSortedStack, randomId, getMeanValue, getReslicedMetadata, getReslicedPixeldata, getDistanceBetweenSlices, getImageMetadata, buildHeader, getCachedPixelData, buildData, buildDataAsync, importNRRDImage, exportImageToBase64, exportImageToBase64OriginalSizes, anonymize, customizeByteArray, buildLayer, updateLayer, getActiveLayer, setActiveLayer, initializeImageLoader, initializeWebImageLoader, initializeFileImageLoader, registerNRRDImageLoader, registerResliceLoader, registerMultiFrameImageLoader, registerSingleFrameImageLoader, registerDsaImageLoader, updateLoadedStack, reset, readFile, readFiles, parseDataSet, clearImageParsing, convertQidoMetadata, clearImageCache, clearStandardImageCache, clearDSAImageCache, loadAndCacheImages, renderFileImage, renderDICOMPDF, renderWebImage, disableViewport, unloadViewport, resizeViewport, renderImage, redrawImage, resetViewports, updateViewportData, toggleMouseToolsListeners, storeViewportData, invertImage, flipImageHorizontal, flipImageVertical, rotateImageLeft, rotateImageRight, updateImageManager, populateImageManager, getImageManager, resetImageManager, removeDataFromImageManager, getDataFromImageManager, getSopInstanceUIDFromImageManager, getImageTracker, populateGSPSManager, getGSPSManager, resetGSPSManager, populateFileManager, getFileManager, resetFileManager, getDataFromFileManager, resliceSeries, getColormapsList, applyColorMap, addColorMap, fillPixelData, HSVToRGB, parseContours, getImageFrame, buildNrrdImage, getNrrdImageId, loadNrrdImage, getImageIdFromSlice, getSliceNumberFromImageId, getNrrdSerieDimensions, loadReslicedImage, getDicomImageId, cacheImage, cacheImages, loadAndCacheImageStack, loadAndCacheDsaImageStack, loadMultiFrameImage, buildMultiFrameImage, getMultiFrameImageId, clearMultiFrameCache, setSingleFrameCache, clearSingleFrameCache, loadSingleFrameImage, populateDsaImageIds, resetFileLoader, getFileCustomImageId, applyDSAShift, addDiameterTool, addContoursTool, addMaskEditingTool, getCurrentMaskData, addStackStateToElement, addSeedsTool, clearMeasurements, getToolState, clearToolStateByName, updateDiameterTool, addToolStateSingleSlice, clearCornerstoneElements, syncToolStack, updateStackToolState, setSegmentationConfig, csToolsUpdateStack, initializeCSTools, setToolsStyle, addDefaultTools, addTool, setToolActive, setToolDisabled, setToolEnabled, setToolPassive, DEFAULT_TOOLS, dvTools, getDefaultToolsByType, setDefaultToolsProps, registerExternalTool, registerCursor, addMouseKeyHandlers, removeMouseKeyHandlers, initSegmentationModule, addSegmentationMask, setActiveLabelmap, setActiveSegment, undoLastStroke, redoLastStroke, setBrushProps, hexToRgb, rgbToHex, clearSegmentationState, deleteMask, enableBrushTool, disableBrushTool, toggleContourMode, toggleVisibility, getActiveLabelmapBuffer, updateTemporalViewportData, logger, setLogLevel };
 export declare const updateLarvitarManager: (...args: any) => any;
 export declare const populateLarvitarManager: (...args: any) => any;
 export declare const getLarvitarManager: (...args: any) => any;

package/dist/larvitar.js

@@ -83625,6 +83625,7 @@ __webpack_require__.d(__webpack_exports__, {
   _registerStreamingImageVolume: () => (/* reexport */ index_registerStreamingImageVolume),
   _renderImage: () => (/* reexport */ index_imageRendering_renderImage),
   _renderMpr: () => (/* reexport */ index_renderMpr),
+  _resetViewports: () => (/* reexport */ index_imageRendering_resetViewports),
   _resizeRenderingEngine: () => (/* reexport */ index_resizeRenderingEngine),
   _setSlab: () => (/* reexport */ index_setSlab),
   _setToolActive: () => (/* reexport */ index_main_setToolActive),
@@ -83633,7 +83634,9 @@ __webpack_require__.d(__webpack_exports__, {
   _setToolPassive: () => (/* reexport */ index_main_setToolPassive),
   _setVolumeForRenderingEngine: () => (/* reexport */ index_setVolumeForRenderingEngine),
   _setWWWL: () => (/* reexport */ index_setWWWL),
+  _syncViewports: () => (/* reexport */ index_syncViewports),
   _syncViewportsCamera: () => (/* reexport */ index_syncViewportsCamera),
+  _syncViewportsVOI: () => (/* reexport */ index_syncViewportsVOI),
   activatePerformanceMonitor: () => (/* reexport */ index_activatePerformanceMonitor),
   addColorMap: () => (/* reexport */ index_addColorMap),
   addContoursTool: () => (/* reexport */ index_addContoursTool),
@@ -85560,7 +85563,7 @@ __webpack_require__.d(index_tools_dist_esm_namespaceObject, {
 });
 
 ;// ./package.json
-const index_package_namespaceObject = /*#__PURE__*/JSON.parse('{"name":"larvitar","keywords":["DICOM","imaging","medical","cornerstone"],"version":"4.0.0-alpha.13","description":"typescript library for parsing, loading, rendering and interacting with DICOM images","repository":{"url":"https://github.com/dvisionlab/Larvitar.git","type":"git"},"main":"dist/larvitar.js","types":"dist/index.d.ts","files":["dist","imaging/**/*.d.ts","imaging3d/**/*.d.ts"],"scripts":{"coverage":"typescript-coverage-report","format":"prettier --write \\"imaging/**/*.{js,ts,json,css,md}\\" \\"imaging3d/**/*.{js,ts,json,css,md}\\" \\"docs/examples/**/*.html\\"","format:check":"prettier --check \\"imaging/**/*.{js,ts,json,css,md}\\" \\"imaging3d/**/*.{js,ts,json,css,md}\\" \\"docs/examples/**/*.html\\"","postinstall":"patch-package","build":"webpack --config ./bundler/webpack.prod.debug.js","dev":"webpack --progress --config ./bundler/webpack.dev.js","docs:dev":"vuepress dev docs","docs:build":"vuepress build docs","cypress":"cypress open","cypress:run":"cypress run","cypress:run:headless":"cypress run --headless"},"author":"Simone Manini <simone.manini@dvisionlab.com> (https://www.dvisionlab.com)","contributors":["Mattia Ronzoni <mattia.ronzoni@dvisionlab.com> (https://www.dvisionlab.com)","Laura Borghesi <laura.borghesi@dvisionlab.com> (https://www.dvisionlab.com)","Sara Zanchi <sara.zanchi@dvisionlab.com> (https://www.dvisionlab.com)"],"license":"MIT","dependencies":{"@cornerstonejs/core":"^3.12.1","@cornerstonejs/dicom-image-loader":"^3.12.1","@cornerstonejs/nifti-volume-loader":"^3.12.1","@cornerstonejs/tools":"^3.12.1","@hyzyla/pdfium":"^2.1.2","@icr/polyseg-wasm":"^0.4.0","consola":"^3.4.0","cornerstone-core":"^2.6.1","cornerstone-file-image-loader":"^0.3.0","cornerstone-tools":"^6.0.7","cornerstone-wado-image-loader":"^4.13.2","cornerstone-web-image-loader":"^2.1.1","crypto-js":"^4.1.1","dcmjs":"^0.34.0","dicom-character-set":"^1.0.3","dicom-parser":"^1.8.13","hammerjs":"^2.0.8","jpeg-lossless-decoder-js":"^2.0.7","keycode-js":"^3.1.0","lodash":"^4.17.15","pako":"^1.0.10","plotly.js-dist-min":"^2.27.1","uuid":"^8.3.2"},"devDependencies":{"@babel/core":"^7.21.8","@rollup/plugin-commonjs":"^28.0.3","@types/cornerstone-core":"^2.3.0","@types/crypto-js":"^4.1.1","@types/hammerjs":"^2.0.41","@types/lodash":"^4.14.192","@types/papaparse":"^5.3.7","@types/plotly.js":"^2.12.30","@types/plotly.js-dist-min":"^2.3.4","@types/uuid":"^9.0.1","@vuepress/bundler-vite":"^2.0.0-rc.18","@vuepress/plugin-slimsearch":"^2.0.0-rc.68","@vuepress/theme-default":"^2.0.0-rc.60","babel-loader":"^9.1.2","clean-webpack-plugin":"^4.0.0","cypress":"^14.2.0","cypress-image-snapshot":"^4.0.1","cypress-mochawesome-reporter":"^3.8.2","cypress-multi-reporters":"^2.0.5","eslint":"^9.17.0","html-loader":"^4.2.0","html-webpack-plugin":"^5.6.0","jsdom":"^26.0.0","lodash-webpack-plugin":"^0.11.6","mocha-json-reporter":"^1.0.0-1","patch-package":"^8.0.0","prettier":"^3.5.3","sass-embedded":"^1.80.7","ts-loader":"^9.4.2","typescript":"^5.0.2","typescript-coverage-report":"^0.7.0","vuepress":"^2.0.0-rc.18","webpack":"^5.76.3","webpack-cli":"^5.0.1","webpack-dev-server":"^4.13.1"}}');
+const index_package_namespaceObject = /*#__PURE__*/JSON.parse('{"name":"larvitar","keywords":["DICOM","imaging","medical","cornerstone"],"version":"4.0.0-alpha.15","description":"typescript library for parsing, loading, rendering and interacting with DICOM images","repository":{"url":"https://github.com/dvisionlab/Larvitar.git","type":"git"},"main":"dist/larvitar.js","types":"dist/index.d.ts","files":["dist","imaging/**/*.d.ts","imaging3d/**/*.d.ts"],"scripts":{"coverage":"typescript-coverage-report","format":"prettier --write \\"imaging/**/*.{js,ts,json,css,md}\\" \\"imaging3d/**/*.{js,ts,json,css,md}\\" \\"docs/examples/**/*.html\\"","format:check":"prettier --check \\"imaging/**/*.{js,ts,json,css,md}\\" \\"imaging3d/**/*.{js,ts,json,css,md}\\" \\"docs/examples/**/*.html\\"","postinstall":"patch-package","build":"webpack --config ./bundler/webpack.prod.debug.js","dev":"webpack --progress --config ./bundler/webpack.dev.js","docs:dev":"vuepress dev docs","docs:build":"vuepress build docs","cypress":"cypress open","cypress:run":"cypress run","cypress:run:headless":"cypress run --headless"},"author":"Simone Manini <simone.manini@dvisionlab.com> (https://www.dvisionlab.com)","contributors":["Mattia Ronzoni <mattia.ronzoni@dvisionlab.com> (https://www.dvisionlab.com)","Laura Borghesi <laura.borghesi@dvisionlab.com> (https://www.dvisionlab.com)","Sara Zanchi <sara.zanchi@dvisionlab.com> (https://www.dvisionlab.com)"],"license":"MIT","dependencies":{"@cornerstonejs/core":"^3.12.1","@cornerstonejs/dicom-image-loader":"^3.12.1","@cornerstonejs/nifti-volume-loader":"^3.12.1","@cornerstonejs/tools":"^3.12.1","@hyzyla/pdfium":"^2.1.2","@icr/polyseg-wasm":"^0.4.0","consola":"^3.4.0","cornerstone-core":"^2.6.1","cornerstone-file-image-loader":"^0.3.0","cornerstone-tools":"^6.0.7","cornerstone-wado-image-loader":"^4.13.2","cornerstone-web-image-loader":"^2.1.1","crypto-js":"^4.1.1","dcmjs":"^0.34.0","dicom-character-set":"^1.0.3","dicom-parser":"^1.8.13","hammerjs":"^2.0.8","jpeg-lossless-decoder-js":"^2.0.7","keycode-js":"^3.1.0","lodash":"^4.17.15","pako":"^1.0.10","plotly.js-dist-min":"^2.27.1","uuid":"^8.3.2"},"devDependencies":{"@babel/core":"^7.21.8","@rollup/plugin-commonjs":"^28.0.3","@types/cornerstone-core":"^2.3.0","@types/crypto-js":"^4.1.1","@types/hammerjs":"^2.0.41","@types/lodash":"^4.14.192","@types/papaparse":"^5.3.7","@types/plotly.js":"^2.12.30","@types/plotly.js-dist-min":"^2.3.4","@types/uuid":"^9.0.1","@vuepress/bundler-vite":"^2.0.0-rc.18","@vuepress/plugin-slimsearch":"^2.0.0-rc.68","@vuepress/theme-default":"^2.0.0-rc.60","babel-loader":"^9.1.2","clean-webpack-plugin":"^4.0.0","cypress":"^14.2.0","cypress-image-snapshot":"^4.0.1","cypress-mochawesome-reporter":"^3.8.2","cypress-multi-reporters":"^2.0.5","eslint":"^9.17.0","html-loader":"^4.2.0","html-webpack-plugin":"^5.6.0","jsdom":"^26.0.0","lodash-webpack-plugin":"^0.11.6","mocha-json-reporter":"^1.0.0-1","patch-package":"^8.0.0","prettier":"^3.5.3","sass-embedded":"^1.80.7","ts-loader":"^9.4.2","typescript":"^5.0.2","typescript-coverage-report":"^0.7.0","vuepress":"^2.0.0-rc.18","webpack":"^5.76.3","webpack-cli":"^5.0.1","webpack-dev-server":"^4.13.1"}}');
 // EXTERNAL MODULE: ./node_modules/cornerstone-core/dist/cornerstone.js
 var index_dist_cornerstone = __webpack_require__(1198);
 var index_cornerstone_default = /*#__PURE__*/__webpack_require__.n(index_dist_cornerstone);
@@ -180701,6 +180704,9 @@ const index_registerExternalTool = function (toolName, toolClass, toolVersion =
         index_default_registerCursor(toolName, toolCursor, cursorOptions);
     }
 };
+function index_default_extend(base, values) {
+    return Object.assign(Object.create(base), Object.assign(Object.assign({}, values), { name: values.name || base.name }));
+}
 /**
  * Register a custom tool cursor
  * @param {String} toolName - The name of the tool
@@ -180722,13 +180728,11 @@ const index_registerExternalTool = function (toolName, toolClass, toolVersion =
         }
       };
  */
-const index_default_registerCursor = function (toolName, iconContent, cursorOptions) {
-    const descriptor = Object.assign(Object.create(index_BASE_CURSOR), {
+const index_default_registerCursor = function (toolName, iconContent, viewBox) {
+    index_CursorSVG[toolName] = index_default_extend(index_BASE_CURSOR, {
         iconContent,
-        cursorOptions,
-        name: toolName
+        viewBox
     });
-    index_CursorSVG[toolName] = descriptor;
 };
 
 
@@ -283719,6 +283723,14 @@ const index_main_setToolPassive = function (toolName, groupId = "default", reset
     }
     toolGroup.setToolPassive(toolName);
     index_logger_logger.debug(`Tool ${toolName} set enabled in group:`, groupId);
+    if (resetCursor) {
+        toolGroup.getViewportIds().forEach(id => {
+            const element = document.getElementById(id);
+            if (element) {
+                index_cursors_setCursorForElement(element, "default");
+            }
+        });
+    }
 };
 const index_main_setToolEnabled = function (toolName, groupId = "default", resetCursor = true // TODO manage this
 ) {
@@ -283729,6 +283741,14 @@ const index_main_setToolEnabled = function (toolName, groupId = "default", reset
     }
     toolGroup.setToolEnabled(toolName);
     index_logger_logger.debug(`Tool ${toolName} set enabled in group:`, groupId);
+    if (resetCursor) {
+        toolGroup.getViewportIds().forEach(id => {
+            const element = document.getElementById(id);
+            if (element) {
+                index_cursors_setCursorForElement(element, "default");
+            }
+        });
+    }
 };
 const index_main_setToolDisabled = function (toolName, groupId = "default", resetCursor = true // TODO manage this
 ) {
@@ -283739,6 +283759,14 @@ const index_main_setToolDisabled = function (toolName, groupId = "default", rese
     }
     toolGroup.setToolDisabled(toolName);
     index_logger_logger.debug(`Tool ${toolName} set enabled in group:`, groupId);
+    if (resetCursor) {
+        toolGroup.getViewportIds().forEach(id => {
+            const element = document.getElementById(id);
+            if (element) {
+                index_cursors_setCursorForElement(element, "default");
+            }
+        });
+    }
 };
 /**
  * @function syncViewportsCamera
@@ -283798,6 +283826,75 @@ targetViewportId, sourceViewportId) {
     index_logger_logger.debug(`Camera sync added from ${sourceViewportId} to ${targetViewportId}`);
     // FIXME: how to force a refresh of the viewport?
 };
+/**
+ * @function syncViewportsVOI
+ * @desc  Synchronizes the contrast of two (volume) viewports
+ * @param id - unique id for the synchronizer @default "default"
+ * @param targetViewportId - the id of the target viewport where the camera will be synced
+ * @param sourceViewportId - the id of the source viewport from where the camera position will be taken
+ */
+const index_syncViewportsVOI = function (id = "default", // unique id for the synchronizer
+targetViewportId, sourceViewportId) {
+    var _a, _b, _c, _d;
+    let voiSync = index_SynchronizerManager_getSynchronizer(id);
+    const options = {
+        syncInvertState: true,
+        syncColormap: true
+    };
+    if (!voiSync) {
+        voiSync = index_createVOISynchronizer(id, options);
+    }
+    else if (voiSync) {
+        // cameraSync.getSourceViewports().forEach((viewportId) => {
+        //   cameraSync!.removeSource(viewportId);
+        // });
+        index_SynchronizerManager_destroySynchronizer(id);
+        voiSync = index_createVOISynchronizer(id, options);
+    }
+    const targetRenderingEngineId = (_a = index_getEnabledElementByViewportId(targetViewportId)) === null || _a === void 0 ? void 0 : _a.renderingEngineId;
+    const sourceRenderingEngineId = (_b = index_getEnabledElementByViewportId(sourceViewportId)) === null || _b === void 0 ? void 0 : _b.renderingEngineId;
+    if (!targetRenderingEngineId || !sourceRenderingEngineId) {
+        index_logger_logger.error("syncViewportsCamera: no rendering engine found for one of the viewports");
+        return;
+    }
+    const sourceViewport = (_c = index_getEnabledElementByViewportId(sourceViewportId)) === null || _c === void 0 ? void 0 : _c.viewport;
+    if (!sourceViewport) {
+        index_logger_logger.error("syncViewportsCamera: source viewport not found");
+        return;
+    }
+    const sourceViewRef = sourceViewport.getViewReference();
+    const targetViewport = (_d = index_getEnabledElementByViewportId(targetViewportId)) === null || _d === void 0 ? void 0 : _d.viewport;
+    if (!targetViewport) {
+        index_logger_logger.error("syncViewportsCamera: target viewport not found");
+        return;
+    }
+    targetViewport.setViewReference(sourceViewRef);
+    voiSync.add({
+        renderingEngineId: sourceRenderingEngineId,
+        viewportId: sourceViewportId
+    });
+    voiSync.add({
+        renderingEngineId: targetRenderingEngineId,
+        viewportId: targetViewportId
+    });
+    const targetElement = index_getEnabledElementByViewportId(targetViewportId);
+    targetElement.viewport.render();
+    const sourceElement = index_getEnabledElementByViewportId(sourceViewportId);
+    sourceElement.viewport.render();
+    index_logger_logger.debug(`Camera sync added from ${sourceViewportId} to ${targetViewportId}`);
+};
+/**
+ * @function syncViewports
+ * @desc  Synchronizes the camera position and contrast of two (volume) viewports
+ * @param id - unique id for the synchronizer @default "default"
+ * @param targetViewportId - the id of the target viewport where the camera will be synced
+ * @param sourceViewportId - the id of the source viewport from where the camera position will be taken
+ */
+const index_syncViewports = function (id = "default", // unique id for the synchronizer
+targetViewportId, sourceViewportId) {
+    index_syncViewportsCamera(id, targetViewportId, sourceViewportId);
+    index_syncViewportsVOI(id, targetViewportId, sourceViewportId);
+};
 /**
  * Create a tool group and add the specified viewports and tools to it.
  * @function createToolGroup
@@ -284131,44 +284228,58 @@ const index_setVolumeForRenderingEngine = function (volumeId, renderingEngineId)
     ], renderingEngine.getVolumeViewports().map(v => v.id));
 };
 const index_renderMpr = function (series, renderingEngineId, options) {
-    const t0 = performance.now();
-    const renderingEngine = index_getRenderingEngine(renderingEngineId);
-    if (!renderingEngine) {
-        index_logger_logger.error(`Rendering engine with id ${renderingEngineId} not found. Please initialize it first.`);
-        return new Promise((_, reject) => reject(`Rendering engine with id ${renderingEngineId} not found.`));
-    }
-    const viewports = renderingEngine.getVolumeViewports();
-    if (viewports.length === 0) {
-        index_logger_logger.error(`No volume viewports found for rendering engine ${renderingEngineId}. Please initialize them first.`);
-        return new Promise((_, reject) => reject(`No volume viewports found for rendering engine ${renderingEngineId}.`));
-    }
-    // const renderOptions = options ? options : {};
-    // // TODO: CONTROLLA IMAGE ID NEL CASO DI MPR
-    // //let data: StoreViewport = getSeriesData(series, renderOptions);
-    const renderPromise = new Promise((resolve, _) => index_imaging3d_imageRendering_awaiter(this, void 0, void 0, function* () {
-        // crea o prendi il volume dalla cache
-        // const volume =
-        //   cornerstone.cache.getVolume(series.uniqueUID) ||
-        //   (await loadAndCacheVolume(series));
-        // console.log("volume", volume);
-        const volume = yield index_loadAndCacheVolume(series);
-        index_setVolumeForRenderingEngine(volume.volumeId, renderingEngineId);
-        renderingEngine.renderViewports(viewports.map(v => v.id));
-        const t1 = performance.now();
-        // TODO modificare lo store
-        // storeViewportData(image, element.id, storedViewport as Viewport, data);
-        (0,index_lodash.each)(viewports, function (viewport) {
-            index_imageStore_set(["ready", viewport.id, true]);
-        });
-        const t2 = performance.now();
-        index_logger_logger.debug(`Time to render volume: ${t2 - t1} milliseconds`);
-        // @ts-ignore
-        series = null;
-        // @ts-ignore
-        //data = null;
-        resolve();
-    }));
-    return renderPromise;
+    return index_imaging3d_imageRendering_awaiter(this, void 0, void 0, function* () {
+        const t0 = performance.now();
+        const renderingEngine = index_getRenderingEngine(renderingEngineId);
+        if (!renderingEngine) {
+            index_logger_logger.error(`Rendering engine with id ${renderingEngineId} not found. Please initialize it first.`);
+            throw new Error(`Rendering engine with id ${renderingEngineId} not found.`);
+        }
+        const viewports = renderingEngine.getVolumeViewports();
+        if (viewports.length === 0) {
+            index_logger_logger.error(`No volume viewports found for rendering engine ${renderingEngineId}. Please initialize them first.`);
+            throw new Error(`No volume viewports found for rendering engine ${renderingEngineId}.`);
+        }
+        // const renderOptions = options ? options : {};
+        // // TODO: CONTROLLA IMAGE ID NEL CASO DI MPR
+        // //let data: StoreViewport = getSeriesData(series, renderOptions);
+        const renderPromise = new Promise((resolve, _) => index_imaging3d_imageRendering_awaiter(this, void 0, void 0, function* () {
+            // crea o prendi il volume dalla cache
+            // const volume =
+            //   cornerstone.cache.getVolume(series.uniqueUID) ||
+            //   (await loadAndCacheVolume(series));
+            // console.log("volume", volume);
+            const volume = yield index_loadAndCacheVolume(series);
+            index_setVolumeForRenderingEngine(volume.volumeId, renderingEngineId);
+            renderingEngine.renderViewports(viewports.map(v => v.id));
+            const t1 = performance.now();
+            // TODO modificare lo store
+            // storeViewportData(image, element.id, storedViewport as Viewport, data);
+            (0,index_lodash.each)(viewports, function (viewport) {
+                index_imageStore_set(["ready", viewport.id, true]);
+            });
+            const t2 = performance.now();
+            index_logger_logger.debug(`Time to render volume: ${t2 - t1} milliseconds`);
+            // @ts-ignore
+            series = null;
+            // @ts-ignore
+            //data = null;
+            resolve();
+        }));
+        // Wait for the render promise to complete
+        yield renderPromise;
+        // !!! setTimeout needed to et default viewport propertie to globalDefaultProperties
+        setTimeout(() => {
+            viewports.forEach(viewport => {
+                var _a;
+                const viewportElement = (_a = index_getEnabledElementByViewportId(viewport.id)) === null || _a === void 0 ? void 0 : _a.viewport;
+                if (viewportElement) {
+                    viewportElement.setDefaultProperties(viewportElement.getProperties());
+                }
+            });
+        }, 0);
+        return renderingEngine;
+    });
 };
 /**
  * Unload a MPR rendering engine
@@ -284202,6 +284313,30 @@ const index_resizeRenderingEngine = function (renderingEngineId) {
     }
     renderingEngine.resize(true, true); // true flags for fitToWindow and forceResize
 };
+/**
+ * Reset viewport values (contrast, pan and zoom)
+ * @instance
+ * @function resetViewports
+ * @param {Array} elementIds - The array of hmtl div ids
+ * @param {Array} keys - The array of viewport sections to resets (default is all)
+ */
+const index_imageRendering_resetViewports = function (elementIds, keys) {
+    (0,index_lodash.each)(elementIds, function (elementId) {
+        const viewport = index_getEnabledElementByViewportId(elementId).viewport;
+        if (!keys || (keys === null || keys === void 0 ? void 0 : keys.includes("zoom"))) {
+            viewport.setZoom(1);
+        }
+        if (!keys || (keys === null || keys === void 0 ? void 0 : keys.includes("pan"))) {
+            viewport.setPan([0, 0]);
+        }
+        if (!keys || (keys === null || keys === void 0 ? void 0 : keys.includes("contrast"))) {
+            const defaultVoiRange = viewport.getDefaultProperties(viewport.getCurrentImageId()).voiRange;
+            viewport.setProperties({ voiRange: defaultVoiRange });
+        }
+        //TODO - add reset rotation
+        viewport.render();
+    });
+};
 // /**
 //  * Purge the cornestone internal cache
 //  * If seriesId is passed as argument only imageIds of the series are purged from internal cache

package/package.json

@@ -6,7 +6,7 @@
     "medical",
     "cornerstone"
   ],
-  "version": "4.0.0-alpha.13",
+  "version": "4.0.0-alpha.15",
   "description": "typescript library for parsing, loading, rendering and interacting with DICOM images",
   "repository": {
     "url": "https://github.com/dvisionlab/Larvitar.git",