dcmsr/include/dcmtk/dcmsr/dsrtypes.h

/*
 *
 *  Copyright (C) 2000-2010, OFFIS e.V.
 *  All rights reserved.  See COPYRIGHT file for details.
 *
 *  This software and supporting documentation were developed by
 *
 *    OFFIS e.V.
 *    R&D Division Health
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *
 *  Module: dcmsr
 *
 *  Author: Joerg Riesmeier
 *
 *  Purpose:
 *    classes: DSRTypes
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2010-11-05 11:06:53 $
 *  CVS/RCS Revision: $Revision: 1.68 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */


#ifndef DSRTYPES_H
#define DSRTYPES_H

#include "dcmtk/config/osconfig.h"   /* make sure OS specific configuration is included first */

#include "dcmtk/dcmdata/dctk.h"

#include "dcmtk/ofstd/ofstream.h"
#include "dcmtk/ofstd/oftypes.h"
#include "dcmtk/ofstd/ofcond.h"
#include "dcmtk/oflog/oflog.h"

OFLogger DCM_dcmsrGetLogger();

#define DCMSR_TRACE(msg) OFLOG_TRACE(DCM_dcmsrGetLogger(), msg)
#define DCMSR_DEBUG(msg) OFLOG_DEBUG(DCM_dcmsrGetLogger(), msg)
#define DCMSR_INFO(msg)  OFLOG_INFO(DCM_dcmsrGetLogger(), msg)
#define DCMSR_WARN(msg)  OFLOG_WARN(DCM_dcmsrGetLogger(), msg)
#define DCMSR_ERROR(msg) OFLOG_ERROR(DCM_dcmsrGetLogger(), msg)
#define DCMSR_FATAL(msg) OFLOG_FATAL(DCM_dcmsrGetLogger(), msg)


/*---------------------*
 *  macro definitions  *
 *---------------------*/

// private coding scheme designator used for internal codes
#define OFFIS_CODING_SCHEME_DESIGNATOR "99_OFFIS_DCMTK"
// name of the private coding scheme
#define OFFIS_CODING_SCHEME_NAME "OFFIS DCMTK Coding Scheme"
// organization responsible for the private coding scheme
#define OFFIS_RESPONSIBLE_ORGANIZATION "OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany"

// protocol, hostname and CGI script name used for HTML hyperlinks to composite objects
#define HTML_HYPERLINK_PREFIX_FOR_CGI "http://localhost/dicom.cgi"
// URL of the DICOM toolkit DCMTK
#define DCMTK_INTERNET_URL "http://dicom.offis.de/dcmtk"

// XML namespace URI for dcmsr module
#define DCMSR_XML_NAMESPACE_URI "http://dicom.offis.de/dcmsr"
// XML Schema file for dcmsr module
#define DCMSR_XML_XSD_FILE "dsr2xml.xsd"
// XML Schema Instance URI
#define XML_SCHEMA_INSTANCE_URI "http://www.w3.org/2001/XMLSchema-instance"


/*------------------------*
 *  forward declarations  *
 *------------------------*/

class DSRXMLCursor;
class DSRXMLDocument;
class DSRDocumentTreeNode;
class DSRIODConstraintChecker;


/*-----------------------*
 *  contant definitions  *
 *-----------------------*/


extern const OFCondition SR_EC_UnknownDocumentType;

extern const OFCondition SR_EC_InvalidDocument;

extern const OFCondition SR_EC_InvalidDocumentTree;

extern const OFCondition SR_EC_MandatoryAttributeMissing;

extern const OFCondition SR_EC_InvalidValue;

extern const OFCondition SR_EC_UnsupportedValue;

extern const OFCondition SR_EC_UnknownValueType;

extern const OFCondition SR_EC_UnknownRelationshipType;

extern const OFCondition SR_EC_InvalidByValueRelationship;

extern const OFCondition SR_EC_InvalidByReferenceRelationship;

extern const OFCondition SR_EC_SOPInstanceNotFound;

extern const OFCondition SR_EC_DifferentSOPClassesForAnInstance;

extern const OFCondition SR_EC_CodingSchemeNotFound;

extern const OFCondition SR_EC_CorruptedXMLStructure;


