@cornerstonejs/tools 1.72.5 → 1.72.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cornerstonejs/tools",
-  "version": "1.72.5",
+  "version": "1.72.6",
   "description": "Cornerstone3D Tools",
   "main": "src/index.ts",
   "types": "dist/types/index.d.ts",
@@ -29,7 +29,7 @@
     "webpack:watch": "webpack --mode development --progress --watch  --config ./.webpack/webpack.dev.js"
   },
   "dependencies": {
-    "@cornerstonejs/core": "^1.72.5",
+    "@cornerstonejs/core": "^1.72.6",
     "@icr/polyseg-wasm": "0.4.0",
     "@types/offscreencanvas": "2019.7.3",
     "comlink": "^4.4.1",
@@ -59,5 +59,5 @@
     "type": "individual",
     "url": "https://ohif.org/donate"
   },
-  "gitHead": "475e831d61c00535b40c108a8b940e5bdf3ae0f6"
+  "gitHead": "992f6c69b8f57a3344a1e8ec676376be693ec555"
 }

package/src/stateManagement/annotation/FrameOfReferenceSpecificAnnotationManager.ts

@@ -19,6 +19,11 @@ import {
 import { checkAndDefineIsLockedProperty } from './annotationLocking';
 import { checkAndDefineIsVisibleProperty } from './annotationVisibility';
 
+import {
+  checkAndDefineTextBoxProperty,
+  checkAndDefineCachedStatsProperty,
+} from './utilities/defineProperties';
+
 /**
  * This is the default annotation manager. It stores annotations by default
  * based on the FrameOfReferenceUID. However, it is possible to override the
@@ -236,6 +241,8 @@ class FrameOfReferenceSpecificAnnotationManager implements IAnnotationManager {
     toolSpecificAnnotations.push(annotation);
     checkAndDefineIsLockedProperty(annotation);
     checkAndDefineIsVisibleProperty(annotation);
+    checkAndDefineTextBoxProperty(annotation);
+    checkAndDefineCachedStatsProperty(annotation);
   };
 
   /**

package/src/stateManagement/annotation/utilities/defineProperties.ts

@@ -0,0 +1,26 @@
+import { Annotation } from '../../../types';
+
+const checkAndDefineTextBoxProperty = (annotation: Annotation) => {
+  if (!annotation.data) {
+    annotation.data = {};
+  }
+  if (!annotation.data.handles) {
+    annotation.data.handles = {};
+  }
+  if (!annotation.data.handles.textBox) {
+    annotation.data.handles.textBox = {};
+  }
+  return annotation;
+};
+
+const checkAndDefineCachedStatsProperty = (annotation: Annotation) => {
+  if (!annotation.data) {
+    annotation.data = {};
+  }
+  if (!annotation.data.cachedStats) {
+    annotation.data.cachedStats = {};
+  }
+  return annotation;
+};
+
+export { checkAndDefineTextBoxProperty, checkAndDefineCachedStatsProperty };

package/src/types/AnnotationTypes.ts

@@ -55,9 +55,9 @@ type Annotation = {
       /** annotation text box information */
       textBox?: {
         /** whether the text box has moved */
-        hasMoved: boolean;
+        hasMoved?: boolean;
         /** the world location of the text box */
-        worldPosition: Types.Point3;
+        worldPosition?: Types.Point3;
         /** text box bounding box information */
         worldBoundingBox?: {
           /** Top left location of the text box in the world space */

package/src/utilities/annotationHydration.ts

@@ -0,0 +1,143 @@
+import {
+  Types,
+  utilities,
+  BaseVolumeViewport,
+  StackViewport,
+  cache,
+  metaData,
+} from '@cornerstonejs/core';
+import { Annotation } from '../types';
+import { addAnnotation } from '../stateManagement';
+import { vec3 } from 'gl-matrix';
+
+function annotationHydration(
+  viewport: Types.IViewport,
+  toolName: string,
+  worldPoints: Types.Point3[],
+  options?: {
+    FrameOfReferenceUID?: string;
+    annotationUID?: string;
+  }
+): Annotation {
+  const viewReference = viewport.getViewReference();
+  const { viewPlaneNormal, FrameOfReferenceUID } = viewReference;
+  const annotation = {
+    annotationUID: options?.annotationUID || utilities.uuidv4(),
+    data: {
+      handles: {
+        points: worldPoints,
+      },
+    },
+    highlighted: false,
+    autoGenerated: false,
+    invalidated: false,
+    isLocked: false,
+    isVisible: true,
+    metadata: {
+      toolName,
+      viewPlaneNormal,
+      FrameOfReferenceUID,
+      referencedImageId: getReferencedImageId(
+        viewport,
+        worldPoints[0],
+        viewPlaneNormal
+      ),
+      ...options,
+    },
+  };
+  addAnnotation(annotation, viewport.element);
+  return annotation;
+}
+
+function getReferencedImageId(
+  viewport: Types.IViewport,
+  worldPos: Types.Point3,
+  viewPlaneNormal: Types.Point3
+): string {
+  let referencedImageId;
+
+  if (viewport instanceof StackViewport) {
+    referencedImageId = getClosestImageIdForStackViewport(
+      viewport,
+      worldPos,
+      viewPlaneNormal
+    );
+  } else if (viewport instanceof BaseVolumeViewport) {
+    const targetId = getTargetId(viewport);
+    const volumeId = utilities.getVolumeId(targetId);
+    const imageVolume = cache.getVolume(volumeId);
+
+    referencedImageId = utilities.getClosestImageId(
+      imageVolume,
+      worldPos,
+      viewPlaneNormal
+    );
+  } else {
+    throw new Error(
+      'getReferencedImageId: viewport must be a StackViewport or BaseVolumeViewport'
+    );
+  }
+
+  return referencedImageId;
+}
+
+function getTargetId(viewport: Types.IViewport): string | undefined {
+  const targetId = viewport.getReferenceId?.();
+  if (targetId) {
+    return targetId;
+  }
+  if (viewport instanceof BaseVolumeViewport) {
+    return `volumeId:${getTargetVolumeId(viewport)}`;
+  }
+  throw new Error('getTargetId: viewport must have a getTargetId method');
+}
+
+function getTargetVolumeId(viewport: Types.IViewport): string | undefined {
+  const actorEntries = viewport.getActors();
+
+  if (!actorEntries) {
+    return;
+  }
+  return actorEntries.find(
+    (actorEntry) => actorEntry.actor.getClassName() === 'vtkVolume'
+  )?.uid;
+}
+
+function getClosestImageIdForStackViewport(
+  viewport: StackViewport,
+  worldPos: Types.Point3,
+  viewPlaneNormal: Types.Point3
+): string {
+  const imageIds = viewport.getImageIds();
+  if (!imageIds || !imageIds.length) {
+    return;
+  }
+
+  const distanceImagePairs = imageIds.map((imageId) => {
+    const { imagePositionPatient } = metaData.get('imagePlaneModule', imageId);
+    const distance = calculateDistanceToImage(
+      worldPos,
+      imagePositionPatient,
+      viewPlaneNormal
+    );
+    return { imageId, distance };
+  });
+
+  distanceImagePairs.sort((a, b) => a.distance - b.distance);
+
+  return distanceImagePairs[0].imageId;
+}
+
+function calculateDistanceToImage(
+  worldPos: Types.Point3,
+  ImagePositionPatient: Types.Point3,
+  viewPlaneNormal: Types.Point3
+): number {
+  const dir = vec3.create();
+  vec3.sub(dir, worldPos, ImagePositionPatient);
+
+  const dot = vec3.dot(dir, viewPlaneNormal);
+
+  return Math.abs(dot);
+}
+export { annotationHydration };

package/src/utilities/index.ts

@@ -28,7 +28,7 @@ import { pointToString } from './pointToString';
 import annotationFrameRange from './annotationFrameRange';
 import pointInSurroundingSphereCallback from './pointInSurroundingSphereCallback';
 import getViewportForAnnotation from './getViewportForAnnotation';
-
+import { annotationHydration } from './annotationHydration';
 // name spaces
 import * as contours from './contours';
 import * as segmentation from './segmentation';
@@ -97,4 +97,5 @@ export {
   voi,
   annotationFrameRange,
   contourSegmentation,
+  annotationHydration,
 };