dvpscf.h

/*
 *
 *  Copyright (C) 1998-2005, 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: dcmpstat
 *
 *  Author: Marco Eichelberg, Joerg Riesmeier
 *
 *  Purpose:
 *    classes: DVConfiguration
 *
 *  Last Update:      $Author: meichel $
 *  Update Date:      $Date: 2005/12/08 16:03:36 $
 *  CVS/RCS Revision: $Revision: 1.32 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */


#ifndef DVPSCF_H
#define DVPSCF_H

#include "dcmtk/config/osconfig.h"   /* make sure OS specific configuration is included first */
#include "dcmtk/ofstd/ofstring.h"   /* for class OFString */
#include "dcmtk/dcmdata/dctypes.h"    /* for Uint32 */
#include "dcmtk/dcmpstat/dvpstyp.h"    /* for DVPS enums */

class OFConfigFile;
class OFConsole;

class DVConfiguration
{
 public:

  DVConfiguration(const char *config_file=NULL);

  virtual ~DVConfiguration();

  /* access to communication partner data */

  Uint32 getNumberOfTargets(DVPSPeerType peerType=DVPSE_storage);

  const char *getTargetID(Uint32 idx, DVPSPeerType peerType=DVPSE_storage);

  const char *getTargetDescription(const char *targetID);

  const char *getTargetHostname(const char *targetID);

  unsigned short getTargetPort(const char *targetID);

  DVPSPeerType getTargetType(const char *targetID);

  const char *getTargetAETitle(const char *targetID);

  unsigned long getTargetMaxPDU(const char *targetID);

  Sint32 getTargetTimeout(const char *targetID);

  OFBool getTargetImplicitOnly(const char *targetID);

  OFBool getTargetDisableNewVRs(const char *targetID);

  OFBool getTargetBitPreservingMode(const char *targetID);

  OFBool getTargetCorrectUIDPadding(const char *targetID);

  OFBool getTargetUseTLS(const char *targetID);

  const char *getTargetCertificate(const char *targetID);

  const char *getTargetPrivateKey(const char *targetID);

  const char *getTargetPrivateKeyPassword(const char *targetID);

  Uint32 getTargetNumberOfCipherSuites(const char *targetID);

  const char *getTargetCipherSuite(const char *targetID, Uint32 idx, OFString& value);

  DVPSCertificateVerificationType getTargetPeerAuthentication(const char *targetID);

  const char *getTargetDiffieHellmanParameters(const char *targetID);

  const char *getTargetRandomSeed(const char *targetID);

  OFBool getTargetPrinterSupportsPresentationLUT(const char *targetID);

  OFBool getTargetPrinterPresentationLUTMatchRequired(const char *targetID);

  OFBool getTargetPrinterPresentationLUTPreferSCPRendering(const char *targetID);

  OFBool getTargetPrinterPresentationLUTinFilmSession(const char *targetID);

  OFBool getTargetPrinterSupports12BitTransmission(const char *targetID);

  OFBool getTargetPrinterSupportsRequestedImageSize(const char *targetID);

  OFBool getTargetPrinterSupportsDecimateCrop(const char *targetID);

  OFBool getTargetPrinterSupportsTrim(const char *targetID);

  Uint32 getTargetPrinterNumberOfBorderDensities(const char *targetID);

