larvitar 3.3.3 → 3.4.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.
@@ -59,7 +59,7 @@ export declare const registerDsaImageLoader: () => void;
59
59
  * @function updateLoadedStack
60
60
  * @param {Object} seriesData - Cornerstone series object
61
61
  * @param {Object} allSeriesStack - Dict containing all series objects
62
- * @param {String} customId - Optional custom id to overwrite seriesUID as default one
62
+ * @param {String} customId - Optional custom id to overwrite uniqueUID as default one
63
63
  * @param {number} sliceIndex - Optional custom index to overwrite slice index as default one
64
64
  */
65
65
  export declare const updateLoadedStack: (seriesData: ImageObject, allSeriesStack: ReturnType<typeof getImageManager>, customId?: string, sliceIndex?: number) => void;
@@ -17,7 +17,7 @@ export declare const populateImageManager: (uniqueUID: string, data: Series) =>
17
17
  * @instance
18
18
  * @function updateImageManager
19
19
  * @param {Object} imageObject The single dicom object
20
- * @param {String} customId - Optional custom id to overwrite seriesUID as default one
20
+ * @param {String} customId - Optional custom id to overwrite uniqueUID as default one
21
21
  * @param {number} sliceIndex - Optional custom index to overwrite slice index as default one
22
22
  */
