dcmsr/include/dsrimgvl.h

/*
 *
 *  Copyright (C) 2000-2003, OFFIS
 *
 *  This software and supporting documentation were developed by
 *
 *    Kuratorium OFFIS e.V.
 *    Healthcare Information and Communication Systems
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *  THIS SOFTWARE IS MADE AVAILABLE,  AS IS,  AND OFFIS MAKES NO  WARRANTY
 *  REGARDING  THE  SOFTWARE,  ITS  PERFORMANCE,  ITS  MERCHANTABILITY  OR
 *  FITNESS FOR ANY PARTICULAR USE, FREEDOM FROM ANY COMPUTER DISEASES  OR
 *  ITS CONFORMITY TO ANY SPECIFICATION. THE ENTIRE RISK AS TO QUALITY AND
 *  PERFORMANCE OF THE SOFTWARE IS WITH THE USER.
 *
 *  Module: dcmsr
 *
 *  Author: Joerg Riesmeier
 *
 *  Purpose:
 *    classes: DSRImageReferenceValue
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2003/10/06 09:52:35 $
 *  CVS/RCS Revision: $Revision: 1.12 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */


#ifndef DSRIMGVL_H
#define DSRIMGVL_H

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

#include "dsrtypes.h"
#include "dsrcomvl.h"
#include "dsrimgfr.h"


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

class DSRImageReferenceValue
  : public DSRCompositeReferenceValue
{
    // allow access to getValuePtr()
    friend class DSRContentItem;

  public:

    DSRImageReferenceValue();

    DSRImageReferenceValue(const OFString &sopClassUID,
                           const OFString &sopInstanceUID);

    DSRImageReferenceValue(const OFString &imageSOPClassUID,
                           const OFString &imageSOPInstanceUID,
                           const OFString &pstateSOPClassUID,
                           const OFString &pstateSOPInstanceUID);

    DSRImageReferenceValue(const DSRImageReferenceValue &referenceValue);

    DSRImageReferenceValue(const DSRCompositeReferenceValue &imageReferenceValue,
                           const DSRCompositeReferenceValue &pstateReferenceValue);

    virtual ~DSRImageReferenceValue();

    DSRImageReferenceValue &operator=(const DSRImageReferenceValue &referenceValue);

    virtual void clear();

    virtual OFBool isValid() const;

    virtual OFBool isShort(const size_t flags) const;

    virtual OFCondition print(ostream &stream,
                              const size_t flags) const;

    virtual OFCondition readXML(const DSRXMLDocument &doc,
                                DSRXMLCursor cursor);

    virtual OFCondition writeXML(ostream &stream,
                                 const size_t flags,
                                 OFConsole *logStream) const;

    virtual OFCondition renderHTML(ostream &docStream,
                                   ostream &annexStream,
                                   size_t &annexNumber,
                                   const size_t flags,
                                   OFConsole *logStream) const;

    inline const DSRImageReferenceValue &getValue() const
    {
        return *this;
    }

    OFCondition getValue(DSRImageReferenceValue &referenceValue) const;

    OFCondition setValue(const DSRImageReferenceValue &referenceValue);

    inline const DSRCompositeReferenceValue &getPresentationState() const
    {
        return PresentationState;
    }

    OFCondition setPresentationState(const DSRCompositeReferenceValue &referenceValue);

    inline DSRImageFrameList &getFrameList()
    {
        return FrameList;
    }

    OFBool appliesToFrame(const Sint32 frameNumber) const;


  protected:

    inline DSRImageReferenceValue *getValuePtr()
    {
        return this;
    }

    virtual OFCondition readItem(DcmItem &dataset,
                                 OFConsole *logStream);

    virtual OFCondition writeItem(DcmItem &dataset,
                                  OFConsole *logStream) const;

    virtual OFBool checkSOPClassUID(const OFString &sopClassUID) const;

    OFBool checkPresentationState(const DSRCompositeReferenceValue &referenceValue) const;


  private:

    DSRCompositeReferenceValue PresentationState;
    DSRImageFrameList FrameList;
    
    /* IconImageSequence (Type 3) not yet supported */
};


#endif


/*
 *  CVS/RCS Log:
 *  $Log: dsrimgvl.h,v $
 *  Revision 1.12  2003/10/06 09:52:35  joergr
 *  Added comment that the optional IconImageSequence is not yet supported.
 *
 *  Revision 1.11  2003/08/07 18:01:42  joergr
 *  Removed libxml dependency from header files.
 *
 *  Revision 1.10  2003/08/07 12:42:38  joergr
 *  Added readXML functionality.
 *
 *  Revision 1.9  2001/09/26 13:04:09  meichel
 *  Adapted dcmsr to class OFCondition
 *
 *  Revision 1.8  2001/06/01 15:51:01  meichel
 *  Updated copyright header
 *
 *  Revision 1.7  2000/11/06 11:17:21  joergr
 *  Moved some protected methods to public part.
 *
 *  Revision 1.6  2000/11/01 16:23:21  joergr
 *  Added support for conversion to XML.
 *
 *  Revision 1.5  2000/10/26 14:18:27  joergr
 *  Updated comments.
 *
 *  Revision 1.4  2000/10/20 10:15:42  joergr
 *  Renamed class DSRReferenceValue to DSRCompositeReferenceValue.
 *
 *  Revision 1.3  2000/10/18 17:04:23  joergr
 *  Added methods allowing direct access to certain content item values.
 *  Added doc++ comments.
 *
 *  Revision 1.2  2000/10/16 11:54:12  joergr
 *  Added new method checking whether an image content item applies to a
 *  certain frame.
 *
 *  Revision 1.1  2000/10/13 07:49:28  joergr
 *  Added new module 'dcmsr' providing access to DICOM structured reporting
 *  documents (supplement 23).  Doc++ documentation not yet completed.
 *
 *
 */

---

Generated on 4 Nov 2004 for OFFIS DCMTK Version 3.5.3 by Doxygen 1.3.8