dcmpstat/include/dcmtk/dcmpstat/dvpsda.h

/*
 *
 *  Copyright (C) 1998-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: dcmpstat
 *
 *  Author: Marco Eichelberg
 *
 *  Purpose:
 *    classes: DVPSDisplayedArea
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2010-10-14 13:16:36 $
 *  CVS/RCS Revision: $Revision: 1.10 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */

#ifndef DVPSDA_H
#define DVPSDA_H

#include "dcmtk/config/osconfig.h"    /* make sure OS specific configuration is included first */
#include "dcmtk/dcmdata/dctk.h"
#include "dcmtk/dcmpstat/dvpsril.h"     /* for DVPSReferencedImage_PList */
#include "dcmtk/dcmpstat/dvpstyp.h"     /* for enum types */

class DVPSReferencedSeries_PList;

class DVPSDisplayedArea
{
public:
  DVPSDisplayedArea();
  
  DVPSDisplayedArea(const DVPSDisplayedArea& copy);

  DVPSDisplayedArea *clone() { return new DVPSDisplayedArea(*this); }

  virtual ~DVPSDisplayedArea();

  OFCondition read(DcmItem &dset);
  
  OFCondition write(DcmItem &dset);

  OFBool isApplicable(const char *instanceUID, unsigned long frame);

  OFBool matchesApplicability(const char *instanceUID, unsigned long frame, DVPSObjectApplicability applicability);

  DVPSPresentationSizeMode getPresentationSizeMode();
  
  double getPresentationPixelAspectRatio();
  
  void getDisplayedArea(Sint32& tlhcX, Sint32& tlhcY, Sint32& brhcX, Sint32& brhcY);

  OFCondition getPresentationPixelSpacing(double& x, double& y);
  
  OFCondition getPresentationPixelMagnificationRatio(double& magnification);

  OFCondition addImageReference(
    const char *sopclassUID,
    const char *instanceUID, 
    unsigned long frame,
    DVPSObjectApplicability applicability);

  void removeImageReference(
    DVPSReferencedSeries_PList& allReferences,
    const char *instanceUID,
    unsigned long frame, 
    unsigned long numberOfFrames, 
    DVPSObjectApplicability applicability);

  void clearImageReferences() { referencedImageList.clear(); }
  
  OFBool imageReferencesEmpty() { if (referencedImageList.size()==0) return OFTrue; else return OFFalse; }
    
  OFBool canUseTrueSize();
  
  OFCondition setDisplayedAreaPixelSpacing(double spacingX, double spacingY);

  OFCondition setDisplayedAreaPixelSpacing(const char *spacing);
  
  OFCondition setDisplayedAreaPixelAspectRatio(double ratio);

  OFCondition setDisplayedAreaPixelAspectRatio(const char *ratio);
 
  OFCondition setDisplayedArea(
    DVPSPresentationSizeMode sizeMode,
    Sint32 tlhcX, Sint32 tlhcY, 
    Sint32 brhcX, Sint32 brhcY,
    double magnification=1.0);

  void rotateAndFlip(
    DVPSRotationType rotationFrom, 
    OFBool isFlippedFrom,
    DVPSRotationType rotationTo, 
    OFBool isFlippedTo);

private:
  DVPSDisplayedArea& operator=(const DVPSDisplayedArea& source);

  void switchHorizontalCorners();

  void switchVerticalCorners();

  void rotateAndFlipFromOrTo(DVPSRotationType rotation, OFBool isFlipped);

  DVPSReferencedImage_PList referencedImageList;
  DcmSignedLong            displayedAreaTopLeftHandCorner;
  DcmSignedLong            displayedAreaBottomRightHandCorner;
  DcmCodeString            presentationSizeMode;
  DcmDecimalString         presentationPixelSpacing;
  DcmIntegerString         presentationPixelAspectRatio;
  DcmFloatingPointSingle   presentationPixelMagnificationRatio;

};

#endif

/*
 *  $Log: dvpsda.h,v $
 *  Revision 1.10  2010-10-14 13:16:36  joergr
 *  Updated copyright header. Added reference to COPYRIGHT file.
 *
 *  Revision 1.9  2010-10-07 14:31:35  joergr
 *  Removed leading underscore characters from preprocessor symbols (reserved).
 *
 *  Revision 1.8  2009-11-24 14:12:57  uli
 *  Switched to logging mechanism provided by the "new" oflog module.
 *
 *  Revision 1.7  2005-12-08 16:03:39  meichel
 *  Changed include path schema for all DCMTK header files
 *
 *  Revision 1.6  2003/09/05 14:30:06  meichel
 *  Introduced new API methods that allow Displayed Areas to be queried
 *    and set either relative to the image (ignoring rotation and flip) or
 *    in absolute values as defined in the standard.  Rotate and flip methods
 *    now adjust displayed areas in the presentation state.
 *
 *  Revision 1.5  2001/09/26 15:36:09  meichel
 *  Adapted dcmpstat to class OFCondition
 *
 *  Revision 1.4  2001/06/01 15:50:14  meichel
 *  Updated copyright header
 *
 *  Revision 1.3  2000/06/02 16:00:44  meichel
 *  Adapted all dcmpstat classes to use OFConsole for log and error output
 *
 *  Revision 1.2  2000/03/08 16:28:50  meichel
 *  Updated copyright header.
 *
 *  Revision 1.1  1999/07/22 16:39:05  meichel
 *  Adapted dcmpstat data structures and API to supplement 33 letter ballot text.
 *
 *
 */

---

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