23
23
  export declare const updateImageManager: (imageObject: ImageObject, customId?: string, sliceIndex?: number) => {
@@ -9,9 +9,9 @@ import { RenderProps, Series, StoreViewport, Viewport } from "./types";
9
9
  * If seriesId is passed as argument only imageIds of the series are purged from internal cache
10
10
  * @instance
11
11
  * @function clearImageCache
12
- * @param {String} seriesId - The id of the serie
12
+ * @param {String} uniqueUID - The uniqueUID of the series
13
13
  */
14
- export declare const clearImageCache: (seriesId?: string) => void;
14
+ export declare const clearImageCache: (uniqueUID?: string) => void;
15
15
  /**
16
16
  * Load and cache a single image
17
17
  * Add series's imageIds into store
@@ -64,6 +64,9 @@ export declare const renderFileImage: (file: File, elementId: string | HTMLEleme
64
64
  export declare const renderWebImage: (url: string, elementId: string | HTMLElement) => Promise<cornerstone.Image>;
65
65
  /**
66
66
  * Unrender an image on a html div using cornerstone
67
+ * Remove mouse listeners
68
+ * Remove uniqueUID from viewport store
69
+ * Remove ready flag from viewport store
67
70
  * @instance
68
71
  * @function disableViewport
69
72
  * @param {String} elementId - The html div id used for rendering or its DOM HTMLElement
@@ -71,13 +74,16 @@ export declare const renderWebImage: (url: string, elementId: string | HTMLEleme
71
74
  export declare const disableViewport: (elementId: string | HTMLElement) => void;
72
75
  /**
73
76
  * Unrender an image on a html div using cornerstone
74
- * Remove image from cornerstone cache and remove from store
77
+ * Remove mouse listeners
78
+ * Remove uniqueUID from viewport store
79
+ * Remove ready flag from viewport store
80
+ * Remove image from cornerstone cache
81
+ * Delete viewport from store
75
82
  * @instance
76
83
  * @function unloadViewport
77
84
  * @param {String} elementId - The html div id used for rendering or its DOM HTMLElement
78
- * @param {String} seriesId - The id of the serie
79
85
  */
80
- export declare const unloadViewport: (elementId: string, seriesId: string) => void;
86
+ export declare const unloadViewport: (elementId: string) => void;
81
87
  /**
82
88
  * Resize a viewport using cornerstone resize
83
89
  * And forcing fit to window
@@ -17,7 +17,7 @@ type Store = {
17
17
  leftActiveTool?: string;
18
18
  rightActiveTool?: string;
19
19
  series: {
20
- [seriesUID: string]: StoreSeries;
20
+ [uniqueUID: string]: StoreSeries;
21
21
  };
22
22
  viewports: {
23
23
  [key: string]: StoreViewport;
@@ -32,7 +32,7 @@ type SetPayload = ["errorLog" | "leftActiveTool" | "rightActiveTool", string] |
32
32
  ("progress" | "loading" | "minPixelValue" | "maxPixelValue" | "minSliceId" | "maxSliceId" | "minTimeId" | "maxTimeId" | "rotation" | "scale" | "sliceId" | "timeId" | "thickness" | "numberOfFrames" | "numberOfTemporalPositions"),
33
33
  string,
34
34
  number
35
- ] | ["cached", string, string, boolean] | ["timestamp", string, number | undefined] | ["seriesUID" | "modality", string, string | undefined] | ["pendingSliceId", string, number | undefined] | ["timestamps" | "timeIds" | "pixelShift", string, number[]] | [
35
+ ] | ["cached", string, string, boolean] | ["timestamp", string, number | undefined] | ["uniqueUID" | "modality", string, string | undefined] | ["pendingSliceId", string, number | undefined] | ["timestamps" | "timeIds" | "pixelShift", string, number[]] | [
36
36
  "contrast" | "dimensions" | "spacing" | "translation",
37
37
  string,
38
38
  number,
@@ -53,9 +53,9 @@ declare const _default: {
53
53
  initialize: () => void;
54
54
  addViewport: (name: string) => void;
55
55
  deleteViewport: (name: string) => void;
56
- addSeriesId: (seriesId: string, imageIds: string[]) => void;
57
- removeSeriesId: (seriesId: string) => void;
58
- resetSeriesIds: () => void;
56
+ addImageIds: (uniqueUID: string, imageIds: string[]) => void;
57
+ removeImageIds: (uniqueUID: string) => void;
58
+ resetImageIds: () => void;
59
59
  setSliceId: (elementId: string, imageIndex: number) => void;
60
60
  setPendingSliceId: (elementId: string, imageIndex: number) => void;
61
61
  setMaxSliceId: (elementId: string, imageIndex: number) => void;
@@ -68,7 +68,7 @@ declare const _default: {
68
68
  removeStoreListener: () => undefined;
69
69
  addViewportListener: (elementId: string, listener: (data: StoreViewport) => {}) => void;
70
70
  removeViewportListener: (elementId: string) => void;
71
- addSeriesListener: (seriesId: string, listener: (data: StoreSeries) => {}) => void;
72
- removeSeriesListener: (seriesId: string) => void;
71
+ addSeriesListener: (uniqueUID: string, listener: (data: StoreSeries) => {}) => void;
72
+ removeSeriesListener: (uniqueUID: string) => void;
73
73
  };
74
74
  export default _default;
@@ -143,12 +143,12 @@ export declare const getDistanceBetweenSlices: (seriesData: Series, sliceIndex1:
143
143
  /**
144
144
  * @instance
145
145
  * @function getImageMetadata
146
- * @param {String} seriesId - The seriesUID
146
+ * @param {String} uniqueUID - The unique UID of the series
147
147
  * @param {String} instanceUID - The SOPInstanceUID
148
148
  * @param {number} frameId - Optional FrameId
149
149
  * @return {Array} - List of metadata objects: tag, name and value
150
150
  */
151
- export declare const getImageMetadata: (seriesId: string, instanceUID: string, frameId?: number) => ({
151
+ export declare const getImageMetadata: (uniqueUID: string, instanceUID: string, frameId?: number) => ({
152
152
  tag: string;
153
153
  name: string;
154
154
  value: {
@@ -15,7 +15,7 @@ export declare const loadMultiFrameImage: ImageLoader;
15
15
  * Build the multiframe layout in the Image Manager
16
16
  * @export
17
17
  * @function buildMultiFrameImage
18
- * @param {String} seriesId - SeriesId tag
18
+ * @param {String} uniqueUID - the uniqueUID of the series
19
19
  * @param {Object} serie - parsed serie object
20
20
  */
21
21
  export declare const buildMultiFrameImage: (uniqueUID: string, serie: Series) => void;
@@ -31,6 +31,6 @@ export declare const getMultiFrameImageId: (customLoaderName: string) => string;
31
31
  * Clear the multiframe cache
32
32
  * @instance
33
33
  * @function clearMultiFrameCache
34
- * @param {String} seriesId - SeriesId tag
34
+ * @param {String} uniqueUID - the uniqueUID of the series
35
35
  */
36
- export declare const clearMultiFrameCache: (seriesId: string) => void;
36
+ export declare const clearMultiFrameCache: (uniqueUID: string) => void;
@@ -6,15 +6,15 @@
6
6
  * Check memory allocation and clear memory if needed
7
7
  * @instance
8
8
  * @function checkAndClearMemory
9
- * @param {Number} - Number of bytes to allocate
10
- * @param {Array} - Rendered Series ids
9
+ * @param {Number} bytes - Number of bytes to allocate
10
+ * @param {Array} renderedSeriesIds - Rendered Series ids
11
11
  */
12
12
  export declare const checkAndClearMemory: (bytes: number, renderedSeriesIds: string[]) => void;
13
13
  /**
14
14
  * Check memory allocation and returns false if js Heap size has reached its limit
15
15
  * @instance
16
16
  * @function checkMemoryAllocation
17
- * @param {Number} - Number of bytes to allocate
17
+ * @param {Number} bytes - Number of bytes to allocate
18
18
  * @return {Boolean} - Returns a boolean flag to warn the user about memory allocation limit
19
19
  */
20
20
  export declare const checkMemoryAllocation: (bytes: number) => boolean;
@@ -24,7 +24,7 @@ export declare const checkMemoryAllocation: (bytes: number) => boolean;
24
24
  * @function getUsedMemory
25
25
  * @return {Number} - Returns used JSHeapSize in bytes or NaN if not supported
26
26
  */
27
- export declare const getUsedMemory: () => any;
27
+ export declare const getUsedMemory: () => number;
28
28
  /**
29
29
  * Check performance.memory browser support and returns available Js Heap Size in Mb
30
30
  * @instance
@@ -36,6 +36,6 @@ export declare const getAvailableMemory: () => number;
36
36
  * Check performance.memory browser support and returns available Js Heap Size in Mb
37
37
  * @instance
38
38
  * @function setAvailableMemory
39
- * @param {Number} - Number of GB to set as maximum custom memory limit
39
+ * @param {Number} value - Number of GB to set as maximum custom memory limit
40
40
  */
41
41
  export declare const setAvailableMemory: (value: number) => void;
@@ -28,7 +28,7 @@ export default class GspsTool extends BaseTool {
28
28
  handleElement(element: HTMLElement): Promise<EnabledElement | undefined>;
29
29
  retrieveLarvitarManager(imageId: string): {
30
30
  manager: ImageManager;
31
- seriesId: string;
31
+ uniqueUID: string;
32
32
  };
33
33
  }
34
34
  export {};
@@ -11,21 +11,16 @@ import type { ToolConfig, ToolSettings, ToolStyle } from "./types";
11
11
  * @example larvitar.initializeCSTools({showSVGCursors:false}, {color: "0000FF"});
12
12
  */
13
13
  declare const initializeCSTools: (settings?: ToolSettings, style?: ToolStyle) => void;
14
- /**
15
- * Create stack object to sync stack tools
16
- * @function csToolsCreateStack
17
- * @param {HTMLElement} element - The target html element.
18
- * @param {Array} imageIds - Stack image ids.
19
- * @param {number?} currentImageIndex - The current image id.
20
- */
21
- declare const csToolsCreateStack: (element: HTMLElement, imageIds: string[], currentImageIndex?: number) => void;
22
14
  /**
23
15
  * Update stack object to sync stack tools
24
- * @function csToolsUpdateImageIds
25
- * @param {String} elementId - The target html element id.
26
- * @param {Array} imageIds - Stack image ids.
16
+ * @function csToolsUpdateStack
17
+ * @param {string | HTMLElement} elementId - The target html element or its id.
18
+ * @param {Object} stack - The stack object.
27
19
  */
28
- export declare function csToolsUpdateImageIds(elementId: string, imageIds: string[]): void;
20
+ export declare function csToolsUpdateStack(elementId: string | HTMLElement, stack: {
21
+ imageIds?: string[];
22
+ currentImageIdIndex?: number;
23
+ }): void;
29
24
  /**
30
25
  * Add a cornerstone tool (grab it from original library or dvision custom tools)
31
26
  * @param {*} toolName
@@ -36,8 +31,11 @@ declare const addTool: (toolName: string, customConfig: Partial<ToolConfig>, tar
36
31
  /**
37
32
  * Add all default tools, as listed in tools/default.js
38
33
  * @function addDefaultTools
34
+ * @param {string | HTMLElement} elementId - The target html element or its id.
35
+ * @param {boolean} wwwcSync - Flag to enable synchronizer for wwwcSynchronizer. @default false
36
+ * @returns {void} - void
39
37
  */
40
- export declare const addDefaultTools: (elementId: string) => void;
38
+ export declare const addDefaultTools: (elementId: string | HTMLElement, wwwcSync?: boolean) => void;
41
39
  /**
42
40
  * Set Tool "active" on all elements (ie, rendered and manipulable) & refresh cornerstone elements
43
41
  * @function setToolActive
@@ -77,4 +75,4 @@ declare const setToolPassive: (toolName: string, viewports?: string[]) => void;
77
75
  * @param {Object} style - the style object (see tools/defaults.js)
78
76
  */
79
77
  declare const setToolsStyle: (style?: ToolStyle) => void;
80
- export { initializeCSTools, setToolsStyle, csToolsCreateStack, addTool, setToolActive, setToolEnabled, setToolDisabled, setToolPassive };
78
+ export { initializeCSTools, setToolsStyle, addTool, setToolActive, setToolEnabled, setToolDisabled, setToolPassive };
package/dist/index.d.ts CHANGED
@@ -23,7 +23,7 @@ import { readFile, readFiles, parseDataSet, clearImageParsing, convertQidoMetada
23
23
  import { clearImageCache, loadAndCacheImages, renderFileImage, renderDICOMPDF, renderWebImage, disableViewport, unloadViewport, resizeViewport, renderImage, redrawImage, resetViewports, updateViewportData, storeViewportData, invertImage, flipImageHorizontal, flipImageVertical, rotateImageLeft, rotateImageRight, updateTemporalViewportData } from "./imaging/imageRendering";
24
24
  import { resliceSeries } from "./imaging/imageReslice";
25
25
  import { addDiameterTool, addContoursTool, addMaskEditingTool, getCurrentMaskData, addStackStateToElement, addSeedsTool, clearMeasurements, getToolState, clearToolStateByName, updateDiameterTool, addToolStateSingleSlice, clearCornerstoneElements, syncToolStack, updateStackToolState, setSegmentationConfig } from "./imaging/imageTools";
26
- import { csToolsCreateStack, csToolsUpdateImageIds, initializeCSTools, setToolsStyle, addDefaultTools, addTool, setToolActive, setToolDisabled, setToolEnabled, setToolPassive } from "./imaging/tools/main";
26
+ import { csToolsUpdateStack, initializeCSTools, setToolsStyle, addDefaultTools, addTool, setToolActive, setToolDisabled, setToolEnabled, setToolPassive } from "./imaging/tools/main";
27
27
  import { DEFAULT_TOOLS, dvTools, getDefaultToolsByType, setDefaultToolsProps, registerExternalTool } from "./imaging/tools/default";
28
28
  import { initSegmentationModule, addSegmentationMask, clearSegmentationState, deleteMask, setActiveLabelmap, setActiveSegment, enableBrushTool, disableBrushTool, undoLastStroke, redoLastStroke, setBrushProps, toggleContourMode, toggleVisibility, hexToRgb, rgbToHex, getActiveLabelmapBuffer } from "./imaging/tools/segmentation";
29
29
  import { getImageFrame } from "./imaging/loaders/commonLoader";
@@ -38,7 +38,7 @@ import { getColormapsList, applyColorMap, addColorMap, fillPixelData, HSVToRGB }
38
38
  import { applyDSAShift } from "./imaging/postProcessing/applyDSA";
39
39
  import { addMouseKeyHandlers, removeMouseKeyHandlers, toggleMouseToolsListeners } from "./imaging/tools/interaction";
40
40
  import { updateImageManager, populateImageManager, getImageManager, resetImageManager, removeDataFromImageManager, getDataFromImageManager, getSopInstanceUIDFromImageManager, getImageTracker, populateGSPSManager, getGSPSManager, resetGSPSManager, getFileManager, resetFileManager, populateFileManager, getDataFromFileManager } from "./imaging/imageManagers";
41
- export { 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, 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, csToolsCreateStack, csToolsUpdateImageIds, initializeCSTools, setToolsStyle, addDefaultTools, addTool, setToolActive, setToolDisabled, setToolEnabled, setToolPassive, DEFAULT_TOOLS, dvTools, getDefaultToolsByType, setDefaultToolsProps, registerExternalTool, addMouseKeyHandlers, removeMouseKeyHandlers, initSegmentationModule, addSegmentationMask, setActiveLabelmap, setActiveSegment, undoLastStroke, redoLastStroke, setBrushProps, hexToRgb, rgbToHex, clearSegmentationState, deleteMask, enableBrushTool, disableBrushTool, toggleContourMode, toggleVisibility, getActiveLabelmapBuffer, updateTemporalViewportData, logger, setLogLevel };
41
+ export { 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, 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, addMouseKeyHandlers, removeMouseKeyHandlers, initSegmentationModule, addSegmentationMask, setActiveLabelmap, setActiveSegment, undoLastStroke, redoLastStroke, setBrushProps, hexToRgb, rgbToHex, clearSegmentationState, deleteMask, enableBrushTool, disableBrushTool, toggleContourMode, toggleVisibility, getActiveLabelmapBuffer, updateTemporalViewportData, logger, setLogLevel };
42
42
  export declare const updateLarvitarManager: (...args: any) => any;
43
43
  export declare const populateLarvitarManager: (...args: any) => any;
44
44
  export declare const getLarvitarManager: (...args: any) => any;
@@ -52,3 +52,5 @@ export declare const getInstanceGSPSDict: (...args: any) => any;
52
52
  export declare const resetInstanceGSPSDict: (...args: any) => any;
53
53
  export declare const getFileImageId: (...args: any) => any;
54
54
  export declare const updateImage: (...args: any) => any;
55
+ export declare const csToolsUpdateImageIds: (...args: any) => any;
56
+ export declare const csToolsCreateStack: (...args: any) => any;