string;
+ formatDate: (val) => string;
+ formatTime: (val) => string;
+ formatNumberPrecision: (val, number) => string;
+ };
+
+ // calculated values
+ voi: {
+ windowWidth: number;
+ windowCenter: number;
+ };
+ instanceNumber?: number;
+ scale?: number;
+}
+
+/**
+ * Window Level / Center Overlay item
+ */
+function VOIOverlayItem({ voi, customization }: OverlayItemProps) {
+ const { windowWidth, windowCenter } = voi;
+ if (typeof windowCenter !== 'number' || typeof windowWidth !== 'number') {
+ return null;
+ }
+
+ return (
+
+ W:
+
+ {windowWidth.toFixed(0)}
+
+ L:
+
+ {windowCenter.toFixed(0)}
+
+
+ );
+}
+
+/**
+ * Zoom Level Overlay item
+ */
+function ZoomOverlayItem({ scale, customization }: OverlayItemProps) {
+ return (
+
+ Zoom:
+ {scale.toFixed(2)}x
+
+ );
+}
+
+/**
+ * Instance Number Overlay Item
+ */
+function InstanceNumberOverlayItem({
+ instanceNumber,
+ imageSliceData,
+ customization,
+}: OverlayItemProps) {
+ const { imageIndex, numberOfSlices } = imageSliceData;
+
+ return (
+
+ I:
+
+ {instanceNumber !== undefined && instanceNumber !== null
+ ? `${instanceNumber} (${imageIndex + 1}/${numberOfSlices})`
+ : `${imageIndex + 1}/${numberOfSlices}`}
+
+
+ );
+}
+
+/**
+ * Customizable Viewport Overlay
+ */
+function CustomizableViewportOverlay({
+ element,
+ viewportData,
+ imageSliceData,
+ viewportIndex,
+ servicesManager,
+}) {
+ const { toolbarService, cornerstoneViewportService, customizationService } =
+ servicesManager.services;
+ const [voi, setVOI] = useState({ windowCenter: null, windowWidth: null });
+ const [scale, setScale] = useState(1);
+ const [activeTools, setActiveTools] = useState([]);
+ const { imageIndex } = imageSliceData;
+
+ const topLeftCustomization = customizationService.getModeCustomization(
+ 'cornerstoneOverlayTopLeft'
+ );
+ const topRightCustomization = customizationService.getModeCustomization(
+ 'cornerstoneOverlayTopRight'
+ );
+ const bottomLeftCustomization = customizationService.getModeCustomization(
+ 'cornerstoneOverlayBottomLeft'
+ );
+ const bottomRightCustomization = customizationService.getModeCustomization(
+ 'cornerstoneOverlayBottomRight'
+ );
+
+ const instance = useMemo(() => {
+ if (viewportData != null) {
+ return _getViewportInstance(viewportData, imageIndex);
+ } else {
+ return null;
+ }
+ }, [viewportData, imageIndex]);
+
+ const instanceNumber = useMemo(() => {
+ if (viewportData != null) {
+ return _getInstanceNumber(
+ viewportData,
+ viewportIndex,
+ imageIndex,
+ cornerstoneViewportService
+ );
+ }
+ return null;
+ }, [viewportData, viewportIndex, imageIndex, cornerstoneViewportService]);
+
+ /**
+ * Initial toolbar state
+ */
+ useEffect(() => {
+ setActiveTools(toolbarService.getActiveTools());
+ }, []);
+
+ /**
+ * Updating the VOI when the viewport changes its voi
+ */
+ useEffect(() => {
+ const updateVOI = eventDetail => {
+ const { range } = eventDetail.detail;
+
+ if (!range) {
+ return;
+ }
+
+ const { lower, upper } = range;
+ const { windowWidth, windowCenter } = utilities.windowLevel.toWindowLevel(
+ lower,
+ upper
+ );
+
+ setVOI({ windowCenter, windowWidth });
+ };
+
+ element.addEventListener(Enums.Events.VOI_MODIFIED, updateVOI);
+
+ return () => {
+ element.removeEventListener(Enums.Events.VOI_MODIFIED, updateVOI);
+ };
+ }, [viewportIndex, viewportData, voi, element]);
+
+ /**
+ * Updating the scale when the viewport changes its zoom
+ */
+ useEffect(() => {
+ const updateScale = eventDetail => {
+ const { previousCamera, camera } = eventDetail.detail;
+
+ if (
+ previousCamera.parallelScale !== camera.parallelScale ||
+ previousCamera.scale !== camera.scale
+ ) {
+ const viewport =
+ cornerstoneViewportService.getCornerstoneViewportByIndex(
+ viewportIndex
+ );
+
+ if (!viewport) {
+ return;
+ }
+
+ const imageData = viewport.getImageData();
+
+ if (!imageData) {
+ return;
+ }
+
+ if (camera.scale) {
+ setScale(camera.scale);
+ return;
+ }
+
+ const { spacing } = imageData;
+ // convert parallel scale to scale
+ const scale =
+ (element.clientHeight * spacing[0] * 0.5) / camera.parallelScale;
+ setScale(scale);
+ }
+ };
+
+ element.addEventListener(Enums.Events.CAMERA_MODIFIED, updateScale);
+
+ return () => {
+ element.removeEventListener(Enums.Events.CAMERA_MODIFIED, updateScale);
+ };
+ }, [viewportIndex, viewportData, cornerstoneViewportService, element]);
+
+ /**
+ * Updating the active tools when the toolbar changes
+ */
+ // Todo: this should act on the toolGroups instead of the toolbar state
+ useEffect(() => {
+ const { unsubscribe } = toolbarService.subscribe(
+ toolbarService.EVENTS.TOOL_BAR_STATE_MODIFIED,
+ () => {
+ setActiveTools(toolbarService.getActiveTools());
+ }
+ );
+
+ return () => {
+ unsubscribe();
+ };
+ }, [toolbarService]);
+
+ const _renderOverlayItem = useCallback(
+ item => {
+ const overlayItemProps: OverlayItemProps = {
+ element,
+ viewportData,
+ imageSliceData,
+ viewportIndex,
+ servicesManager,
+ customization: item,
+ formatters: {
+ formatPN: formatPN,
+ formatDate: formatDICOMDate,
+ formatTime: formatDICOMTime,
+ formatNumberPrecision: formatNumberPrecision,
+ },
+ instance,
+ // calculated
+ voi,
+ scale,
+ instanceNumber,
+ };
+
+ if (item.customizationType === 'ohif.overlayItem.windowLevel') {
+ return ;
+ } else if (item.customizationType === 'ohif.overlayItem.zoomLevel') {
+ return ;
+ } else if (item.customizationType === 'ohif.overlayItem.instanceNumber') {
+ return ;
+ } else {
+ const renderItem = customizationService.applyType(item);
+
+ if (typeof renderItem.content === 'function') {
+ return renderItem.content(overlayItemProps);
+ }
+ }
+ },
+ [
+ element,
+ viewportData,
+ imageSliceData,
+ viewportIndex,
+ servicesManager,
+ customizationService,
+ instance,
+ voi,
+ scale,
+ instanceNumber,
+ ]
+ );
+
+ const getTopLeftContent = useCallback(() => {
+ const items = topLeftCustomization?.items || [
+ {
+ id: 'WindowLevel',
+ customizationType: 'ohif.overlayItem.windowLevel',
+ },
+ ];
+ return (
+ <>
+ {items.map((item, i) => (
+ {_renderOverlayItem(item)}
+ ))}
+
+ );
+ }, [topLeftCustomization, _renderOverlayItem]);
+
+ const getTopRightContent = useCallback(() => {
+ const items = topRightCustomization?.items || [
+ {
+ id: 'InstanceNmber',
+ customizationType: 'ohif.overlayItem.instanceNumber',
+ },
+ ];
+ return (
+ <>
+ {items.map((item, i) => (
+ {_renderOverlayItem(item)}
+ ))}
+
+ );
+ }, [topRightCustomization, _renderOverlayItem]);
+
+ const getBottomLeftContent = useCallback(() => {
+ const items = bottomLeftCustomization?.items || [];
+ return (
+ <>
+ {items.map((item, i) => (
+
+ {_renderOverlayItem(item)}
+
+ ))}
+
+ );
+ }, [bottomLeftCustomization, _renderOverlayItem]);
+
+ const getBottomRightContent = useCallback(() => {
+ const items = bottomRightCustomization?.items || [];
+ return (
+ <>
+ {items.map((item, i) => (
+
+ {_renderOverlayItem(item)}
+
+ ))}
+
+ );
+ }, [bottomRightCustomization, _renderOverlayItem]);
+
+ return (
+
+ );
+}
+
+function _getViewportInstance(viewportData, imageIndex) {
+ let imageId = null;
+ if (viewportData.viewportType === Enums.ViewportType.STACK) {
+ imageId = viewportData.data.imageIds[imageIndex];
+ } else if (viewportData.viewportType === Enums.ViewportType.ORTHOGRAPHIC) {
+ const volumes = viewportData.volumes;
+ if (volumes && volumes.length == 1) {
+ const volume = volumes[0];
+ imageId = volume.imageIds[imageIndex];
+ }
+ }
+ return imageId ? metaData.get('instance', imageId) || {} : {};
+}
+
+function _getInstanceNumber(
+ viewportData,
+ viewportIndex,
+ imageIndex,
+ cornerstoneViewportService
+) {
+ let instanceNumber;
+
+ if (viewportData.viewportType === Enums.ViewportType.STACK) {
+ instanceNumber = _getInstanceNumberFromStack(viewportData, imageIndex);
+
+ if (!instanceNumber && instanceNumber !== 0) {
+ return null;
+ }
+ } else if (viewportData.viewportType === Enums.ViewportType.ORTHOGRAPHIC) {
+ instanceNumber = _getInstanceNumberFromVolume(
+ viewportData,
+ imageIndex,
+ viewportIndex,
+ cornerstoneViewportService
+ );
+ }
+ return instanceNumber;
+}
+
+function _getInstanceNumberFromStack(viewportData, imageIndex) {
+ const imageIds = viewportData.data.imageIds;
+ const imageId = imageIds[imageIndex];
+
+ if (!imageId) {
+ return;
+ }
+
+ const generalImageModule = metaData.get('generalImageModule', imageId) || {};
+ const { instanceNumber } = generalImageModule;
+
+ const stackSize = imageIds.length;
+
+ if (stackSize <= 1) {
+ return;
+ }
+
+ return parseInt(instanceNumber);
+}
+
+// Since volume viewports can be in any view direction, they can render
+// a reconstructed image which don't have imageIds; therefore, no instance and instanceNumber
+// Here we check if viewport is in the acquisition direction and if so, we get the instanceNumber
+function _getInstanceNumberFromVolume(
+ viewportData,
+ imageIndex,
+ viewportIndex,
+ cornerstoneViewportService
+) {
+ const volumes = viewportData.volumes;
+
+ // Todo: support fusion of acquisition plane which has instanceNumber
+ if (!volumes || volumes.length > 1) {
+ return;
+ }
+
+ const volume = volumes[0];
+ const { direction, imageIds } = volume;
+
+ const cornerstoneViewport =
+ cornerstoneViewportService.getCornerstoneViewportByIndex(viewportIndex);
+
+ if (!cornerstoneViewport) {
+ return;
+ }
+
+ const camera = cornerstoneViewport.getCamera();
+ const { viewPlaneNormal } = camera;
+ // checking if camera is looking at the acquisition plane (defined by the direction on the volume)
+
+ const scanAxisNormal = direction.slice(6, 9);
+
+ // check if viewPlaneNormal is parallel to scanAxisNormal
+ const cross = vec3.cross(vec3.create(), viewPlaneNormal, scanAxisNormal);
+ const isAcquisitionPlane = vec3.length(cross) < EPSILON;
+
+ if (isAcquisitionPlane) {
+ const imageId = imageIds[imageIndex];
+
+ if (!imageId) {
+ return {};
+ }
+
+ const { instanceNumber } =
+ metaData.get('generalImageModule', imageId) || {};
+ return parseInt(instanceNumber);
+ }
+}
+
+CustomizableViewportOverlay.propTypes = {
+ viewportData: PropTypes.object,
+ imageIndex: PropTypes.number,
+ viewportIndex: PropTypes.number,
+};
+
+export default CustomizableViewportOverlay;
diff --git a/extensions/cornerstone/src/Viewport/Overlays/utils.ts b/extensions/cornerstone/src/Viewport/Overlays/utils.ts
new file mode 100644
index 000000000..3e36429ba
--- /dev/null
+++ b/extensions/cornerstone/src/Viewport/Overlays/utils.ts
@@ -0,0 +1,98 @@
+import moment from 'moment';
+import { metaData } from '@cornerstonejs/core';
+
+/**
+ * Checks if value is valid.
+ *
+ * @param {number} value
+ * @returns {boolean} is valid.
+ */
+export function isValidNumber(value) {
+ return typeof value === 'number' && !isNaN(value);
+}
+
+/**
+ * Formats number precision.
+ *
+ * @param {number} number
+ * @param {number} precision
+ * @returns {number} formatted number.
+ */
+export function formatNumberPrecision(number, precision = 0) {
+ if (number !== null) {
+ return parseFloat(number).toFixed(precision);
+ }
+}
+
+/**
+ * Formats DICOM date.
+ *
+ * @param {string} date
+ * @param {string} strFormat
+ * @returns {string} formatted date.
+ */
+export function formatDICOMDate(date, strFormat = 'MMM D, YYYY') {
+ return moment(date, 'YYYYMMDD').format(strFormat);
+}
+
+/**
+ * DICOM Time is stored as HHmmss.SSS, where:
+ * HH 24 hour time:
+ * m mm 0..59 Minutes
+ * s ss 0..59 Seconds
+ * S SS SSS 0..999 Fractional seconds
+ *
+ * Goal: '24:12:12'
+ *
+ * @param {*} time
+ * @param {string} strFormat
+ * @returns {string} formatted name.
+ */
+export function formatDICOMTime(time, strFormat = 'HH:mm:ss') {
+ return moment(time, 'HH:mm:ss').format(strFormat);
+}
+
+/**
+ * Formats a patient name for display purposes
+ *
+ * @param {string} name
+ * @returns {string} formatted name.
+ */
+export function formatPN(name) {
+ if (!name) {
+ return '';
+ }
+
+ const cleaned = name
+ .split('^')
+ .filter(s => !!s)
+ .join(', ')
+ .trim();
+ return cleaned === ',' || cleaned === '' ? '' : cleaned;
+}
+
+/**
+ * Gets compression type
+ *
+ * @param {number} imageId
+ * @returns {string} comrpession type.
+ */
+export function getCompression(imageId) {
+ const generalImageModule = metaData.get('generalImageModule', imageId) || {};
+ const {
+ lossyImageCompression,
+ lossyImageCompressionRatio,
+ lossyImageCompressionMethod,
+ } = generalImageModule;
+
+ if (lossyImageCompression === '01' && lossyImageCompressionRatio !== '') {
+ const compressionMethod = lossyImageCompressionMethod || 'Lossy: ';
+ const compressionRatio = formatNumberPrecision(
+ lossyImageCompressionRatio,
+ 2
+ );
+ return compressionMethod + compressionRatio + ' : 1';
+ }
+
+ return 'Lossless / Uncompressed';
+}
diff --git a/extensions/default/src/commandsModule.js b/extensions/default/src/commandsModule.js
index ba4e89de9..a39b78670 100644
--- a/extensions/default/src/commandsModule.js
+++ b/extensions/default/src/commandsModule.js
@@ -47,6 +47,18 @@ const commandsModule = ({ servicesManager, commandsManager }) => {
title: 'DICOM Tag Browser',
});
},
+
+ /**
+ * Toggle viewport overlay (the information panel shown on the four corners
+ * of the viewport)
+ * @see ViewportOverlay and CustomizableViewportOverlay components
+ */
+ toggleOverlays: () => {
+ const overlays = document.getElementsByClassName('viewport-overlay');
+ for (let i = 0; i < overlays.length; i++) {
+ overlays.item(i).classList.toggle('hidden');
+ }
+ },
};
const definitions = {
diff --git a/extensions/default/src/getCustomizationModule.tsx b/extensions/default/src/getCustomizationModule.tsx
index 3ffd78a3e..47d5d1718 100644
--- a/extensions/default/src/getCustomizationModule.tsx
+++ b/extensions/default/src/getCustomizationModule.tsx
@@ -40,5 +40,76 @@ export default function getCustomizationModule() {
],
},
},
+
+ {
+ name: 'default',
+ value: [
+ /**
+ * Customization Component Type definition for overlay items.
+ * Overlay items are texts (or other components) that will be displayed
+ * on a Viewport Overlay, which contains the information panels on the
+ * four corners of a viewport.
+ *
+ * @definition of a overlay item using this type
+ * The value to be displayed is defined by
+ * - setting DICOM image instance's property to this field,
+ * - or defining contentF()
+ *
+ * {
+ * id: string - unique id for the overlay item
+ * customizationType: string - indicates customization type definition to this
+ * label: string - Label, to be displayed for the item
+ * title: string - Tooltip, for the item
+ * color: string - Color of the text
+ * condition: ({ instance }) => boolean - decides whether to display the overlay item or not
+ * attribute: string - property name of the DICOM image instance
+ * contentF: ({ instance, formatters }) => string | component,
+ * }
+ *
+ * @example
+ * {
+ * id: 'PatientNameOverlay',
+ * customizationType: 'ohif.overlayItem',
+ * label: 'PN:',
+ * title: 'Patient Name',
+ * color: 'yellow',
+ * condition: ({ instance }) => instance && instance.PatientName && instance.PatientName.Alphabetic,
+ * attribute: 'PatientName',
+ * contentF: ({ instance, formatters: { formatPN } }) => `${formatPN(instance.PatientName.Alphabetic)} ${(instance.PatientSex ? '(' + instance.PatientSex + ')' : '')}`,
+ * },
+ *
+ * @see CustomizableViewportOverlay
+ */
+ {
+ id: 'ohif.overlayItem',
+ uiType: 'uiType',
+ content: function (props) {
+ if (this.condition && !this.condition(props)) return null;
+
+ const { instance } = props;
+ const value =
+ instance && this.attribute
+ ? instance[this.attribute]
+ : this.contentF && typeof this.contentF === 'function'
+ ? this.contentF(props)
+ : null;
+ if (!value) return null;
+
+ return (
+
+ {this.label && (
+ {this.label}
+ )}
+ {value}
+
+ );
+ },
+ },
+ ],
+ },
];
}
diff --git a/platform/core/src/services/CustomizationService/CustomizationService.ts b/platform/core/src/services/CustomizationService/CustomizationService.ts
index 25a3dd3be..e3574f643 100644
--- a/platform/core/src/services/CustomizationService/CustomizationService.ts
+++ b/platform/core/src/services/CustomizationService/CustomizationService.ts
@@ -161,6 +161,13 @@ export default class CustomizationService extends PubSubService {
return this.applyType(customization);
}
+ public hasModeCustomization(customizationId: string) {
+ return (
+ this.globalCustomizations[customizationId] ||
+ this.modeCustomizations[customizationId]
+ );
+ }
+
/** Applies any inheritance due to UI Type customization */
public applyType(customization: Customization): Customization {
if (!customization) return customization;
diff --git a/platform/docs/docs/assets/img/customizable-overlay.png b/platform/docs/docs/assets/img/customizable-overlay.png
new file mode 100644
index 0000000000000000000000000000000000000000..05ca4d275be569180f6065896ed5c265082c6657
GIT binary patch
literal 1086983
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