@cornerstonejs/core 2.0.0-beta.8 → 2.0.0

package/src/types/IContourSet.ts

@@ -1,59 +0,0 @@
-import vtkPolyData from '@kitware/vtk.js/Common/DataModel/PolyData';
-import { ContourData, IContour, Point3 } from './';
-
-/**
- * This class represents a set of contours in 3d space.
- * Usually contours are grouped together in a contour set to represent a meaningful shape.
- */
-export interface IContourSet {
-  readonly id: string;
-  readonly sizeInBytes: number;
-  readonly frameOfReferenceUID: string;
-  contours: IContour[];
-  _createEachContour(data: ContourData[]): void;
-  getSizeInBytes(): number;
-  getSegmentIndex(): number;
-  getCentroid(): Point3;
-  getColor(): any;
-  /**
-   * This function returns the contours of the image
-   * @returns The contours of the image.
-   */
-  getContours(): IContour[];
-  /**
-   * It returns an array of all the points in the glyph
-   * @returns An array of points.
-   */
-  getFlatPointsArray(): Point3[];
-  /**
-   * This function returns the number of contours in the current shape.
-   * @returns The number of contours in the glyph.
-   */
-  getNumberOfContours(): number;
-  /**
-   * It loops through each contour in the `contours` array, and adds the number of
-   * points in each contour to the `numberOfPoints` variable
-   * @returns The number of points in the contours.
-   */
-  getTotalNumberOfPoints(): number;
-  /**
-   * It returns an array of the number of points in each contour.
-   * @returns An array of numbers.
-   */
-  getNumberOfPointsArray(): number[];
-  /**
-   * It returns the points in a contour.
-   * @param contourIndex - The index of the contour you want to get the
-   * points from.
-   * @returns An array of Point3 objects.
-   */
-  getPointsInContour(contourIndex: number): Point3[];
-  /**
-   * "This function returns the number of points in a contour."
-   *
-   * @param contourIndex - The index of the contour you want to get the
-   * number of points from.
-   * @returns The number of points in the contour.
-   */
-  getNumberOfPointsInAContour(contourIndex: number): number;
-}

package/src/types/IDynamicImageVolume.ts

@@ -1,18 +0,0 @@
-import { IImageVolume, PixelDataTypedArray } from '../types';
-
-/**
- * Cornerstone ImageVolume interface. Todo: we should define new IVolume class
- * with appropriate typings for the other types of volume that don't have images (nrrd, nifti)
- */
-interface IDynamicImageVolume extends IImageVolume {
-  /** Returns the active time point index */
-  get timePointIndex(): number;
-  /** Set the active time point index which also updates the active scalar data */
-  set timePointIndex(newTimePointIndex: number);
-  /** Returns the number of time points */
-  get numTimePoints(): number;
-  /** return scalar data arrays (one per timepoint) */
-  getScalarDataArrays(): PixelDataTypedArray[];
-}
-
-export default IDynamicImageVolume;

package/src/types/IEnabledElement.ts

@@ -1,24 +0,0 @@
-import type { IRenderingEngine } from '../types';
-import type IStackViewport from './IStackViewport';
-import type IVolumeViewport from './IVolumeViewport';
-
-/**
- * Cornerstone Enabled Element interface
- */
-interface IEnabledElement {
-  /** Cornerstone Viewport instance - can be Stack or Volume, or Video Viewport as of now.
-   * For the moment, need to cast to unknown first before casting to IVideoViewport
-   * (TODO) - this will be done as part of adding annotation tools for video
-   */
-  viewport: IStackViewport | IVolumeViewport;
-  /** Cornerstone Rendering Engine instance */
-  renderingEngine: IRenderingEngine;
-  /** Unique ID of the viewport in the renderingEngine */
-  viewportId: string;
-  /** Unique ID of the renderingEngine */
-  renderingEngineId: string;
-  /** FrameOfReference the enabledElement is rendering inside */
-  FrameOfReferenceUID: string;
-}
-
-export default IEnabledElement;

package/src/types/IGeometry.ts

@@ -1,13 +0,0 @@
-import { GeometryType } from '../enums';
-import { IContourSet } from './IContourSet';
-import { ISurface } from './ISurface';
-
-// interface IGeometry can be array of IContourSet
-interface IGeometry {
-  id: string;
-  type: GeometryType;
-  data: IContourSet | ISurface;
-  sizeInBytes: number;
-}
-
-export default IGeometry;

package/src/types/IImage.ts

