DCMTK Version 3.6.8
OFFIS DICOM Toolkit
|
Class that represents a reference to another DICOM objects. More...
Public Types | |
enum | MAX_LEVEL { LEVEL_INSTANCE , LEVEL_SERIES , LEVEL_STUDY , LEVEL_PATIENT } |
The maximum DICOM entity level that this reference refers to. More... | |
enum | TYPE { GENERIC , IMAGE , SEGMENT } |
Type of reference. More... | |
Public Member Functions | |
IODReference () | |
Constructor, creates empty reference, default level is "STUDY". | |
IODReference (const MAX_LEVEL level) | |
Constructor, creates empty reference with specified level. More... | |
virtual | ~IODReference () |
Destructor. | |
virtual IODReference * | clone () const |
Create (deep) clone copy of this reference. More... | |
virtual TYPE | getType () const |
Get type of reference. More... | |
virtual OFCondition | check () const |
Check whether this reference is valid, i.e. More... | |
virtual OFString | toString () const |
Returns reference as a one line string. More... | |
virtual OFBool | readFromFile (const OFString &filename) |
Initializes this reference from given file, i.e. More... | |
virtual OFBool | readFromItem (DcmItem &item) |
Initializes this reference from given item, i.e. More... | |
virtual void | clear () |
Clear all reference data. | |
Public Attributes | |
OFString | m_PatientID |
Patient ID. | |
OFString | m_StudyInstanceUID |
Study Instance UID. | |
OFString | m_SeriesInstanceUID |
Series Instance UID. | |
OFString | m_SOPClassUID |
SOP Class UID. | |
OFString | m_SOPInstanceUID |
SOP Instance UID. | |
MAX_LEVEL | m_Level |
Maximum level this reference refers to. More... | |
Class that represents a reference to another DICOM objects.
DICOM uses different types of references for different purposes: Sometimes only SOP Class UID and SOP Instance UID are required, sometimes also Series and Study Instance UIDs. Also, in different IOD modules and macros DICOM uses different attributes to store those references in objects. Sometimes the same references are even required in different structures within the same object. This class can carry identifiers for Patient, Study, Series and Instance level and can be passed around in order to write them as required into the attribute structures needed by a specific DIOCM IOD, module or macro.
enum IODReference::TYPE |
Type of reference.
Enumerator | |
---|---|
GENERIC | Generic (or unknown) |
IMAGE | Reference to an image object, see also class IODImageReference. |
SEGMENT | Reference to a segmentation object, see also class IDOSegmentationReference. |
IODReference::IODReference | ( | const MAX_LEVEL | level | ) |
Constructor, creates empty reference with specified level.
level | The reference level |
|
virtual |
Check whether this reference is valid, i.e.
complete related to its level. Also in case of UIDs it is checked whether they conform to the UI Value Representation definition.
|
virtual |
Create (deep) clone copy of this reference.
Reimplemented in IODImageReference, and IODSegmentationReference.
|
inlinevirtual |
Get type of reference.
Base class always returns "GENERIC"
Reimplemented in IODImageReference, and IODSegmentationReference.
|
virtual |
Initializes this reference from given file, i.e.
extracts all identifiers up to the level defined for this reference.
filename | The file to read from |
Reimplemented in IODImageReference, and IODSegmentationReference.
|
virtual |
Initializes this reference from given item, i.e.
extracts all identifiers up to the level defined for this reference.
item | The item to read from |
|
virtual |
Returns reference as a one line string.
Mostly useful for debugging.
MAX_LEVEL IODReference::m_Level |
Maximum level this reference refers to.
E.g. for level SERIES, only Series, SOP Instance and SOP Class UID must be provided. However,