LEADTOOLS DICOM C++ Class Library Help > LEADTOOLS DICOM Features > DICOM Files > Overlays Overview > 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.