/*---------------------*
 *  class declaration  *
 *---------------------*/

class DSRTypes
{

  public:

  // --- constant declarations ---


    static const size_t RF_readDigitalSignatures;

    static const size_t RF_acceptUnknownRelationshipType;

    static const size_t RF_ignoreRelationshipConstraints;

    static const size_t RF_ignoreContentItemErrors;

    static const size_t RF_skipInvalidContentItems;

    static const size_t RF_showCurrentlyProcessedItem;



    static const size_t HF_neverExpandChildrenInline;

    static const size_t HF_alwaysExpandChildrenInline;

    static const size_t HF_renderInlineCodes;

    static const size_t HF_useCodeDetailsTooltip;

    static const size_t HF_renderConceptNameCodes;

    static const size_t HF_renderNumericUnitCodes;

    static const size_t HF_useCodeMeaningAsUnit;

    static const size_t HF_renderPatientTitle;

    static const size_t HF_renderNoDocumentHeader;

    static const size_t HF_renderDcmtkFootnote;

    static const size_t HF_renderFullData;

    static const size_t HF_renderSectionTitlesInline;

    static const size_t HF_copyStyleSheetContent;

    static const size_t HF_HTML32Compatibility;

    static const size_t HF_XHTML11Compatibility;

    static const size_t HF_addDocumentTypeReference;

    static const size_t HF_omitGeneratorMetaElement;

    static const size_t HF_renderItemsSeparately;

    static const size_t HF_renderItemInline;

    static const size_t HF_currentlyInsideAnnex;

    static const size_t HF_createFootnoteReferences;

    static const size_t HF_convertNonASCIICharacters;

    static const size_t HF_renderAllCodes;

    static const size_t HF_internalUseOnly;



    static const size_t XF_writeEmptyTags;

    static const size_t XF_writeTemplateIdentification;

    static const size_t XF_alwaysWriteItemIdentifier;

    static const size_t XF_codeComponentsAsAttribute;

    static const size_t XF_relationshipTypeAsAttribute;

    static const size_t XF_valueTypeAsAttribute;

    static const size_t XF_templateIdentifierAsAttribute;

    static const size_t XF_useDcmsrNamespace;

    static const size_t XF_addSchemaReference;

    static const size_t XF_validateSchema;

    static const size_t XF_templateElementEnclosesItems;

    static const size_t XF_encodeEverythingAsAttribute;



    static const size_t PF_printItemPosition;

    static const size_t PF_shortenLongItemValues;

    static const size_t PF_printSOPInstanceUID;

    static const size_t PF_printConceptNameCodes;

    static const size_t PF_printNoDocumentHeader;

    static const size_t PF_printTemplateIdentification;

    static const size_t PF_printAllCodes;



    static const size_t CM_updatePositionString;

    static const size_t CM_updateNodeID;

    static const size_t CM_resetReferenceTargetFlag;