@@ -1,136 +0,0 @@
-import type CPUFallbackLUT from './CPUFallbackLUT';
-import type CPUFallbackColormap from './CPUFallbackColormap';
-import type CPUFallbackEnabledElement from './CPUFallbackEnabledElement';
-import type { PixelDataTypedArray } from './PixelDataTypedArray';
-import type VoxelManager from '../utilities/VoxelManager';
-import { ImageQualityStatus } from '../enums';
-import IImageCalibration from './IImageCalibration';
-import RGB from './RGB';
-
-/**
- * Cornerstone Image interface, it is used for both CPU and GPU rendering
- */
-interface IImage {
-  /** Image Id */
-  imageId: string;
-  /** referenced imageId if this image is derived from */
-  referencedImageId?: string;
-  sharedCacheKey?: string;
-  /** Whether the image is Pre-scaled during loading */
-  isPreScaled?: boolean;
-  /** preScale object */
-  preScale?: {
-    enabled: boolean;
-    /** boolean flag to indicate whether the image has been scaled */
-    scaled?: boolean;
-    /** scaling parameters */
-    scalingParameters?: {
-      /** modality of the image */
-      modality?: string;
-      /** rescale slop */
-      rescaleSlope?: number;
-      /** rescale intercept */
-      rescaleIntercept?: number;
-      /** PT suvbw */
-      suvbw?: number;
-    };
-  };
-  /** minimum pixel value of the image */
-  minPixelValue: number;
-  /* maximum pixel value of the image */
-  maxPixelValue: number;
-  /** slope from metadata for scaling */
-  slope: number;
-  /** intercept from metadata for scaling */
-  intercept: number;
-  /** windowCenter from metadata */
-  windowCenter: number[] | number;
-  /** windowWidth from metadata */
-  windowWidth: number[] | number;
-  /** voiLUTFunction from metadata */
-  voiLUTFunction: string;
-  /** function that returns the pixelData as an array */
-  getPixelData: () => PixelDataTypedArray;
-  getCanvas: () => HTMLCanvasElement;
-  /** image number of rows */
-  rows: number;
-  /** image number of columns */
-  columns: number;
-  /** image height */
-  height: number;
-  /** image width */
-  width: number;
-  /** is image a color image */
-  color: boolean;
-  /** is image rgb and alpha */
-  rgba: boolean;
-  /** number of components in the image */
-  numComps: number;
-  /** CPU: custom render method for the image */
-  render?: (
-    enabledElement: CPUFallbackEnabledElement,
-    invalidated: boolean
-  ) => unknown;
-  /** column pixel spacing */
-  columnPixelSpacing: number;
-  /** row pixel spacing */
-  rowPixelSpacing: number;
-  /** slice thickness */
-  sliceThickness?: number;
-  /** whether image pixels are inverted in color */
-  invert: boolean;
-  /** image photometric interpretation */
-  photometricInterpretation?: string;
-  /** image size in number of bytes */
-  sizeInBytes: number;
-  /** CPU: custom modality LUT for image  */
-  modalityLUT?: CPUFallbackLUT;
-  /** CPU: custom VOI LUT for image  */
-  voiLUT?: CPUFallbackLUT;
-  /** CPU: custom color map for image  */
-  colormap?: CPUFallbackColormap;
-  /** image scaling metadata - including PT suv values */
-  scaling?: {
-    PT?: {
-      // @TODO: Do these values exist?
-      SUVlbmFactor?: number;
-      SUVbsaFactor?: number;
-      // accessed in ProbeTool
-      suvbwToSuvlbm?: number;
-      suvbwToSuvbsa?: number;
-    };
-  };
-  loadTimeInMS?: number;
-  decodeTimeInMS?: number;
-  /** CPU: image statistics for rendering */
-  stats?: {
-    lastStoredPixelDataToCanvasImageDataTime?: number;
-    lastGetPixelDataTime?: number;
-    lastPutImageDataTime?: number;
-    lastLutGenerateTime?: number;
-    lastRenderedViewport?: unknown;
-    lastRenderTime?: number;
-  };
-  /** CPU: image cached LUT */
-  cachedLut?: {
-    windowWidth?: number | number[];
-    windowCenter?: number | number[];
-    invert?: boolean;
-    lutArray?: Uint8ClampedArray;
-    modalityLUT?: unknown;
-    voiLUT?: CPUFallbackLUT;
-  };
-
-  imageQualityStatus?: ImageQualityStatus;
-  calibration?: IImageCalibration;
-  imageFrame?: any;
-
-  voxelManager?: VoxelManager<number> | VoxelManager<RGB>;
-
-  bufferView?: {
-    buffer: ArrayBuffer;
-    offset: number;
-  };
-}
-
-export default IImage;

package/src/types/IImageCalibration.ts

