OFFIS DCMTK
Version 3.6.0
|
Class for SOP instance reference lists. More...
Classes | |
struct | InstanceStruct |
Internal structure defining the instance list items. More... | |
struct | SeriesStruct |
Internal structure defining the series list items. More... | |
struct | StudyStruct |
Internal structure defining the study list items. More... | |
Public Member Functions | |
DSRSOPInstanceReferenceList (const DcmTagKey &sequence) | |
constructor | |
~DSRSOPInstanceReferenceList () | |
destructor | |
void | clear () |
clear list of references | |
OFBool | empty () const |
check whether list of references is empty | |
size_t | getNumberOfInstances () const |
get number of instance stored in the list of references | |
OFCondition | read (DcmItem &dataset) |
read list of referenced SOP instances. | |
OFCondition | write (DcmItem &dataset) const |
write list of referenced SOP instances. | |
OFCondition | readXML (const DSRXMLDocument &doc, DSRXMLCursor cursor, const size_t flags) |
read list of references from XML document. | |
OFCondition | writeXML (STD_NAMESPACE ostream &stream, const size_t flags=0) const |
write current list of references in XML format | |
OFCondition | addItem (const OFString &studyUID, const OFString &seriesUID, const OFString &sopClassUID, const OFString &instanceUID) |
add the specified item to the list of references. | |
OFCondition | addItem (DcmItem &dataset) |
add item from specified DICOM dataset to the list of references. | |
OFCondition | removeItem () |
remove the current item from the list of referenced SOP instances. | |
OFCondition | removeItem (const OFString &sopClassUID, const OFString &instanceUID) |
remove the specified item from the list of references. | |
OFCondition | removeItem (const OFString &studyUID, const OFString &seriesUID, const OFString &instanceUID) |
remove the specified item from the list of references. | |
OFCondition | gotoItem (const OFString &sopClassUID, const OFString &instanceUID) |
select the specified item as the current one | |
OFCondition | gotoItem (const OFString &studyUID, const OFString &seriesUID, const OFString &instanceUID) |
select the specified item as the current one | |
OFCondition | gotoFirstItem () |
select the first item in the list. | |
OFCondition | gotoNextItem () |
select the next item in the list. | |
const OFString & | getStudyInstanceUID (OFString &stringValue) const |
get the study instance UID of the currently selected entry | |
const OFString & | getSeriesInstanceUID (OFString &stringValue) const |
get the series instance UID of the currently selected entry | |
const OFString & | getSOPInstanceUID (OFString &stringValue) const |
get the SOP instance UID of the currently selected entry | |
const OFString & | getSOPClassUID (OFString &stringValue) const |
get the SOP class UID of the currently selected entry | |
const OFString & | getRetrieveAETitle (OFString &stringValue) const |
get the retrieve application entity title of the currently selected entry (optional). | |
const OFString & | getStorageMediaFileSetID (OFString &stringValue) const |
get the storage media file set ID of the currently selected entry (optional) | |
const OFString & | getStorageMediaFileSetUID (OFString &stringValue) const |
get the storage media file set UID of the currently selected entry (optional) | |
OFCondition | setRetrieveAETitle (const OFString &value) |
set the retrieve application entity title of the currently selected entry. | |
OFCondition | setStorageMediaFileSetID (const OFString &value) |
set the storage media file set ID of the currently selected entry | |
OFCondition | setStorageMediaFileSetUID (const OFString &value) |
set the storage media file set UID of the currently selected entry | |
![]() | |
virtual | ~DSRTypes () |
destructor. | |
Protected Member Functions | |
StudyStruct * | gotoStudy (const OFString &studyUID) |
set cursor to the specified study entry (if existent) | |
StudyStruct * | getCurrentStudy () const |
get pointer to currently selected study structure (if any) | |
SeriesStruct * | getCurrentSeries () const |
get pointer to currently selected series structure (if any) | |
InstanceStruct * | getCurrentInstance () const |
get pointer to currently selected instance structure (if any) | |
void | removeIncompleteItems () |
remove empty/incomplete items from the list. | |
Private Member Functions | |
OFListIterator (StudyStruct *) Iterator | |
internal cursor to current (selected) list item | |
DSRSOPInstanceReferenceList (const DSRSOPInstanceReferenceList &) | |
DSRSOPInstanceReferenceList & | operator= (const DSRSOPInstanceReferenceList &) |
Private Attributes | |
const DcmTagKey | SequenceTag |
DICOM tag specifying the attribute (sequence) of the reference list. | |
OFList< StudyStruct * > | StudyList |
list of studies | |
Additional Inherited Members | |
![]() | |
enum | E_DocumentType { DT_invalid, DT_unknown = DT_invalid, DT_BasicTextSR, DT_EnhancedSR, DT_ComprehensiveSR, DT_KeyObjectSelectionDocument, DT_MammographyCadSR, DT_ChestCadSR, DT_ColonCadSR, DT_ProcedureLog, DT_XRayRadiationDoseSR, DT_SpectaclePrescriptionReport, DT_MacularGridThicknessAndVolumeReport, DT_ImplantationPlanSRDocument, DT_last = DT_ImplantationPlanSRDocument } |
SR document types. More... | |
enum | E_RelationshipType { RT_invalid, RT_unknown, RT_isRoot, RT_contains, RT_hasObsContext, RT_hasAcqContext, RT_hasConceptMod, RT_hasProperties, RT_inferredFrom, RT_selectedFrom, RT_last = RT_selectedFrom } |
SR relationship types. More... | |
enum | E_ValueType { VT_invalid, VT_Text, VT_Code, VT_Num, VT_DateTime, VT_Date, VT_Time, VT_UIDRef, VT_PName, VT_SCoord, VT_SCoord3D, VT_TCoord, VT_Composite, VT_Image, VT_Waveform, VT_Container, VT_byReference, VT_last = VT_byReference } |
SR value types. More... | |
enum | E_GraphicType { GT_invalid, GT_unknown = GT_invalid, GT_Point, GT_Multipoint, GT_Polyline, GT_Circle, GT_Ellipse, GT_last = GT_Ellipse } |
SR graphic types. More... | |
enum | E_GraphicType3D { GT3_invalid, GT3_unknown = GT3_invalid, GT3_Point, GT3_Multipoint, GT3_Polyline, GT3_Polygon, GT3_Ellipse, GT3_Ellipsoid, GT3_last = GT3_Ellipsoid } |
SR graphic types (3D). More... | |
enum | E_TemporalRangeType { TRT_invalid, TRT_unknown = TRT_invalid, TRT_Point, TRT_Multipoint, TRT_Segment, TRT_Multisegment, TRT_Begin, TRT_End, TRT_last = TRT_End } |
SR temporal range types. More... | |
enum | E_ContinuityOfContent { COC_invalid, COC_Separate, COC_Continuous, COC_last = COC_Continuous } |
SR continuity of content flag. More... | |
enum | E_PreliminaryFlag { PF_invalid, PF_Preliminary, PF_Final, PF_last = PF_Final } |
SR document preliminary flag. More... | |
enum | E_CompletionFlag { CF_invalid, CF_Partial, CF_Complete, CF_last = CF_Complete } |
SR document completion flag. More... | |
enum | E_VerificationFlag { VF_invalid, VF_Unverified, VF_Verified, VF_last = VF_Verified } |
SR document verification flag. More... | |
enum | E_CharacterSet { CS_invalid, CS_unknown = CS_invalid, CS_ASCII, CS_Latin1, CS_Latin2, CS_Latin3, CS_Latin4, CS_Cyrillic, CS_Arabic, CS_Greek, CS_Hebrew, CS_Latin5, CS_Japanese, CS_Thai, CS_UTF8, CS_last = CS_UTF8 } |
Specific character set. More... | |
enum | E_AddMode { AM_afterCurrent, AM_beforeCurrent, AM_belowCurrent } |
Add node mode. More... | |
![]() | |
static const char * | documentTypeToSOPClassUID (const E_DocumentType documentType) |
convert SR document type to SOP class UID | |
static const char * | documentTypeToModality (const E_DocumentType documentType) |
convert SR document type to modality | |
static const char * | documentTypeToReadableName (const E_DocumentType documentType) |
convert SR document type to readable name. | |
static const char * | documentTypeToDocumentTitle (const E_DocumentType documentType, OFString &documentTitle) |
convert SR document type to document title. | |
static OFBool | requiresEnhancedEquipmentModule (const E_DocumentType documentType) |
check whether SR document type requires Enhanced General Equipment Module | |
static const char * | relationshipTypeToDefinedTerm (const E_RelationshipType relationshipType) |
convert relationship type to DICOM defined term | |
static const char * | relationshipTypeToReadableName (const E_RelationshipType relationshipType) |
convert relationship type to readable name. | |
static const char * | valueTypeToDefinedTerm (const E_ValueType valueType) |
convert value type to DICOM defined term | |
static const char * | valueTypeToXMLTagName (const E_ValueType valueType) |
convert value type to XML tag name | |
static const char * | valueTypeToReadableName (const E_ValueType valueType) |
convert value type to readable name. | |
static const char * | graphicTypeToEnumeratedValue (const E_GraphicType graphicType) |
convert graphic type to DICOM enumerated value | |
static const char * | graphicTypeToReadableName (const E_GraphicType graphicType) |
convert graphic type to readable name. | |
static const char * | graphicType3DToEnumeratedValue (const E_GraphicType3D graphicType) |
convert graphic type (3D) to DICOM enumerated value | |
static const char * | graphicType3DToReadableName (const E_GraphicType3D graphicType) |
convert graphic type (3D) to readable name. | |
static const char * | temporalRangeTypeToEnumeratedValue (const E_TemporalRangeType temporalRangeType) |
convert temporal range type to DICOM enumerated value | |
static const char * | temporalRangeTypeToReadableName (const E_TemporalRangeType temporalRangeType) |
convert temporal range type to readable name. | |
static const char * | continuityOfContentToEnumeratedValue (const E_ContinuityOfContent continuityOfContent) |
convert continuity of content flag to DICOM enumerated value | |
static const char * | preliminaryFlagToEnumeratedValue (const E_PreliminaryFlag preliminaryFlag) |
convert preliminary flag to DICOM enumerated value | |
static const char * | completionFlagToEnumeratedValue (const E_CompletionFlag completionFlag) |
convert completion flag to DICOM enumerated value | |
static const char * | verificationFlagToEnumeratedValue (const E_VerificationFlag verificationFlag) |
convert verification flag to DICOM enumerated value | |
static const char * | characterSetToDefinedTerm (const E_CharacterSet characterSet) |
convert character set to DICOM defined term | |
static const char * | characterSetToHTMLName (const E_CharacterSet characterSet) |
convert character set to HTML name. | |
static const char * | characterSetToXMLName (const E_CharacterSet characterSet) |
convert character set to XML name. | |
static E_DocumentType | sopClassUIDToDocumentType (const OFString &sopClassUID) |
convert SOP class UID to SR document type | |
static E_RelationshipType | definedTermToRelationshipType (const OFString &definedTerm) |
convert DICOM defined term to relationship type | |
static E_ValueType | definedTermToValueType (const OFString &definedTerm) |
convert DICOM defined term to value type | |
static E_ValueType | xmlTagNameToValueType (const OFString &xmlTagName) |
convert XML tag name to value type | |
static E_GraphicType | enumeratedValueToGraphicType (const OFString &enumeratedValue) |
convert DICOM enumerated value to graphic type | |
static E_GraphicType3D | enumeratedValueToGraphicType3D (const OFString &enumeratedValue) |
convert DICOM enumerated value to graphic type (3D) | |
static E_TemporalRangeType | enumeratedValueToTemporalRangeType (const OFString &enumeratedValue) |
convert DICOM enumerated value to temporal range type | |
static E_ContinuityOfContent | enumeratedValueToContinuityOfContent (const OFString &enumeratedValue) |
convert DICOM enumerated value to continuity of content flag | |
static E_PreliminaryFlag | enumeratedValueToPreliminaryFlag (const OFString &enumeratedValue) |
convert DICOM enumerated value to preliminary flag | |
static E_CompletionFlag | enumeratedValueToCompletionFlag (const OFString &enumeratedValue) |
convert DICOM enumerated value to completion flag | |
static E_VerificationFlag | enumeratedValueToVerificationFlag (const OFString &enumeratedValue) |
convert DICOM enumerated value to verification flag | |
static E_CharacterSet | definedTermToCharacterSet (const OFString &definedTerm) |
convert DICOM defined term to character set | |
static OFBool | isDocumentTypeSupported (const E_DocumentType documentType) |
check whether specified SR document type is supported by this library. | |
static const OFString & | currentDate (OFString &dateString) |
get current date in DICOM 'DA' format. | |
static const OFString & | currentTime (OFString &timeString) |
get current time in DICOM 'TM' format. | |
static const OFString & | currentDateTime (OFString &dateTimeString) |
get current date and time in DICOM 'DT' format. | |
static const OFString & | dicomToReadableDate (const OFString &dicomDate, OFString &readableDate) |
convert DICOM date string to readable format. | |
static const OFString & | dicomToReadableTime (const OFString &dicomTime, OFString &readableTime) |
convert DICOM time string to readable format. | |
static const OFString & | dicomToReadableDateTime (const OFString &dicomDateTime, OFString &readableDateTime) |
convert DICOM date time string to readable format. | |
static const OFString & | dicomToReadablePersonName (const OFString &dicomPersonName, OFString &readablePersonName) |
convert DICOM person name to readable format. | |
static const OFString & | dicomToXMLPersonName (const OFString &dicomPersonName, OFString &xmlPersonName, const OFBool writeEmptyValue=OFFalse) |
convert DICOM person name to XML format. | |
static const char * | numberToString (const size_t number, char *stringValue) |
convert unsigned integer number to character string | |
static size_t | stringToNumber (const char *stringValue) |
convert string to unsigned integer number | |
static const OFString & | convertToPrintString (const OFString &sourceString, OFString &printString) |
convert character string to print string. | |
static const OFString & | convertToHTMLString (const OFString &sourceString, OFString &markupString, const size_t flags=0, const OFBool newlineAllowed=OFFalse) |
convert character string to HTML mnenonic string. | |
static const OFString & | convertToXMLString (const OFString &sourceString, OFString &markupString) |
convert character string to XML mnenonic string. | |
static OFBool | checkForValidUIDFormat (const OFString &stringValue) |
check string for valid UID format. | |
static DSRIODConstraintChecker * | createIODConstraintChecker (const E_DocumentType documentType) |
create specified SR IOD content relationship contraint checker object. | |
static DSRDocumentTreeNode * | createDocumentTreeNode (const E_RelationshipType relationshipType, const E_ValueType valueType) |
create specified document tree node. | |
static OFCondition | addElementToDataset (OFCondition &result, DcmItem &dataset, DcmElement *delem, const OFString &vm, const OFString &type, const char *moduleName=NULL) |
add given element to the dataset. | |
static void | removeAttributeFromSequence (DcmSequenceOfItems &sequence, const DcmTagKey &tagKey) |
remove given attribute from the sequence. | |
static OFCondition | getElementFromDataset (DcmItem &dataset, DcmElement &delem) |
get element from dataset | |
static const char * | getStringValueFromElement (const DcmElement &delem) |
get string value from element | |
static const OFString & | getStringValueFromElement (const DcmElement &delem, OFString &stringValue) |
get string value from element | |
static const OFString & | getPrintStringFromElement (const DcmElement &delem, OFString &stringValue) |
get string value from element and convert to "print" format | |
static const OFString & | getMarkupStringFromElement (const DcmElement &delem, OFString &stringValue, const OFBool convertNonASCII=OFFalse) |
get string value from element and convert to HTML/XML | |
static OFCondition | getStringValueFromDataset (DcmItem &dataset, const DcmTagKey &tagKey, OFString &stringValue) |
get string value from dataset | |
static OFCondition | putStringValueToDataset (DcmItem &dataset, const DcmTag &tag, const OFString &stringValue, const OFBool allowEmpty=OFTrue) |
put string value to dataset | |
static OFBool | checkElementValue (DcmElement &delem, const OFString &vm, const OFString &type, const OFCondition &searchCond=EC_Normal, const char *moduleName=NULL) |
check element value for correct value multipicity and type. | |
static OFCondition | getAndCheckElementFromDataset (DcmItem &dataset, DcmElement &delem, const OFString &vm, const OFString &type, const char *moduleName=NULL) |
get element from dataset and check it for correct value multipicity and type. | |
static OFCondition | getAndCheckStringValueFromDataset (DcmItem &dataset, const DcmTagKey &tagKey, OFString &stringValue, const OFString &vm, const OFString &type, const char *moduleName=NULL) |
get string value from dataset and check it for correct value multipicity and type. | |
static void | printInvalidContentItemMessage (const char *action, const DSRDocumentTreeNode *node, const char *location=NULL) |
print the warning message that the current content item is invalid/incomplete. | |
static void | printContentItemErrorMessage (const char *action, const OFCondition &result, const DSRDocumentTreeNode *node, const char *location=NULL) |
print an error message for the current content item. | |
static void | printUnknownValueWarningMessage (const char *valueName, const char *readValue=NULL, const char *action="Reading") |
print a warning message that an unknown/unsupported value has been determined | |
static OFBool | writeStringValueToXML (STD_NAMESPACE ostream &stream, const OFString &stringValue, const OFString &tagName, const OFBool writeEmptyValue=OFFalse) |
write string value to XML output stream. | |
static OFBool | writeStringFromElementToXML (STD_NAMESPACE ostream &stream, DcmElement &delem, const OFString &tagName, const OFBool writeEmptyValue=OFFalse) |
write string value from DICOM element to XML output stream. | |
static size_t | createHTMLAnnexEntry (STD_NAMESPACE ostream &docStream, STD_NAMESPACE ostream &annexStream, const OFString &referenceText, size_t &annexNumber, const size_t flags=0) |
create an HTML annex entry with hyperlinks. | |
static size_t | createHTMLFootnote (STD_NAMESPACE ostream &docStream, STD_NAMESPACE ostream &footnoteStream, size_t &footnoteNumber, const size_t nodeID, const size_t flags=0) |
create an HTML footnote with hyperlinks | |
static OFCondition | appendStream (STD_NAMESPACE ostream &mainStream, OFOStringStream &tempStream, const char *heading=NULL) |
append one output stream to another. | |
![]() | |
static const size_t | RF_readDigitalSignatures |
read digital signatures from dataset | |
static const size_t | RF_acceptUnknownRelationshipType |
accept unknown/missing relationship type | |
static const size_t | RF_ignoreRelationshipConstraints |
ignore relationship constraints for this document class | |
static const size_t | RF_ignoreContentItemErrors |
do not abort on content item errors (e.g. missing value type specific attributes) | |
static const size_t | RF_skipInvalidContentItems |
do not abort when detecting an invalid content item, skip invalid sub-tree instead | |
static const size_t | RF_showCurrentlyProcessedItem |
show the currently processed content item (e.g. "1.2.3") | |
static const size_t | HF_neverExpandChildrenInline |
external: never expand child nodes inline | |
static const size_t | HF_alwaysExpandChildrenInline |
external: always expand child nodes inline | |
static const size_t | HF_renderInlineCodes |
external: render codes even if they appear inline | |
static const size_t | HF_useCodeDetailsTooltip |
external: render code details as a tooltip (not with HTML 3.2) | |
static const size_t | HF_renderConceptNameCodes |
external: render concept name codes (default: code meaning only) | |
static const size_t | HF_renderNumericUnitCodes |
external: render the code of the numeric measurement unit | |
static const size_t | HF_useCodeMeaningAsUnit |
external: use code meaning for the numeric measurement unit (default: code value) | |
static const size_t | HF_renderPatientTitle |
external: use patient information as document title (default: document type) | |
static const size_t | HF_renderNoDocumentHeader |
external: render no general document information (header) | |
static const size_t | HF_renderDcmtkFootnote |
external: render dcmtk/dcmsr comment at the end of the document | |
static const size_t | HF_renderFullData |
external: render the full data of all content items | |
static const size_t | HF_renderSectionTitlesInline |
external: render section titles inline (default: separate paragraph) | |
static const size_t | HF_copyStyleSheetContent |
external: copy Cascading Style Sheet (CSS) content to HTML file | |
static const size_t | HF_HTML32Compatibility |
external: output compatible to HTML version 3.2 (default: 4.01) | |
static const size_t | HF_XHTML11Compatibility |
external: output compatible to XHTML version 1.1 (default: HTML 4.01) | |
static const size_t | HF_addDocumentTypeReference |
external: add explicit reference to HTML document type (DTD) | |
static const size_t | HF_omitGeneratorMetaElement |
external: omit generator meta element referring to the DCMTK | |
static const size_t | HF_renderItemsSeparately |
internal: render items separately (for container with SEPARATE flag) | |
static const size_t | HF_renderItemInline |
internal: expand items inline when they are short and have no child nodes | |
static const size_t | HF_currentlyInsideAnnex |
internal: content item is rendered fully inside the annex | |
static const size_t | HF_createFootnoteReferences |
internal: create footnote references | |
static const size_t | HF_convertNonASCIICharacters |
internal: convert non-ASCII characters (> #127) to &#nnn; | |
static const size_t | HF_renderAllCodes |
shortcut: render all codes | |
static const size_t | HF_internalUseOnly |
shortcut: filter all flags that are only used internally | |
static const size_t | XF_writeEmptyTags |
write: write all tags even if their value is empty | |
static const size_t | XF_writeTemplateIdentification |
write: write template identification information (TID and mapping resource) | |
static const size_t | XF_alwaysWriteItemIdentifier |
write: always write item identifier "id", not only when item is referenced | |
static const size_t | XF_codeComponentsAsAttribute |
write: encode code value, coding scheme designator and coding scheme version as attribute instead of element text | |
static const size_t | XF_relationshipTypeAsAttribute |
write: encode relationship type as attribute instead of element text | |
static const size_t | XF_valueTypeAsAttribute |
write: encode value type as attribute instead of element text | |
static const size_t | XF_templateIdentifierAsAttribute |
write: encode template identifier as attribute instead of element text | |
static const size_t | XF_useDcmsrNamespace |
write: add DCMSR namespace declaration to the XML output | |
static const size_t | XF_addSchemaReference |
write: add Schema reference to XML document | |
static const size_t | XF_validateSchema |
read: validate content of XML document against Schema | |
static const size_t | XF_templateElementEnclosesItems |
read/write: template identification element encloses content items | |
static const size_t | XF_encodeEverythingAsAttribute |
shortcut: combines all XF_xxxAsAttribute write flags (see above) | |
static const size_t | PF_printItemPosition |
print item position ("1.2.3") instead of line indentation | |
static const size_t | PF_shortenLongItemValues |
shorten long item value (e.g. long texts) | |
static const size_t | PF_printSOPInstanceUID |
print SOP instance UID of referenced objects | |
static const size_t | PF_printConceptNameCodes |
print coding scheme designator/version and code value of concept names | |
static const size_t | PF_printNoDocumentHeader |
print no general document information (header) | |
static const size_t | PF_printTemplateIdentification |
print template identification (TID and mapping resource) | |
static const size_t | PF_printAllCodes |
shortcut: print all codes | |
static const size_t | CM_updatePositionString |
update the position string using the node ID | |
static const size_t | CM_updateNodeID |
update the node ID using the position string | |
static const size_t | CM_resetReferenceTargetFlag |
reset the reference target flag for all nodes | |
Class for SOP instance reference lists.
Definition at line 53 of file dsrsoprf.h.
DSRSOPInstanceReferenceList::DSRSOPInstanceReferenceList | ( | const DcmTagKey & | sequence | ) |
constructor
sequence | DICOM tag specifying the attribute (sequence) of the reference list |
OFCondition DSRSOPInstanceReferenceList::addItem | ( | const OFString & | studyUID, |
const OFString & | seriesUID, | ||
const OFString & | sopClassUID, | ||
const OFString & | instanceUID | ||
) |
add the specified item to the list of references.
Internally the item is inserted into the hierarchical structure of studies, series and instances, if not already contained in the list. In any case the specified item is selected as the current one.
studyUID | study instance UID of the entry to be added |
seriesUID | series instance UID of the entry to be added |
sopClassUID | SOP class UID of the entry to be added |
instanceUID | SOP instance UID of the entry to be added |
OFCondition DSRSOPInstanceReferenceList::addItem | ( | DcmItem & | dataset | ) |
add item from specified DICOM dataset to the list of references.
Internally an item representing the given dataset is inserted into the hierarchical structure of studies, series and instances, if not already contained in the list. In any case the specified item is selected as the current one.
dataset | reference to DICOM dataset from which the relevant UIDs are retrieved |
OFBool DSRSOPInstanceReferenceList::empty | ( | ) | const |
check whether list of references is empty
|
protected |
get pointer to currently selected instance structure (if any)
|
protected |
get pointer to currently selected series structure (if any)
|
protected |
get pointer to currently selected study structure (if any)
size_t DSRSOPInstanceReferenceList::getNumberOfInstances | ( | ) | const |
get number of instance stored in the list of references
get the retrieve application entity title of the currently selected entry (optional).
The resulting string may contain multiple values separated by a backslash ("\").
stringValue | reference to string variable in which the result is stored |
get the series instance UID of the currently selected entry
stringValue | reference to string variable in which the result is stored |
get the SOP class UID of the currently selected entry
stringValue | reference to string variable in which the result is stored |
get the SOP instance UID of the currently selected entry
stringValue | reference to string variable in which the result is stored |
const OFString& DSRSOPInstanceReferenceList::getStorageMediaFileSetID | ( | OFString & | stringValue | ) | const |
get the storage media file set ID of the currently selected entry (optional)
stringValue | reference to string variable in which the result is stored |
const OFString& DSRSOPInstanceReferenceList::getStorageMediaFileSetUID | ( | OFString & | stringValue | ) | const |
get the storage media file set UID of the currently selected entry (optional)
stringValue | reference to string variable in which the result is stored |
get the study instance UID of the currently selected entry
stringValue | reference to string variable in which the result is stored |
OFCondition DSRSOPInstanceReferenceList::gotoFirstItem | ( | ) |
select the first item in the list.
That means the first instance in the first series of the first study is selected (if available).
OFCondition DSRSOPInstanceReferenceList::gotoItem | ( | const OFString & | sopClassUID, |
const OFString & | instanceUID | ||
) |
select the specified item as the current one
sopClassUID | SOP class UID of the item to be selected |
instanceUID | SOP instance UID of the item to be selected |
OFCondition DSRSOPInstanceReferenceList::gotoItem | ( | const OFString & | studyUID, |
const OFString & | seriesUID, | ||
const OFString & | instanceUID | ||
) |
select the specified item as the current one
studyUID | study instance UID of the item to be selected |
seriesUID | series instance UID of the item to be selected |
instanceUID | SOP instance UID of the item to be selected |
OFCondition DSRSOPInstanceReferenceList::gotoNextItem | ( | ) |
select the next item in the list.
That means the next instance in the current series, or the first instance in the next series, or the first instance in the first series of the next study is selected (if available). The combination of this function and gotoFirstItem() allows to iterate over all referenced SOP instances.
|
protected |
set cursor to the specified study entry (if existent)
studyUID | study instance UID of the entry to be searched for |
OFCondition DSRSOPInstanceReferenceList::read | ( | DcmItem & | dataset | ) |
read list of referenced SOP instances.
The hierarchical structure is automatically reorganized in a way that each study, each series (within a study) and each instance (within a series) only exist once, i.e. the structure might look different when written back to a dataset. However, the content is identical and this way of storing information saves storage space.
dataset | DICOM dataset from which the data should be read |
OFCondition DSRSOPInstanceReferenceList::readXML | ( | const DSRXMLDocument & | doc, |
DSRXMLCursor | cursor, | ||
const size_t | flags | ||
) |
read list of references from XML document.
The hierarchical structure is automatically reorganized in a way that each study, each series (within a study) and each instance (within a series) only exist once, i.e. the structure might look different when written back to a dataset. However, the content is identical and this way of storing information saves storage space.
doc | document containing the XML file content |
cursor | cursor pointing to the starting node |
flags | optional flag used to customize the reading process (see DSRTypes::XF_xxx) |
|
protected |
remove empty/incomplete items from the list.
(e.g. series with no instances or studies with no series) Please note that this function modifies the value of 'Iterator'.
OFCondition DSRSOPInstanceReferenceList::removeItem | ( | ) |
remove the current item from the list of referenced SOP instances.
After sucessful removal the cursor is set to the next valid position.
OFCondition DSRSOPInstanceReferenceList::removeItem | ( | const OFString & | sopClassUID, |
const OFString & | instanceUID | ||
) |
remove the specified item from the list of references.
After sucessful removal the cursor is set to the next valid position.
sopClassUID | SOP class UID of the item to be removed |
instanceUID | SOP instance UID of the item to be removed |
OFCondition DSRSOPInstanceReferenceList::removeItem | ( | const OFString & | studyUID, |
const OFString & | seriesUID, | ||
const OFString & | instanceUID | ||
) |
remove the specified item from the list of references.
After sucessful removal the cursor is set to the next valid position.
studyUID | study instance UID of the item to be removed |
seriesUID | series instance UID of the item to be removed |
instanceUID | SOP instance UID of the item to be removed |
OFCondition DSRSOPInstanceReferenceList::setRetrieveAETitle | ( | const OFString & | value | ) |
set the retrieve application entity title of the currently selected entry.
Multiple values are to be separated by a backslash ("\").
value | string value to be set (use empty string to omit optional attribute) |
OFCondition DSRSOPInstanceReferenceList::setStorageMediaFileSetID | ( | const OFString & | value | ) |
set the storage media file set ID of the currently selected entry
value | string value to be set (use empty string to omit optional attribute) |
OFCondition DSRSOPInstanceReferenceList::setStorageMediaFileSetUID | ( | const OFString & | value | ) |
set the storage media file set UID of the currently selected entry
value | string value to be set (use empty string to omit optional attribute) |
OFCondition DSRSOPInstanceReferenceList::write | ( | DcmItem & | dataset | ) | const |
write list of referenced SOP instances.
Does nothing if list is empty.
dataset | DICOM dataset to which the data should be written |
OFCondition DSRSOPInstanceReferenceList::writeXML | ( | STD_NAMESPACE ostream & | stream, |
const size_t | flags = 0 |
||
) | const |
write current list of references in XML format
stream | output stream to which the XML data is written |
flags | optional flag used to customize the output (see DSRTypes::XF_xxx) |