DCMTK
Version 3.6.1 20170228
OFFIS DICOM Toolkit
|
an overlay contained in a presentation state (internal use only). More...
Public Member Functions | |
DVPSOverlay () | |
default constructor | |
DVPSOverlay (const DVPSOverlay ©) | |
copy constructor | |
DVPSOverlay * | clone () const |
clone method. More... | |
virtual | ~DVPSOverlay () |
destructor | |
OFCondition | read (DcmItem &dset, Uint8 ovGroup, Uint8 asGroup=0xFF) |
reads the specified overlay group from a DICOM dataset. More... | |
OFCondition | write (DcmItem &dset) |
writes the overlay plane managed by this object to a DICOM dataset. More... | |
Uint8 | getOverlayGroup () const |
get group number of overlay repeating group managed by this object. More... | |
void | setOverlayGroup (Uint8 newGroup) |
sets the group number for the overlay repeating group managed by this object. More... | |
OFBool | isSuitableAsShutter (unsigned long x, unsigned long y) |
checks if the overlay is suitable as a bitmap shutter for an image with the given image size. More... | |
const char * | getOverlayLabel () |
gets the overlay label if present. More... | |
const char * | getOverlayDescription () |
gets the overlay description if present. More... | |
OFBool | isROI () |
checks whether this overlay is ROI type. More... | |
OFCondition | getValues (Sint16 &originX, Sint16 &originY, Uint16 &sizeX, Uint16 &sizeY) |
retrieve origin and size values for this overlay More... | |
DcmOverlayData & | getData () |
return reference to overlay data | |
DcmLongString & | getLabel () |
return reference to overlay label | |
DcmLongString & | getDescription () |
return reference to overlay description | |
Private Member Functions | |
DVPSOverlay & | operator= (const DVPSOverlay &) |
private undefined assignment operator | |
Private Attributes | |
Uint8 | overlayGroup |
lower byte of the overlay repeating group managed by this object | |
DcmUnsignedShort | overlayRows |
VR=US, VM=1, Type=1. | |
DcmUnsignedShort | overlayColumns |
VR=US, VM=1, Type=1. | |
DcmCodeString | overlayType |
VR=CS, VM=1, Type=1. | |
DcmSignedShort | overlayOrigin |
VR=SS, VM=2, Type=1. | |
DcmUnsignedShort | overlayBitsAllocated |
VR=US, VM=1, Type=1. | |
DcmUnsignedShort | overlayBitPosition |
VR=US, VM=1, Type=1. | |
DcmOverlayData | overlayData |
VR=OW, VM=1, Type=1C. | |
DcmLongString | overlayDescription |
VR=LO, VM=1, Type=3. | |
DcmLongString | overlayLabel |
VR=LO, VM=1, Type=3. | |
an overlay contained in a presentation state (internal use only).
This class manages the data structures comprising a single overlay (one instance of the Overlay Plane Module repeating elements) that is contained in a Presentation State object.
|
inline |
clone method.
const char* DVPSOverlay::getOverlayDescription | ( | ) |
gets the overlay description if present.
If the label string is absent, this method returns NULL.
|
inline |
get group number of overlay repeating group managed by this object.
const char* DVPSOverlay::getOverlayLabel | ( | ) |
gets the overlay label if present.
If the label string is absent, this method returns NULL.
OFCondition DVPSOverlay::getValues | ( | Sint16 & | originX, |
Sint16 & | originY, | ||
Uint16 & | sizeX, | ||
Uint16 & | sizeY | ||
) |
retrieve origin and size values for this overlay
originX | horizontal origin returned in this parameter |
originY | vertical origin returned in this parameter |
sizeX | horizontal size returned in this parameter |
sizeY | vertical size returned in this parameter |
OFBool DVPSOverlay::isROI | ( | ) |
checks whether this overlay is ROI type.
OFBool DVPSOverlay::isSuitableAsShutter | ( | unsigned long | x, |
unsigned long | y | ||
) |
checks if the overlay is suitable as a bitmap shutter for an image with the given image size.
Checks overlay type, origin and size.
x | image width in pixels |
y | image height in pixels |
OFCondition DVPSOverlay::read | ( | DcmItem & | dset, |
Uint8 | ovGroup, | ||
Uint8 | asGroup = 0xFF |
||
) |
reads the specified overlay group from a DICOM dataset.
The DICOM elements of the Overlay Plane module are copied from the dataset to this object. The OverlayData element, which is optional in the Overlay Plane Module but required for presentation states, must be present. The completeness of the overlay plane (presence of all required elements, value multiplicity) is checked. If this method returns an error code, the object is in undefined state afterwards.
dset | the DICOM dataset from which the overlay is to be read |
ovGroup | the lower byte of the overlay group to be read |
asGroup | the lower byte of the overlay group to be assigned to the overlay plane in the presentation state. Default: identical to ovGroup. |
|
inline |
sets the group number for the overlay repeating group managed by this object.
newGroup | lower byte of the repeating group number. |
OFCondition DVPSOverlay::write | ( | DcmItem & | dset | ) |
writes the overlay plane managed by this object to a DICOM dataset.
Copies of the DICOM element managed by this object are inserted into the DICOM dataset.
dset | the DICOM dataset to which the overlay is written |