@@ -1,41 +0,0 @@
-import CalibrationTypes from '../enums/CalibrationTypes';
-
-/**
- * IImageCalibration is an object that stores information about the type
- * of image calibration.
- */
-export interface IImageCalibration {
-  /**
-   * The pixel spacing for the image, in mm between pixel centers
-   * These are not required, and are deprecated in favour of getting the original
-   * image spacing and then applying the transforms.  The values here should
-   * be identical to original spacing.
-   */
-  rowPixelSpacing?: number;
-  columnPixelSpacing?: number;
-  /** The scaling of measurement values relative to the base pixel spacing (1 if not specified) */
-  scale?: number;
-  /**
-   * The calibration aspect ratio for non-square calibrations.
-   * This is the aspect ratio similar to the scale above that applies when
-   * the viewport is displaying non-square image pixels as square screen pixels.
-   *
-   * Defaults to 1 if not specified, and is also 1 if the Viewport has squared
-   * up the image pixels so that they are displayed as a square.
-   * Not well handled currently as this needs to be incorporated into
-   * tools when doing calculations.
-   */
-  aspect?: number;
-  /** The type of the pixel spacing, distinguishing between various
-   * types projection (CR/DX/MG) spacing and volumetric spacing (the type is
-   * an empty string as it doesn't get a suffix, but this distinguishes it
-   * from other types)
-   */
-  type: CalibrationTypes;
-  /** A tooltip which can be used to explain the calibration information */
-  tooltip?: string;
-  /** The DICOM defined ultrasound regions.  Used for non-distance spacing units. */
-  sequenceOfUltrasoundRegions?: Record<string, unknown>[];
-}
-
-export default IImageCalibration;

package/src/types/IImageData.ts

@@ -1,49 +0,0 @@
-import type { vtkImageData } from '@kitware/vtk.js/Common/DataModel/ImageData';
-import { Point3, Scaling, Mat3 } from '../types';
-import IImageCalibration from './IImageCalibration';
-
-/**
- * IImageData of an image, which stores actual scalarData and metaData about the image.
- * IImageData is different from vtkImageData.
- */
-interface IImageData {
-  /** image dimensions */
-  dimensions: Point3;
-  /** image direction */
-  direction: Mat3;
-  /** image spacing */
-  spacing: Point3;
-  /** image origin */
-  origin: Point3;
-  /** image scalarData which stores the array of pixelData */
-  scalarData: Float32Array | Uint16Array | Uint8Array | Int16Array;
-  /** vtkImageData object */
-  imageData: vtkImageData;
-  /** image metadata - currently only modality */
-  metadata: { Modality: string };
-  /** image scaling for scaling pixelArray */
-  scaling?: Scaling;
-  /** whether the image has pixel spacing and it is not undefined */
-  hasPixelSpacing?: boolean;
-
-  calibration?: IImageCalibration;
-
-  /** preScale object */
-  preScale?: {
-    /** boolean flag to indicate whether the image has been scaled */
-    scaled?: boolean;
-    /** scaling parameters */
-    scalingParameters?: {
-      /** modality of the image */
-      modality?: string;
-      /** rescale slop */
-      rescaleSlope?: number;
-      /** rescale intercept */
-      rescaleIntercept?: number;
-      /** PT suvbw */
-      suvbw?: number;
-    };
-  };
-}
-
-export default IImageData;

package/src/types/IImageVolume.ts

