@cornerstonejs/core 0.38.0 → 0.40.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cornerstonejs/core",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "",
   "main": "dist/umd/index.js",
   "types": "dist/esm/index.d.ts",
@@ -51,5 +51,5 @@
     "type": "individual",
     "url": "https://ohif.org/donate"
   },
-  "gitHead": "9a2711ca032949079e7b96ba332b6e01b3316da8"
+  "gitHead": "b21acf448f3b24c4ff109da5208bc313c0289b81"
 }

package/src/enums/Events.ts

@@ -188,6 +188,11 @@ enum Events {
    */
   GEOMETRY_CACHE_GEOMETRY_ADDED = 'CORNERSTONE_GEOMETRY_CACHE_GEOMETRY_ADDED',
 
+  /**
+   * Triggers when the scroll function is called with a delta that is out of bounds.
+   * This is usually for signaling that the user may want a different volume for partially loaded volumes which is meant to optimize memory.
+   */
+  VOLUME_SCROLL_OUT_OF_BOUNDS = 'CORNERSTONE_VOLUME_SCROLL_OUT_OF_BOUNDS',
   // IMAGE_CACHE_FULL = 'CORNERSTONE_IMAGE_CACHE_FULL',
   // PRE_RENDER = 'CORNERSTONE_PRE_RENDER',
   // ELEMENT_RESIZED = 'CORNERSTONE_ELEMENT_RESIZED',

package/src/init.ts

@@ -13,6 +13,7 @@ const defaultConfig = {
     preferSizeOverAccuracy: false,
     useCPURendering: false,
     useNorm16Texture: false, // _hasNorm16TextureSupport(),
+    strictZSpacingForVolumeViewport: true,
   },
   // cache
   // ...
@@ -24,6 +25,7 @@ let config = {
     preferSizeOverAccuracy: false,
     useCPURendering: false,
     useNorm16Texture: false, // _hasNorm16TextureSupport(),
+    strictZSpacingForVolumeViewport: true,
   },
   // cache
   // ...

package/src/types/Cornerstone3DConfig.ts

@@ -25,6 +25,16 @@ type Cornerstone3DConfig = {
     // https://bugs.webkit.org/show_bug.cgi?id=252039
     useNorm16Texture: boolean;
     useCPURendering: boolean;
+    /**
+     * flag to control whether to use fallback behavior for z-spacing calculation in
+     * volume viewports when the necessary metadata is missing. If enabled,
+     * we will fall back to using slice thickness or a default value of 1 to render
+     * the volume viewport when z-spacing cannot be calculated from images
+     * This can help improve the usability and robustness of the visualization
+     * in scenarios where the metadata is incomplete or missing, but
+     * it might be wrong assumption in certain scenarios.
+     */
+    strictZSpacingForVolumeViewport: boolean;
   };
 };
 

package/src/utilities/getVolumeViewportScrollInfo.ts

@@ -11,10 +11,8 @@ function getVolumeViewportScrollInfo(
   viewport: IVolumeViewport,
   volumeId: string
 ) {
-  const { sliceRange, spacingInNormalDirection } = getVolumeSliceRangeInfo(
-    viewport,
-    volumeId
-  );
+  const { sliceRange, spacingInNormalDirection, camera } =
+    getVolumeSliceRangeInfo(viewport, volumeId);
 
   const { min, max, current } = sliceRange;
 
@@ -26,7 +24,15 @@ function getVolumeViewportScrollInfo(
   const floatingStepNumber = fraction * numScrollSteps;
   const currentStepIndex = Math.round(floatingStepNumber);
 
-  return { numScrollSteps, currentStepIndex };
+  return {
+    numScrollSteps,
+    currentStepIndex,
+    sliceRangeInfo: {
+      sliceRange,
+      spacingInNormalDirection,
+      camera,
+    },
+  };
 }
 
 export default getVolumeViewportScrollInfo;