  // --- type definitions ---

    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
    };

    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
    };

    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
    };

    enum E_GraphicType
    {
        GT_invalid,
        GT_unknown = GT_invalid,
        GT_Point,
        GT_Multipoint,
        GT_Polyline,
        GT_Circle,
        GT_Ellipse,
        GT_last = GT_Ellipse
    };

    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
    };

    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
    };

    enum E_ContinuityOfContent
    {
        COC_invalid,
        COC_Separate,
        COC_Continuous,
        COC_last = COC_Continuous
    };

    enum E_PreliminaryFlag
    {
        PF_invalid,
        PF_Preliminary,
        PF_Final,
        PF_last = PF_Final
    };

    enum E_CompletionFlag
    {
        CF_invalid,
        CF_Partial,
        CF_Complete,
        CF_last = CF_Complete
    };

    enum E_VerificationFlag
    {
        VF_invalid,
        VF_Unverified,
        VF_Verified,
        VF_last = VF_Verified
    };

    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,
        // UTF-8: Unicode in UTF-8
        CS_UTF8,
        CS_last = CS_UTF8
    };

    enum E_AddMode
    {
        AM_afterCurrent,
        AM_beforeCurrent,
        AM_belowCurrent
    };


  // --- destructor ---

    virtual ~DSRTypes();


  // --- conversion functions ---

    static const char *documentTypeToSOPClassUID(const E_DocumentType documentType);

    static const char *documentTypeToModality(const E_DocumentType documentType);

    static const char *documentTypeToReadableName(const E_DocumentType documentType);

    static const char *documentTypeToDocumentTitle(const E_DocumentType documentType,
                                                   OFString &documentTitle);

    static OFBool requiresEnhancedEquipmentModule(const E_DocumentType documentType);

    static const char *relationshipTypeToDefinedTerm(const E_RelationshipType relationshipType);

    static const char *relationshipTypeToReadableName(const E_RelationshipType relationshipType);

    static const char *valueTypeToDefinedTerm(const E_ValueType valueType);

    static const char *valueTypeToXMLTagName(const E_ValueType valueType);

    static const char *valueTypeToReadableName(const E_ValueType valueType);

    static const char *graphicTypeToEnumeratedValue(const E_GraphicType graphicType);

    static const char *graphicTypeToReadableName(const E_GraphicType graphicType);

    static const char *graphicType3DToEnumeratedValue(const E_GraphicType3D graphicType);

    static const char *graphicType3DToReadableName(const E_GraphicType3D graphicType);

    static const char *temporalRangeTypeToEnumeratedValue(const E_TemporalRangeType temporalRangeType);

    static const char *temporalRangeTypeToReadableName(const E_TemporalRangeType temporalRangeType);

    static const char *continuityOfContentToEnumeratedValue(const E_ContinuityOfContent continuityOfContent);

    static const char *preliminaryFlagToEnumeratedValue(const E_PreliminaryFlag preliminaryFlag);

    static const char *completionFlagToEnumeratedValue(const E_CompletionFlag completionFlag);

    static const char *verificationFlagToEnumeratedValue(const E_VerificationFlag verificationFlag);

    static const char *characterSetToDefinedTerm(const E_CharacterSet characterSet);

    static const char *characterSetToHTMLName(const E_CharacterSet characterSet);

    static const char *characterSetToXMLName(const E_CharacterSet characterSet);

    static E_DocumentType sopClassUIDToDocumentType(const OFString &sopClassUID);

    static E_RelationshipType definedTermToRelationshipType(const OFString &definedTerm);

    static E_ValueType definedTermToValueType(const OFString &definedTerm);

    static E_ValueType xmlTagNameToValueType(const OFString &xmlTagName);

    static E_GraphicType enumeratedValueToGraphicType(const OFString &enumeratedValue);

    static E_GraphicType3D enumeratedValueToGraphicType3D(const OFString &enumeratedValue);

    static E_TemporalRangeType enumeratedValueToTemporalRangeType(const OFString &enumeratedValue);

    static E_ContinuityOfContent enumeratedValueToContinuityOfContent(const OFString &enumeratedValue);

    static E_PreliminaryFlag enumeratedValueToPreliminaryFlag(const OFString &enumeratedValue);

    static E_CompletionFlag enumeratedValueToCompletionFlag(const OFString &enumeratedValue);

    static E_VerificationFlag enumeratedValueToVerificationFlag(const OFString &enumeratedValue);

    static E_CharacterSet definedTermToCharacterSet(const OFString &definedTerm);


  // --- misc helper functions ---

    static OFBool isDocumentTypeSupported(const E_DocumentType documentType);

    static const OFString &currentDate(OFString &dateString);

    static const OFString &currentTime(OFString &timeString);

    static const OFString &currentDateTime(OFString &dateTimeString);

    static const OFString &dicomToReadableDate(const OFString &dicomDate,
                                               OFString &readableDate);

    static const OFString &dicomToReadableTime(const OFString &dicomTime,
                                               OFString &readableTime);

    static const OFString &dicomToReadableDateTime(const OFString &dicomDateTime,
                                                   OFString &readableDateTime);

    static const OFString &dicomToReadablePersonName(const OFString &dicomPersonName,
                                                     OFString &readablePersonName);

    static const OFString &dicomToXMLPersonName(const OFString &dicomPersonName,
                                                OFString &xmlPersonName,
                                                const OFBool writeEmptyValue = OFFalse);

    static const char *numberToString(const size_t number,
                                      char *stringValue);

    static size_t stringToNumber(const char *stringValue);

    static const OFString &convertToPrintString(const OFString &sourceString,
                                                OFString &printString);

    static const OFString &convertToHTMLString(const OFString &sourceString,
                                               OFString &markupString,
                                               const size_t flags = 0,
                                               const OFBool newlineAllowed = OFFalse);

    static const OFString &convertToXMLString(const OFString &sourceString,
                                              OFString &markupString);

    static OFBool checkForValidUIDFormat(const OFString &stringValue);

    static DSRIODConstraintChecker *createIODConstraintChecker(const E_DocumentType documentType);

    static DSRDocumentTreeNode *createDocumentTreeNode(const E_RelationshipType relationshipType,
                                                       const E_ValueType valueType);


  // --- DICOM data structure access functions ---

    static OFCondition addElementToDataset(OFCondition &result,
                                           DcmItem &dataset,
                                           DcmElement *delem,
                                           const OFString &vm,
                                           const OFString &type,
                                           const char *moduleName = NULL);

    static void removeAttributeFromSequence(DcmSequenceOfItems &sequence,
                                            const DcmTagKey &tagKey);

    static OFCondition getElementFromDataset(DcmItem &dataset,
                                             DcmElement &delem);

    static const char *getStringValueFromElement(const DcmElement &delem);

    static const OFString &getStringValueFromElement(const DcmElement &delem,
                                                     OFString &stringValue);

    static const OFString &getPrintStringFromElement(const DcmElement &delem,
                                                     OFString &stringValue);

    static const OFString &getMarkupStringFromElement(const DcmElement &delem,
                                                      OFString &stringValue,
                                                      const OFBool convertNonASCII = OFFalse);

    static OFCondition getStringValueFromDataset(DcmItem &dataset,
                                                 const DcmTagKey &tagKey,
                                                 OFString &stringValue);

    static OFCondition putStringValueToDataset(DcmItem &dataset,
                                               const DcmTag &tag,
                                               const OFString &stringValue,
                                               const OFBool allowEmpty = OFTrue);

    static OFBool checkElementValue(DcmElement &delem,
                                    const OFString &vm,
                                    const OFString &type,
                                    const OFCondition &searchCond = EC_Normal,
                                    const char *moduleName = NULL);

    static OFCondition getAndCheckElementFromDataset(DcmItem &dataset,
                                                     DcmElement &delem,
                                                     const OFString &vm,
                                                     const OFString &type,
                                                     const char *moduleName = NULL);

    static OFCondition getAndCheckStringValueFromDataset(DcmItem &dataset,
                                                         const DcmTagKey &tagKey,
                                                         OFString &stringValue,
                                                         const OFString &vm,
                                                         const OFString &type,
                                                         const char *moduleName = NULL);

  // --- output functions ---

    static void printInvalidContentItemMessage(const char *action,
                                               const DSRDocumentTreeNode *node,
                                               const char *location = NULL);

    static void printContentItemErrorMessage(const char *action,
                                             const OFCondition &result,
                                             const DSRDocumentTreeNode *node,
                                             const char *location = NULL);

    static void printUnknownValueWarningMessage(const char *valueName,
                                                const char *readValue = NULL,
                                                const char *action = "Reading");

    static OFBool writeStringValueToXML(STD_NAMESPACE ostream &stream,
                                        const OFString &stringValue,
                                        const OFString &tagName,
                                        const OFBool writeEmptyValue = OFFalse);

    static OFBool writeStringFromElementToXML(STD_NAMESPACE ostream &stream,
                                              DcmElement &delem,
                                              const OFString &tagName,
                                              const OFBool writeEmptyValue = OFFalse);

    static size_t createHTMLAnnexEntry(STD_NAMESPACE ostream &docStream,
                                       STD_NAMESPACE ostream &annexStream,
                                       const OFString &referenceText,
                                       size_t &annexNumber,
                                       const size_t flags = 0);

    static size_t createHTMLFootnote(STD_NAMESPACE ostream &docStream,
                                     STD_NAMESPACE ostream &footnoteStream,
                                     size_t &footnoteNumber,
                                     const size_t nodeID,
                                     const size_t flags = 0);

    static OFCondition appendStream(STD_NAMESPACE ostream &mainStream,
                                    OFOStringStream &tempStream,
                                    const char *heading = NULL);
};