@@ -1,103 +0,0 @@
-import type { vtkImageData } from '@kitware/vtk.js/Common/DataModel/ImageData';
-import type { VoxelManager } from '../utilities';
-import {
-  Metadata,
-  PixelDataTypedArray,
-  Point3,
-  IImageLoadObject,
-  Mat3,
-  RGB,
-} from '../types';
-
-/**
- * Cornerstone ImageVolume interface. Todo: we should define new IVolume class
- * with appropriate typings for the other types of volume that don't have images (nrrd, nifti)
- */
-interface IImageVolume {
-  /** unique identifier of the volume in the cache */
-  readonly volumeId: string;
-  /** volume dimensions */
-  dimensions: Point3;
-  /** volume direction */
-  direction: Mat3;
-  /** volume metadata */
-  metadata: Metadata;
-  /** volume origin - set to the imagePositionPatient of the last image in the volume */
-  origin: Point3;
-  /** Whether preScaling has been performed on the volume */
-  isPreScaled: boolean;
-  /** volume scaling metadata */
-  scaling?: {
-    PT?: {
-      SUVlbmFactor?: number;
-      SUVbsaFactor?: number;
-      suvbwToSuvlbm?: number;
-      suvbwToSuvbsa?: number;
-    };
-  };
-  /** volume size in bytes */
-  sizeInBytes?: number;
-  /** volume spacing */
-  spacing: Point3;
-  /** number of voxels in the volume */
-  numVoxels: number;
-  /** volume image data as vtkImageData */
-  imageData?: vtkImageData;
-  /** openGL texture for the volume */
-  vtkOpenGLTexture: any;
-  /** loading status object for the volume containing loaded/loading statuses */
-  loadStatus?: Record<string, any>;
-  /** imageIds of the volume (if it is built of separate imageIds) */
-  imageIds: Array<string>;
-  /** volume referencedVolumeId (if it is derived from another volume) */
-  referencedVolumeId?: string; // if volume is derived from another volume
-  /** volume referencedImageIds (if it is derived from set of images in the image cache) */
-  referencedImageIds?: Array<string>;
-  /** whether the metadata for the pixel spacing is not undefined  */
-  hasPixelSpacing: boolean;
-  /** Property to store additional information */
-  additionalDetails?: Record<string, any>;
-  /** return true if it is a 4D volume or false if it is 3D volume */
-  isDynamicVolume(): boolean;
-  /** method to convert the volume data in the volume cache, to separate images in the image cache */
-  convertToCornerstoneImage?: (
-    imageId: string,
-    imageIdIndex: number
-  ) => IImageLoadObject;
-
-  //cancel load
-  cancelLoading?: () => void;
-
-  /** return the volume scalar data */
-  getScalarData(): PixelDataTypedArray;
-
-  /** A voxel manager to manage the scalar data */
-  voxelManager?: VoxelManager<number> | VoxelManager<RGB>;
-
-  convertToImageSlicesAndCache(): string[];
-
-  /** return the index of a given imageId */
-  getImageIdIndex(imageId: string): number;
-
-  /** return the index of a given imageURI */
-  getImageURIIndex(imageURI: string): number;
-
-  /** destroy the volume and make it unusable */
-  destroy(): void;
-
-  /** decache */
-  decache?: (completelyRemove?: boolean) => void;
-
-  /** */
-  get imageCacheOffsetMap(): Map<string, any>;
-
-  /**
-   * Mark the volume as having had the pixel data changed externally
-   * which in background will re-configure the volume to use the new
-   * pixel data.
-   *
-   */
-  modified(): void;
-}
-
-export default IImageVolume;

package/src/types/ILoadObject.ts

@@ -1,36 +0,0 @@
-import IGeometry from './IGeometry';
-import IImage from './IImage';
-import IImageVolume from './IImageVolume';
-
-/**
- * ImageLoadObject interface which any imageLoader should return
- */
-export interface IImageLoadObject {
-  /** promise that resolves to an image */
-  promise: Promise<IImage>;
-  /** optional cancel function for loading*/
-  cancelFn?: () => void;
-  /** optional decache function */
-  decache?: () => void;
-}
-
-/**
- * VolumeLoadObject interface which any volumeLoader should return
- */
-export interface IVolumeLoadObject {
-  /** promise that resolves to an ImageVolume */
-  promise: Promise<IImageVolume>;
-  /** optional cancel function for loading*/
-  cancelFn?: () => void;
-  /** optional decache function */
-  decache?: () => void;
-}
-
-export interface IGeometryLoadObject {
-  /** promise that resolves to an ImageVolume */
-  promise: Promise<IGeometry>;
-  /** optional cancel function for loading*/
-  cancelFn?: () => void;
-  /** optional decache function */
-  decache?: () => void;
-}

package/src/types/IRegisterImageLoader.ts

@@ -1,10 +0,0 @@
-import ImageLoaderFn from './ImageLoaderFn';
-
-/**
- * Register image loader interface
- */
-interface IRegisterImageLoader {
-  registerImageLoader: (scheme: string, imageLoader: ImageLoaderFn) => void;
-}
-
-export default IRegisterImageLoader;

package/src/types/IRenderingEngine.ts

@@ -1,31 +0,0 @@
-import IStackViewport from './IStackViewport';
-import { PublicViewportInput } from './IViewport';
-import IVolumeViewport from './IVolumeViewport';
-import { IViewport } from './IViewport';
-import IVideoViewport from './IVideoViewport';
-
-export default interface IRenderingEngine {
-  id: string;
-  hasBeenDestroyed: boolean;
-  offscreenMultiRenderWindow: any;
-  offScreenCanvasContainer: any;
-  setViewports(viewports: Array<PublicViewportInput>): void;
-  resize(immediate?: boolean, keepCamera?: boolean): void;
-  getViewport(id: string): IViewport;
-  getViewports(): Array<IViewport>;
-  render(): void;
-  renderViewports(viewportIds: Array<string>): void;
-  renderViewport(viewportId: string): void;
-  renderFrameOfReference(FrameOfReferenceUID: string): void;
-  fillCanvasWithBackgroundColor(
-    canvas: HTMLCanvasElement,
-    backgroundColor: [number, number, number]
-  ): void;
-  enableElement(viewportInputEntry: PublicViewportInput): void;
-  disableElement(viewportId: string): void;
-  getStackViewports(): Array<IStackViewport>;
-  getVolumeViewports(): Array<IVolumeViewport>;
-  getVideoViewports(): Array<IVideoViewport>;
-  destroy(): void;
-  _debugRender(): void;
-}