Overlays Overview

An "Overlay Plane" describes graphics or bit-mapped text that is associated with an image or has its own existence within a series. It may also describe a ROI in an Image.

Each "Overlay Plane" is one bit deep (1BPP). Sixteen separate planes may be associated with an image or exist as "Standalone Overlays" in a series.

Overlay pixel data is stored either in "Overlay Data" (60xx, 3000) or embedded in the "Image Pixel Data" (7FE0, 0010).

LEADTOOLS offers a number of functions to manipulate overlays in DICOM datasets.

LDicomDS::GetOverlayCount can be used to find the number of overlays in the DICOM dataset. Call LDicomDS::GetOverlayAttributes to retrieve the attributes of an overlay and LDicomDS::GetOverlayBitmap to retrieve the "Overlay Data" (60xx,3000) for a single-frame overlay or LDicomDS::GetOverlayBitmapList for a multi-frame one. LDicomDS::GetOverlayActivationLayer lets you get the activation layer for the overlay.

LEADTOOLS also allows you to insert a new or update an existing overlay. Call LDicomDS::SetOverlayAttributes to set the attributes of a certain overlay and then call

LDicomDS::SetOverlayBitmap or LDicomDS::SetOverlayBitmapList to set its data.

To delete all the elements related to an overlay call LDicomDS::DeleteOverlay.