#endif


/*
 *  CVS/RCS Log:
 *  $Log: dsrtypes.h,v $
 *  Revision 1.68  2010-11-05 11:06:53  joergr
 *  Added support for new Implantation Plan SR Document Storage SOP Class.
 *
 *  Revision 1.67  2010-11-05 09:30:27  joergr
 *  Added support for checking the value multiplicity "9" (see Supplement 131).
 *
 *  Revision 1.66  2010-10-21 09:06:48  joergr
 *  Added virtual destructor in order to avoid warnings reported by gcc with
 *  additional flags.
 *
 *  Revision 1.65  2010-10-14 13:16:33  joergr
 *  Updated copyright header. Added reference to COPYRIGHT file.
 *
 *  Revision 1.64  2010-10-04 16:16:16  joergr
 *  Fixed various Doxygen API documentation issues.
 *
 *  Revision 1.63  2010-09-30 08:59:21  joergr
 *  Added support for the Spectacle Prescription Report IOD.
 *  Added support for the Macular Grid Thickness and Volume Report IOD.
 *  Renamed class and enumeration related to the Key Object Selection Document.
 *
 *  Revision 1.62  2010-09-29 15:16:45  joergr
 *  Enhanced checking and reporting of standard violations in write() methods.
 *
 *  Revision 1.61  2010-09-29 10:07:12  joergr
 *  Added support for the recently introduced, optional PreliminaryFlag.
 *
 *  Revision 1.60  2010-09-28 16:27:12  joergr
 *  Added support for Enhanced General Equipment Module which is required for
 *  both X-Ray Radiation Dose SR and Colon CAD SR.
 *
 *  Revision 1.59  2010-09-28 14:08:14  joergr
 *  Added support for Colon CAD SR which requires a new value type (SCOORD3D).
 *
 *  Revision 1.58  2010-04-23 14:38:34  joergr
 *  Enhanced checking of element values using the new DcmElement::checkValue()
 *  method.
 *
 *  Revision 1.57  2009-10-13 14:57:50  uli
 *  Switched to logging mechanism provided by the "new" oflog module.
 *
 *  Revision 1.56  2009-08-24 13:43:11  joergr
 *  Fixed wrong/misleading comments.
 *
 *  Revision 1.55  2009-07-27 15:32:29  joergr
 *  Fixed possible memory leak in method addElementToDataset().
 *
 *  Revision 1.54  2008-12-11 15:48:55  joergr
 *  Enhanced method checkElementValue(), e.g. added support for type 1C elements.
 *
 *  Revision 1.53  2008-07-17 12:00:36  joergr
 *  Removed getSequenceFromDataset() function.
 *
 *  Revision 1.52  2008-06-27 10:49:51  joergr
 *  Fixed condition that could lead to a wrong error message in method
 *  checkElementValue().
 *
 *  Revision 1.51  2008-05-19 09:48:55  joergr
 *  Added new flag that enables reading of SR documents with unknown/missing
 *  relationship type(s).
 *  Changed parameters of checkByReferenceRelationships() method.
 *
 *  Revision 1.50  2007/11/15 16:32:48  joergr
 *  Added support for output in XHTML 1.1 format.
 *  Enhanced support for output in valid HTML 3.2 format. Migrated support for
 *  standard HTML from version 4.0 to 4.01 (strict).
 *
 *  Revision 1.49  2006/08/15 16:40:03  meichel
 *  Updated the code in module dcmsr to correctly compile when
 *    all standard C++ classes remain in namespace std.
 *
 *  Revision 1.48  2006/07/25 13:21:29  joergr
 *  Added new optional flags for the HTML rendering of SR documents:
 *  HF_alwaysExpandChildrenInline, HF_useCodeDetailsTooltip and
 *  HF_renderSectionTitlesInline.
 *
 *  Revision 1.47  2006/05/11 09:18:21  joergr
 *  Moved containsExtendedCharacters() from dcmsr to dcmdata module.
 *
 *  Revision 1.46  2005/12/08 16:05:30  meichel
 *  Changed include path schema for all DCMTK header files
 *
 *  Revision 1.45  2005/11/30 12:00:24  joergr
 *  Added support for X-Ray Radiation Dose SR documents.
 *
 *  Revision 1.44  2004/11/29 17:11:01  joergr
 *  Added warning message when character set is unknown, unsupported  or cannot
 *  be mapped to the output format. Fixed minor formatting issues.
 *
 *  Revision 1.43  2004/11/22 16:35:38  meichel
 *  Added helper methods to check strings and DICOM elements for presence of
 *    extended (non-ASCII) characters
 *
 *  Revision 1.42  2004/09/09 14:01:30  joergr
 *  Added flags to control the way the template identification is encoded in
 *  writeXML() and expected in readXML().
 *
 *  Revision 1.41  2004/01/20 15:35:54  joergr
 *  Added new command line option which allows to write the item identifier "id"
 *  (XML attribute) even if it is not required (because the item is not referenced
 *  by any other item). Useful for debugging purposes.
 *
 *  Revision 1.40  2004/01/05 14:36:02  joergr
 *  Removed acknowledgements with e-mail addresses from CVS log.
 *
 *  Revision 1.39  2003/12/01 15:46:18  joergr
 *  Changed XML encoding of by-reference relationships if flag
 *  XF_valueTypeAsAttribute is set.
 *
 *  Revision 1.38  2003/10/30 17:51:00  joergr
 *  Added new command line options which allow to print/write the template
 *  identification of a content item.
 *
 *  Revision 1.37  2003/10/09 12:53:12  joergr
 *  Added support for Procedure Log.
 *
 *  Revision 1.36  2003/10/06 09:52:58  joergr
 *  Added new flag which allows to ignore content item errors when reading an SR
 *  document (e.g. missing value type specific attributes).
 *
 *  Revision 1.35  2003/09/15 14:18:54  joergr
 *  Introduced new class to facilitate checking of SR IOD relationship content
 *  constraints. Replaced old implementation distributed over numerous classes.
 *
 *  Revision 1.34  2003/09/10 13:16:13  joergr
 *  Replaced PrivateCodingSchemeUID by new CodingSchemeIdenticationSequence as
 *  required by CP 324.
 *
 *  Revision 1.33  2003/08/07 17:31:00  joergr
 *  Removed libxml dependency from header files. Simplifies linking (MSVC).
 *
 *  Revision 1.32  2003/08/07 13:05:26  joergr
 *  Added readXML functionality. Added support for Chest CAD SR.
 *  Added new option --add-schema-reference to command line tool dsr2xml.
 *  Renamed parameters/variables "string" to avoid name clash with STL class.
 *
 *  Revision 1.31  2003/04/17 18:57:38  joergr
 *  Replace LF and CR by 
 and 
 in XML mode instead of ¶ (para).
 *
 *  Revision 1.30  2003/04/01 14:59:13  joergr
 *  Added support for XML namespaces.
 *
 *  Revision 1.29  2002/08/02 12:38:32  joergr
 *  Enhanced debug output of dcmsr::read() routines (e.g. add position string
 *  of invalid content items to error messages).
 *
 *  Revision 1.28  2002/07/22 14:21:20  joergr
 *  Added new print flag to suppress the output of general document information.
 *
 *  Revision 1.27  2002/05/14 08:14:51  joergr
 *  Updated comments.
 *
 *  Revision 1.26  2002/05/07 12:49:32  joergr
 *  Added support for the Current Requested Procedure Evidence Sequence and the
 *  Pertinent Other Evidence Sequence to the dcmsr module.
 *
 *  Revision 1.25  2002/05/02 14:08:23  joergr
 *  Added support for standard and non-standard string streams (which one is
 *  supported is detected automatically via the configure mechanism).
 *
 *  Revision 1.24  2002/04/16 13:50:52  joergr
 *  Added configurable support for C++ ANSI standard includes (e.g. streams).
 *
 *  Revision 1.23  2002/04/11 13:02:35  joergr
 *  Corrected typo and/or enhanced documentation.
 *
 *  Revision 1.22  2001/11/09 16:10:54  joergr
 *  Added preliminary support for Mammography CAD SR.
 *
 *  Revision 1.21  2001/10/10 15:28:04  joergr
 *  Changed parameter DcmTagKey to DcmTag in DcmItem::putAndInsert... methods
 *  to support elements which are not in the data dictionary (e.g. private
 *  extensions).
 *
 *  Revision 1.20  2001/10/02 12:05:46  joergr
 *  Adapted module "dcmsr" to the new class OFCondition. Introduced module
 *  specific error codes.
 *
 *  Revision 1.19  2001/10/01 15:06:54  joergr
 *  Introduced new general purpose functions to get/set person names, date, time
 *  and date/time.
 *
 *  Revision 1.18  2001/09/26 13:04:14  meichel
 *  Adapted dcmsr to class OFCondition
 *
 *  Revision 1.17  2001/06/20 15:03:00  joergr
 *  Added minimal support for new SOP class Key Object Selection Document
 *  (suppl. 59).
 *  Added new debugging features (additional flags) to examine "corrupted" SR
 *  documents.
 *
 *  Revision 1.16  2001/04/03 08:24:00  joergr
 *  Added new command line option: ignore relationship content constraints
 *  specified for each SR document class.
 *
 *  Revision 1.15  2001/02/13 16:36:05  joergr
 *  Allow newline characters (encoded as ¶) in XML documents.
 *
 *  Revision 1.14  2001/02/02 14:37:33  joergr
 *  Added new option to dsr2xml allowing to specify whether value and/or
 *  relationship type are to be encoded as XML attributes or elements.
 *
 *  Revision 1.13  2001/01/25 11:47:43  joergr
 *  Always remove signature sequences from certain dataset sequences (e.g.
 *  VerifyingObserver or PredecessorDocuments).
 *
 *  Revision 1.12  2001/01/18 15:52:11  joergr
 *  Encode PN components in separate XML tags.
 *
 *  Revision 1.11  2000/12/08 13:45:17  joergr
 *  Removed optional fractional second part from time value.
 *
 *  Revision 1.10  2000/11/09 20:32:08  joergr
 *  Added support for non-ASCII characters in HTML 3.2 (use numeric value).
 *
 *  Revision 1.9  2000/11/09 11:31:46  joergr
 *  Reordered renderHTML flags (internal flags to the end).
 *
 *  Revision 1.8  2000/11/07 18:14:05  joergr
 *  Added new command line option allowing to choose code value or meaning to be
 *  rendered as the numeric measurement unit.
 *  Enhanced rendered HTML output of date, time, datetime and pname.
 *
 *  Revision 1.7  2000/11/06 11:21:04  joergr
 *  Changes structure of HTML hyperlinks to composite objects (now using pseudo
 *  CGI script).
 *
 *  Revision 1.6  2000/11/01 16:18:34  joergr
 *  Added support for conversion to XML.
 *  Added support for Cascading Style Sheet (CSS) used optionally for HTML
 *  rendering.
 *  Enhanced support for specific character sets.
 *
 *  Revision 1.5  2000/10/26 14:22:09  joergr
 *  Added support for "Comprehensive SR".
 *  Added support for TCOORD content item.
 *  Added new flag specifying whether to add a "dcmtk" footnote to the rendered
 *  HTML document or not.
 *  Added check routine for valid UID strings.
 *
 *  Revision 1.4  2000/10/18 17:10:25  joergr
 *  Added new method allowing to get and check string values from dataset.
 *
 *  Revision 1.3  2000/10/16 16:31:09  joergr
 *  Updated comments.
 *
 *  Revision 1.2  2000/10/16 11:52:58  joergr
 *  Added new options: number nested items instead of indenting them, print SOP
 *  instance UID of referenced composite objects.
 *
 *  Revision 1.1  2000/10/13 07:49:35  joergr
 *  Added new module 'dcmsr' providing access to DICOM structured reporting
 *  documents (supplement 23).  Doc++ documentation not yet completed.
 *
 *
 */

---

Generated on 6 Jan 2011 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.5.1