  const char *getTargetPrinterBorderDensity(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfMaxDensities(const char *targetID);

  const char *getTargetPrinterMaxDensity(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfMinDensities(const char *targetID);

  const char *getTargetPrinterMinDensity(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfPortraitDisplayFormats(const char *targetID);

  Uint32 getTargetPrinterPortraitDisplayFormatRows(const char *targetID, Uint32 idx);

  Uint32 getTargetPrinterPortraitDisplayFormatColumns(const char *targetID, Uint32 idx);

  OFBool getTargetPrinterSupportsAnnotation(const char *targetID);

  OFBool getTargetPrinterSupportsAnnotationBoxSOPClass(const char *targetID);

  OFBool getTargetPrinterSessionLabelAnnotation(const char *targetID);

  const char *getTargetPrinterAnnotationDisplayFormatID(const char *targetID, OFString& value);
  
  Uint16 getTargetPrinterAnnotationPosition(const char *targetID);
  
  Uint32 getTargetPrinterNumberOfFilmSizeIDs(const char *targetID);

  const char *getTargetPrinterFilmSizeID(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfMediumTypes(const char *targetID);

  const char *getTargetPrinterMediumType(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfFilmDestinations(const char *targetID);

  const char *getTargetPrinterFilmDestination(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfPrinterResolutionIDs(const char *targetID);

  const char *getTargetPrinterResolutionID(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfMagnificationTypes(const char *targetID);

  const char *getTargetPrinterMagnificationType(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfSmoothingTypes(const char *targetID);

  const char *getTargetPrinterSmoothingType(const char *targetID, Uint32 idx, OFString& value);

  Uint32 getTargetPrinterNumberOfConfigurationSettings(const char *targetID);

  const char *getTargetPrinterConfigurationSetting(const char *targetID, Uint32 idx);

  Uint32 getTargetPrinterNumberOfEmptyImageDensities(const char *targetID);

  const char *getTargetPrinterEmptyImageDensity(const char *targetID, Uint32 idx, OFString& value);

  OFBool getTargetPrintSCPOmitSOPClassUIDFromCreateResponse(const char *targetID);

  /* general settings */

  const char *getLogFolder();

  const char *getLogFile();

  DVPSLogMessageLevel getLogLevel();

  unsigned short getMessagePort();

  OFBool getMessagePortKeepOpen();

  const char *getNetworkAETitle();

  OFBool getQueryRetrieveAutoCreateConfigFile();

  const char *getQueryRetrieveAETitle();

  unsigned short getQueryRetrievePort();

  unsigned long getQueryRetrieveMaxPDU();

  Sint32 getQueryRetrieveTimeout();

  unsigned long getQueryRetrieveMaxAssociations();

  const char *getDatabaseFolder();

  const char *getSpoolFolder();

  OFBool getDetailedLog();

  OFBool getBinaryLog();

  const char *getSenderName();

  const char *getReceiverName();

  const char *getQueryRetrieveServerName();

  const char *getSpoolerName();

  const char *getPrintServerName();

  const char *getDumpToolName();

  const char *getCheckToolName();

  unsigned long getSpoolerSleep();

  OFBool getSpoolerDeletePrintJobs();

  OFBool getSpoolerAlwaysDeleteTerminateJobs();

  const char *getMonitorCharacteristicsFile();

  double getMonitorPixelWidth();

  double getMonitorPixelHeight();

  Uint32 getMaxPreviewResolutionX();

  Uint32 getMaxPreviewResolutionY();

  const char *getGUIConfigEntry(const char *key);

  OFBool getGUIConfigEntryBool(const char *key, OFBool dfl);

  const char *getLUTFolder();

  const char *getReportFolder();

  /* Presentation Look Up Tables (LUTs) */

  Uint32 getNumberOfLUTs();

  const char *getLUTID(Uint32 idx);

  const char *getLUTDescription(const char *lutID);

  const char *getLUTFilename(const char *lutID);

  /* Structured Reporting (SR) "templates" */

  Uint32 getNumberOfReports();

  const char *getReportID(Uint32 idx);

  const char *getReportDescription(const char *reportID);

  const char *getReportFilename(const char *reportID);

  /* general print settings */

  Uint32 getMinPrintResolutionX();

  Uint32 getMinPrintResolutionY();

  Uint32 getMaxPrintResolutionX();

  Uint32 getMaxPrintResolutionY();

  Uint16 getDefaultPrintIllumination();

  Uint16 getDefaultPrintReflection();

  /* VOI settings */

  Uint32 getNumberOfVOIPresets(const char *modality);

  const char *getVOIPresetDescription(const char *modality, Uint32 idx);

  double getVOIPresetWindowCenter(const char *modality, Uint32 idx);

  double getVOIPresetWindowWidth(const char *modality, Uint32 idx);

  /* TLS settings */
  
  const char *getTLSFolder();

  const char *getTLSCACertificateFolder();

  OFBool getTLSPEMFormat();

  /* User login settings */

  const char *getUserCertificateFolder();

  Uint32 getNumberOfUsers();

  const char *getUserID(Uint32 idx);

  const char *getUserLogin(const char *userID);

  const char *getUserName(const char *userID);

  const char *getUserDICOMName(const char *userID);

  const char *getUserOrganization(const char *userID);

  const char *getUserCodingSchemeDesignator(const char *userID, OFString& value);

  const char *getUserCodingSchemeVersion(const char *userID, OFString& value);

  const char *getUserCodeValue(const char *userID, OFString& value);

  const char *getUserCodeMeaning(const char *userID, OFString& value);

  const char *getUserCertificate(const char *userID);

  const char *getUserPrivateKey(const char *userID);
  
  /* Other settings */
  
  virtual void setLog(OFConsole *stream, OFBool verbMode, OFBool dbgMode);

protected:

  OFConsole *logstream;
  
  OFBool verboseMode;
   
  OFBool debugMode;

private:

  DVConfiguration(const DVConfiguration&);

  DVConfiguration& operator=(const DVConfiguration&);

  const char *getConfigEntry(const char *l2_key, const char *l1_key, const char *l0_key);

  OFBool getConfigBoolEntry(const char *l2_key, const char *l1_key, const char *l0_key, OFBool deflt);

  /* member variables */

  OFConfigFile *pConfig;

};

#endif

/*
 *  CVS/RCS Log:
 *  $Log: dvpscf.h,v $
 *  Revision 1.32  2005/12/08 16:03:36  meichel
 *  Changed include path schema for all DCMTK header files
 *
 *  Revision 1.31  2003/04/29 10:13:56  meichel
 *  Moved configuration file parser from module dcmpstat to ofstd and renamed
 *    class to OFConfigFile. Cleaned up implementation (no more friend declarations).
 *
 *  Revision 1.30  2002/11/29 13:16:31  meichel
 *  Introduced new command line option --timeout for controlling the
 *    connection request timeout.
 *
 *  Revision 1.29  2002/11/25 18:27:39  meichel
 *  Converted compile time option to leniently handle space padded UIDs
 *    in the Storage Service Class into command line / config file option.
 *
 *  Revision 1.28  2001/06/01 15:50:12  meichel
 *  Updated copyright header
 *
 *  Revision 1.27  2000/11/13 14:20:54  joergr
 *  Updated comments.
 *
 *  Revision 1.26  2000/11/13 11:52:41  meichel
 *  Added support for user logins and certificates.
 *
 *  Revision 1.25  2000/11/13 10:42:39  joergr
 *  Added support for Structured Reporting "templates".
 *
 *  Revision 1.24  2000/10/10 12:23:40  meichel
 *  Added extensions for TLS encrypted communication
 *
 *  Revision 1.23  2000/06/21 15:40:57  meichel
 *  Added DICOMscope support for calling the Presentation State Checker.
 *
 *  Revision 1.22  2000/06/07 14:16:21  joergr
 *  Added configuration file entry "LogLevel" to filter log messages.
 *
 *  Revision 1.21  2000/06/07 13:17:45  meichel
 *  added binary and textual log facilities to Print SCP.
 *
 *  Revision 1.20  2000/06/06 09:42:48  joergr
 *  Moved configuration file entry "LogDirectory" from "[PRINT]" to new
 *  (more general) section "[APPLICATION]".
 *
 *  Revision 1.19  2000/06/05 16:22:27  joergr
 *  Implemented log message methods.
 *
 *  Revision 1.18  2000/06/02 16:00:43  meichel
 *  Adapted all dcmpstat classes to use OFConsole for log and error output
 *
 *  Revision 1.17  2000/06/02 13:53:54  joergr
 *  Implemented start/terminatePrintServer methods.
 *
 *  Revision 1.16  2000/06/02 12:41:51  joergr
 *  Corrected wrong interface descriptions.
 *
 *  Revision 1.15  2000/05/31 12:56:37  meichel
 *  Added initial Print SCP support
 *
 *  Revision 1.14  2000/05/30 13:40:02  joergr
 *  Removed methods which were already marked as "retired".
 *  Added new section to the config file describing the query/retrieve server
 *  settings.
 *
 *  Revision 1.13  2000/03/08 16:28:49  meichel
 *  Updated copyright header.
 *
 *  Revision 1.12  1999/11/03 13:05:32  meichel
 *  Added support for transmitting annotations in the film session label.
 *    Added support for dump tool launched from DVInterface.
 *
 *  Revision 1.11  1999/10/20 10:47:14  joergr
 *  Added support for a down-scaled preview image of the current DICOM image
 *  (e.g. useful for online-windowing or print preview).
 *
 *  Revision 1.10  1999/10/19 14:46:02  meichel
 *  added support for the Basic Annotation Box SOP Class
 *    as well as access methods for Max Density and Min Density.
 *
 *  Revision 1.9  1999/10/13 14:11:56  meichel
 *  Added config file entries and access methods
 *    for user-defined VOI presets, log directory, verbatim logging
 *    and an explicit list of image display formats for each printer.
 *
 *  Revision 1.8  1999/10/07 17:21:46  meichel
 *  Reworked management of Presentation LUTs in order to create tighter
 *    coupling between Softcopy and Print.
 *
 *  Revision 1.7  1999/10/01 13:32:36  joergr
 *  Added new option to config file: AlwaysDeleteTerminateJobs.
 *
 *  Revision 1.6  1999/09/24 15:24:29  meichel
 *  Added support for CP 173 (Presentation LUT clarifications)
 *
 *  Revision 1.5  1999/09/23 17:37:13  meichel
 *  Added support for Basic Film Session options to dcmpstat print code.
 *
 *  Revision 1.4  1999/09/15 17:43:26  meichel
 *  Implemented print job dispatcher code for dcmpstat, adapted dcmprtsv
 *    and dcmpsprt applications.
 *
 *  Revision 1.3  1999/09/13 15:19:09  meichel
 *  Added implementations for a number of further print API methods.
 *
 *  Revision 1.2  1999/09/10 12:46:45  meichel
 *  Added implementations for a number of print API methods.
 *
 *  Revision 1.1  1999/09/08 16:42:02  meichel
 *  Moved configuration file evaluation to separate class.
 *
 *
 */

---

Generated on 20 Dec 2005 for OFFIS DCMTK Version 3.5.4 by Doxygen 1.4.5