DVInterface Class Reference

Interface class for the Softcopy Presentation State viewer. More...

Inheritance diagram for DVInterface:

DVConfiguration List of all members.

Public Member Functions

 DVInterface (const char *config_file=NULL, OFBool useLog=OFFalse)
 constructor.
virtual ~DVInterface ()
 destructor.
OFCondition loadImage (const char *studyUID, const char *seriesUID, const char *instanceUID, OFBool changeStatus=OFFalse)
 loads an image which is contained in the database and creates a default presentation state for the image.
OFCondition loadImage (const char *filename)
 loads an image (which need not be contained in the database) and creates a default presentation state for the image.
OFCondition loadReferencedImage (size_t idx, OFBool changeStatus=OFFalse)
 loads an image which referenced by the current presentation state and needs to be contained in the database.
OFCondition loadPState (const char *studyUID, const char *seriesUID, const char *instanceUID, OFBool changeStatus=OFFalse)
 loads a presentation state which is contained in the database.
OFCondition loadPState (const char *pstName, const char *imgName=NULL)
 loads a presentation state and an image (which need not be contained in the database) and attaches the image to the presentation state (if specified, otherwise the current image will be used).
OFCondition loadStructuredReport (const char *studyUID, const char *seriesUID, const char *instanceUID, OFBool changeStatus=OFFalse)
 loads a structured report which is contained in the database.
OFCondition loadStructuredReport (const char *filename)
 loads a structured report (which need not be contained in the database).
OFCondition loadSRTemplate (const char *reportID)
 loads a structured reporting "template".
OFCondition savePState (OFBool replaceSOPInstanceUID)
 saves the current presentation state in the same directory in which the database index file resides.
OFCondition savePState (const char *filename, OFBool replaceSOPInstanceUID, OFBool explicitVR=OFTrue)
 saves the current presentation state in a file with the given path and filename.
OFCondition saveCurrentImage (const char *filename, OFBool explicitVR=OFTrue)
 saves the DICOM image that is currently attached to the presentation state in a file with the given path and filename.
OFCondition saveStructuredReport ()
 saves the current structured report in the same directory in which the database index file resides.
OFCondition saveStructuredReport (const char *filename, OFBool explicitVR=OFTrue)
 saves the current structured report in a file with the given path and filename.
OFCondition addImageReferenceToPState (const char *studyUID, const char *seriesUID, const char *instanceUID)
 adds an image which is contained in the database to the list of referenced images of the current presentation state.
size_t getNumberOfImageReferences ()
 gets the number of image references contained in the current presentation state.
DVPresentationStategetCurrentPState ()
 returns a reference to the current presentation state.
DSRDocumentgetCurrentReport ()
 returns a reference to the current structured report.
DVPSStoredPrintgetPrintHandler ()
 returns a reference to the print handler.
OFCondition resetPresentationState ()
 resets the presentation state object to the status it had immediately after the last successful operation of "loadImage" or "loadPState".
OFCondition saveCurrentPStateForReset ()
 saves the current state of the presentation state object to be used for resetPresentationState().
OFCondition releaseDatabase ()
 removes any shared or exclusive lock on the database.
const char * getFilename (const char *studyUID, const char *seriesUID, const char *instanceUID)
 searches in the database for a DICOM instance with the given study, series and instance UIDs and returns its pathname if found.
Uint32 getNumberOfStudies ()
 returns the number of studies currently contained in the database.
OFCondition selectStudy (Uint32 idx)
 selects the study with the given index in the database.
OFCondition selectStudy (const char *studyUID)
 selects the study with the given UID in the database.
DVIFhierarchyStatus getStudyStatus ()
 returns the review status of the currently selected study.
const char * getStudyUID ()
 returns the Study Instance UID of the currently selected study.
const char * getStudyDescription ()
 returns the Study Description of the currently selected study.
const char * getStudyDate ()
 returns the Study Date of the currently selected study.
const char * getStudyTime ()
 returns the Study Time of the currently selected study.
const char * getReferringPhysiciansName ()
 returns the Referring Physicians Name of the currently selected study.
const char * getAccessionNumber ()
 returns the Accession Number of the currently selected study.
const char * getNameOfPhysiciansReadingStudy ()
 returns the Name Of Physicians Reading Study of the currently selected study.
const char * getPatientName ()
 returns the Patient Name of the currently selected study.
const char * getPatientID ()
 returns the Patient ID of the currently selected study.
const char * getPatientBirthDate ()
 returns the Patient Birth Date of the currently selected study.
const char * getPatientSex ()
 returns the Patient Sex of the currently selected study.
const char * getPatientBirthTime ()
 returns the Patient Birth Time of the currently selected study.
const char * getOtherPatientNames ()
 returns the Other Patient Names of the currently selected study.
const char * getOtherPatientID ()
 returns the Other Patient ID of the currently selected study.
const char * getEthnicGroup ()
 returns the Patient Ethnic Group of the currently selected study.
Uint32 getNumberOfSeries ()
 returns the number of series within the currently selected study.
OFCondition selectSeries (Uint32 idx)
 selects the series with the given index within the currently selected study.
OFCondition selectSeries (const char *seriesUID)
 selects the series with the given UID within the currently selected study.
const char * getSeriesUID ()
 returns the Series Instance UID of the currently selected series.
DVIFhierarchyStatus getSeriesStatus ()
 returns the review status of the currently selected series.
DVPSInstanceType getSeriesType ()
 returns the type of all instances within the currently selected series.
DVPSInstanceType getInstanceType ()
 returns the type of the currently selected instance.
const char * getSeriesNumber ()
 returns the Series Number of the currently selected series.
const char * getSeriesDate ()
 returns the Series Date of the currently selected series.
const char * getSeriesTime ()
 returns the Series Time of the currently selected series.
const char * getSeriesDescription ()
 returns the Series Description of the currently selected series.
const char * getSeriesPerformingPhysiciansName ()
 returns the Series Performing Physicians Name of the currently selected series.
const char * getSeriesProtocolName ()
 returns the Series Protocol Name of the currently selected series.
const char * getSeriesOperatorsName ()
 returns the Series Operators Name of the currently selected series.
const char * getModality ()
 returns the Modality of the currently selected series.
Uint32 getNumberOfInstances ()
 returns the number of instances (IODs) within the currently selected series.
OFCondition selectInstance (Uint32 idx)
 selects the instance with the given index within the currently selected series.
OFCondition selectInstance (const char *instanceUID)
 selects the instance with the given UID within the currently selected series.
OFCondition selectInstance (const char *instanceUID, const char *sopClassUID)
 selects the instance with the given UID and SOP class over all studies and series.
OFCondition selectInstance (const char *studyUID, const char *seriesUID, const char *instanceUID)
 selects the instance with the given UIDs.
const char * getSOPClassUID ()
 returns the SOP class UID of the currently selected instance.
const char * getInstanceUID ()
 returns the SOP Instance UID of the currently selected instance.
const char * getImageNumber ()
 returns the Image Number of the currently selected instance.
const char * getFilename ()
 returns the Filename of the currently selected instance.
DVIFhierarchyStatus getInstanceStatus ()
 returns the review status of the currently selected instance.
const char * getInstanceDescription ()
 returns the escription of the currently selected instance.
const char * getPresentationLabel ()
 returns the Presentation Label of the currently selected instance.
OFCondition instanceReviewed (const char *studyUID, const char *seriesUID, const char *instanceUID)
 modifies the review flag for one instance in the database, which is set to 'reviewed' state (DVIF_objectIsNotNew).
OFCondition deleteInstance (const char *studyUID, const char *seriesUID, const char *instanceUID)
 deletes the given instance from the database.
OFCondition deleteSeries (const char *studyUID, const char *seriesUID)
 deletes the given series from the database.
OFCondition deleteStudy (const char *studyUID)
 deletes the given study from the database.
OFCondition startReceiver ()
 starts the network receiver processes (Storage Service Class SCPs).
OFCondition terminateReceiver ()
 terminates the network receiver process (Storage Service Class SCP).
OFCondition startQueryRetrieveServer ()
 starts the query/retrieve server process (Query/Retrieve Service Class SCP).
OFCondition terminateQueryRetrieveServer ()
 terminates the query/retrieve server process (Query/Retrieve Service Class SCP).
OFBool newInstancesReceived ()
 tests whether the database has been modified in any way since the last call to this method.
OFCondition sendStudy (const char *targetID, const char *studyUID)
 sends a complete study over network to a different DICOM peer.
OFCondition sendSeries (const char *targetID, const char *studyUID, const char *seriesUID)
 sends a complete series over network to a different DICOM peer.
OFCondition sendIOD (const char *targetID, const char *studyUID, const char *seriesUID, const char *instanceUID)
 sends a single instance (image or presentation state) over network to a different DICOM peer.
OFCondition dumpIOD (const char *filename)
 creates a dump of the contents of a DICOM file and displays it on-screen.
OFCondition dumpIOD (const char *studyUID, const char *seriesUID, const char *instanceUID)
 creates a dump of the contents of a DICOM file and displays it on-screen.
OFCondition checkIOD (const char *filename)
 checks the contents of a DICOM file and displays an evaluation report on the screen.
OFCondition checkIOD (const char *studyUID, const char *seriesUID, const char *instanceUID)
 checks the contents of a DICOM file and displays an evaluation report on the screen.
OFCondition saveDICOMImage (const char *filename, const void *pixelData, unsigned long width, unsigned long height, double aspectRatio=1.0, OFBool explicitVR=OFTrue, const char *instanceUID=NULL)
 saves a monochrome bitmap as a DICOM Secondary Capture image.
OFCondition saveDICOMImage (const void *pixelData, unsigned long width, unsigned long height, double aspectRatio=1.0)
 saves a monochrome bitmap as a DICOM Secondary Capture image in the same directory in which the database index file resides.
OFCondition saveHardcopyGrayscaleImage (const char *filename, const void *pixelData, unsigned long width, unsigned long height, double aspectRatio=1.0, OFBool explicitVR=OFTrue, const char *instanceUID=NULL)
 saves a monochrome bitmap as a DICOM Hardcopy Grayscale image.
OFCondition saveHardcopyGrayscaleImage (const void *pixelData, unsigned long width, unsigned long height, double aspectRatio=1.0)
 saves a monochrome bitmap as a DICOM Hardcopy Grayscale image in the same directory in which the database index file resides.
OFCondition saveFileFormatToDB (DcmFileFormat &fileformat)
 saves a DICOM object into a file in the same directory in which the database index file resides.
OFCondition loadStoredPrint (const char *studyUID, const char *seriesUID, const char *instanceUID, OFBool changeStatus=OFFalse)
 loads a Stored Print object which is contained in the database into memory.
OFCondition loadStoredPrint (const char *filename)
 loads a Stored Print object (which need not be contained in the database) into memory.
OFCondition saveStoredPrint (const char *filename, OFBool writeRequestedImageSize, OFBool explicitVR=OFTrue, const char *instanceUID=NULL)
 saves the current print job as a Stored Print object.
OFCondition saveStoredPrint (OFBool writeRequestedImageSize)
 saves the current print job as a Stored Print object in the same directory in which the database index file resides.
size_t getNumberOfPrintPreviews ()
 gets the number of Hardcopy Grayscaleimages currently registered by the stored print object.
OFCondition loadPrintPreview (size_t idx, OFBool printLUT=OFTrue, OFBool changeStatus=OFFalse)
 loads a Hardcopy Grayscale image registered by the stored print object and creates a preview.
void unloadPrintPreview ()
 removes a currently loaded Hardcopy Grayscale image from memory.
unsigned long getPrintPreviewSize ()
 gets number of bytes used for the print preview bitmap.
void setMaxPrintPreviewWidthHeight (unsigned long width, unsigned long height)
 sets the maximum print preview bitmap width and height.
OFCondition getPrintPreviewWidthHeight (unsigned long &width, unsigned long &height)
 gets width and height of print preview bitmap.
OFCondition getPrintPreviewBitmap (void *bitmap, unsigned long size)
 writes the bitmap data of the print preview image into the given buffer.
OFCondition disablePState ()
 stores the current presentation state in a temporary place and creates a new presentation state that corresponds with an image displayed "without" presentation state.
OFCondition enablePState ()
 restores the stored presentation state (see disablePresentationState) and deletes the temporary presentation state.
Uint32 getNumberOfPStates ()
 returns number of presentation states referencing the currently selected image.
OFCondition selectPState (Uint32 idx, OFBool changeStatus=OFFalse)
 selects and loads specified presentation state referencing the currently selected image.
const char * getPStateDescription (Uint32 idx)
 returns description of specified presentation state referencing the currently selected image.
const char * getPStateLabel (Uint32 idx)
 returns label of specified presentation state referencing the currently selected image.
OFBool isDisplayTransformPossible (DVPSDisplayTransform transform=DVPSD_GSDF)
 checks whether display correction is possible (in principle), i.e.
OFCondition setAmbientLightValue (double value)
 sets ambient light value for the display transformation.
OFCondition getAmbientLightValue (double &value)
 returns ambient light value for the display transformation.
OFCondition setCurrentPrinter (const char *targetID)
 selects the current printer.
const char * getCurrentPrinter ()
 gets the current printer's target ID.
OFCondition setPrinterMediumType (const char *value)
 sets the (optional) print medium type.
const char * getPrinterMediumType ()
 gets the (optional) print medium type.
OFCondition setPrinterFilmDestination (const char *value)
 sets the (optional) printer film destination.
const char * getPrinterFilmDestination ()
 gets the (optional) printer film destination.
OFCondition setPrinterFilmSessionLabel (const char *value)
 sets the (optional) printer film session label.
const char * getPrinterFilmSessionLabel ()
 gets the (optional) printer film session label.
OFCondition setPrinterPriority (const char *value)
 sets the (optional) print priority.
const char * getPrinterPriority ()
 gets the (optional) print priority.
OFCondition setPrinterOwnerID (const char *value)
 sets the (optional) print session owner ID.
const char * getPrinterOwnerID ()
 gets the (optional) print session owner ID.
OFCondition setPrinterNumberOfCopies (unsigned long value)
 sets the (optional) print number of copies.
unsigned long getPrinterNumberOfCopies ()
 gets the (optional) print number of copies.
void clearFilmSessionSettings ()
 resets the settings for basic film session (everything that is not managed by the Stored Print object) to initial state.
OFCondition selectDisplayPresentationLUT (const char *lutID)
 sets the LUT with the given identifier in the Presentation State as current Presentation LUT.
const char * getDisplayPresentationLUTID ()
 if the Presentation State contains an active Presentation LUT that was set with selectDisplayPresentationLUT(), return the corresponding LUT identifier.
OFCondition selectPrintPresentationLUT (const char *lutID)
 sets the LUT with the given identifier in the Stored Print object as current Presentation LUT.
const char * getPrintPresentationLUTID ()
 if the Stored Print object contains an active Presentation LUT that was set with selectPrintPresentationLUT(), return the corresponding LUT identifier.
OFCondition spoolPrintJob (OFBool deletePrintedImages=OFTrue)
 start spooling of print job with current settings.
OFCondition startPrintSpooler ()
 starts the print spooler process.
OFCondition terminatePrintSpooler ()
 terminates the print spooler process.
OFCondition startPrintServer ()
 starts the print server process (Basic Grayscale Print Management SCP).
OFCondition terminatePrintServer ()
 terminates the print server process (Basic Grayscale Print Management SCP).
OFCondition addToPrintHardcopyFromDB (const char *studyUID, const char *seriesUID, const char *instanceUID)
 adds an existing DICOM image (should be Hardcopy Grayscale) that is already present in the image database to the current print image queue without rendering it again.
OFCondition spoolStoredPrintFromDB (const char *studyUID, const char *seriesUID, const char *instanceUID)
 requests the spooler process to print an old print job that is stored in the database as a "stored print" object.
OFCondition printSCUcreateBasicFilmSession (DVPSPrintMessageHandler &printHandler, OFBool plutInSession)
 Initiates the creation of a DICOM Basic Film Session SOP Instance in the printer.
OFBool isActiveAnnotation ()
 gets the current setting of the annotation activity annotation flag.
OFBool getPrependDateTime ()
 gets the current setting of the Prepend Date/Time annotation flag.
OFBool getPrependPrinterName ()
 gets the current setting of the Prepend Printer Name annotation flag.
OFBool getPrependLighting ()
 gets the current setting of the Prepend Lighting annotation flag.
const char * getAnnotationText ()
 gets the current annotation text.
void setActiveAnnotation (OFBool value)
 switches annotation printing on/off
void setPrependDateTime (OFBool value)
 sets the Prepend Date/Time annotation flag.
void setPrependPrinterName (OFBool value)
 sets the Prepend Printer Name annotation flag.
void setPrependLighting (OFBool value)
 sets the Prepend Lighting annotation flag.
void setAnnotationText (const char *value)
 sets the current annotation text.
OFBool verifyUserPassword (const char *userID, const char *passwd)
 verifies the given password for the given user ID.
OFCondition verifyAndSignStructuredReport (const char *userID, const char *passwd, DVPSVerifyAndSignMode mode)
 verifies and digitally signs the current structured report.
virtual void setLog (OFConsole *stream, OFBool verbMode, OFBool dbgMode)
 sets a new log stream
void setLogFilter (DVPSLogMessageLevel level)
 sets a filter to specify which messages are actually written to the application wide log file.
OFCondition writeLogMessage (DVPSLogMessageLevel level, const char *module, const char *message)
 writes a message into the application wide log file.
const char * getCurrentSignatureValidationHTML (DVPSObjectType objtype) const
 returns a string containing a complete HTML page with the signature validation results for the last object of the given type.
const char * getCurrentSignatureValidationOverview () const
 returns a string containing a complete HTML page with the signature validation overview.
DVPSSignatureStatus getCurrentSignatureStatus (DVPSObjectType objtype) const
 returns the status flag for the current object of given type.
DVPSSignatureStatus getCombinedImagePStateSignatureStatus () const
 returns the combined status flag for the current image and presentation state.
unsigned long getNumberOfCorrectSignatures (DVPSObjectType objtype) const
 returns number of correct signatures for given object type.
unsigned long getNumberOfUntrustworthySignatures (DVPSObjectType objtype) const
 returns number of untrustworthy signatures for given object type.
unsigned long getNumberOfCorruptSignatures (DVPSObjectType objtype) const
 returns number of corrupt signatures for given object type.
void disableImageAndPState ()
 disables internal settings for image and presentation state.

Private Member Functions

 DVInterface (const DVInterface &)
 private undefined copy constructor
DVInterfaceoperator= (const DVInterface &)
 private undefined assignment operator
OFCondition exchangeImageAndPState (DVPresentationState *newState, DcmFileFormat *image, DcmFileFormat *state=NULL)
 helper function that exchanges the current presentation state and image by the pointers passed and frees the old ones.
OFCondition lockDatabase ()
 creates a database handle if none exists yet (this method may be called multiple times without interference) and puts a shared lock on the database.
OFCondition lockExclusive ()
 creates an exlusive lock on the database if none exists.
OFCondition unlockExclusive ()
 removes an exlusive lock on the database if any.
OFCondition createPrintJobFilenames (const char *printer, OFString &tempname, OFString &jobname)
 creates a new pair of filenames for print job creation.
OFCondition createQueryRetrieveServerConfigFile (const char *filename)
 creates the query/retrieve server configuration file.
OFCondition startExternalApplication (const char *application, const char *filename)
 starts an external application and passes a filename.
OFBool createIndexCache ()
 creates index cache to optimize reading of index file
OFBool createPStateCache ()
 creates cache of referencing pstates for the current image
void clearIndexCache ()
 clears index cache (includes pstate cache)
void clearIndexRecord (IdxRecord &record, int &recpos)
 clears specified index record (and makes pos invalid)
OFBool readIndexRecord (const int pos, IdxRecord &record, int *oldpos=NULL)
 reads specified index record (comparing pos with oldpos to avoid redundant loading)
void updateStatusCache ()
 updates (hierarchical) status cache (propagates status information from instances to series and from series to studies)
DVStudyCache::ItemStructgetStudyStruct (const char *studyUID=NULL, const char *seriesUID=NULL)
 returns pointer to study struct specified by given UIDs or to current study
DVSeriesCache::ItemStructgetSeriesStruct (const char *studyUID=NULL, const char *seriesUID=NULL, const char *instanceUID=NULL)
 returns pointer to series struct specified by given UIDs or to current series
DVInstanceCache::ItemStructgetInstanceStruct (const char *studyUID=NULL, const char *seriesUID=NULL, const char *instanceUID=NULL)
 returns pointer to instance struct specified by given UIDs or to current instance
int findStudyIdx (StudyDescRecord *study, const char *uid)
 returns index of specified study within study description record
int deleteImageFile (const char *filename)
 conditionally deletes given image file (only if file resides in index.dat directory)
void resetDatabaseReferenceTime ()
 resets index file modification time to reference time (yesterday)
OFCondition instanceReviewed (int pos)
 modifies the review flag for one instance in the database (see method with three UID parameters)

Private Attributes

DVPSStoredPrintpPrint
 pointer to the current print handler object
DVPresentationStatepState
 pointer to the current presentation state object
DSRDocumentpReport
 pointer to the current structured reporting object (should never be NULL)
DVSignatureHandlerpSignatureHandler
 pointer to the handler object for digital signatures
DVPresentationStatepStoredPState
 pointer to the stored presentation state object (if any)
DcmFileFormatpDicomImage
 pointer to the current DICOM image attached to the presentation state
DcmFileFormatpDicomPState
 pointer to the current DICOM dataset containing the loaded presentation state.
DicomImagepHardcopyImage
 pointer to the current hardcopy grayscale image (bitmap information only)
OFString printJobIdentifier
 a unique string generated for each instance of this class.
unsigned long printJobCounter
 a counter used for generating print job names.
OFString configPath
 string containing the path name of the config file as passed to the ctor.
OFString databaseIndexFile
 string containing the path name of the database index file after a database lock has been acquired for the first time
unsigned long referenceTime
 initialized with construction time of the interface object minus one day.
DiDisplayFunctiondisplayFunction [DVPSD_max]
 list of display function object
DcmQueryRetrieveIndexDatabaseHandlepHandle
 handle to access database/index file
OFBool lockingMode
 locking mode (OFFalse => shared, OFTrue => exclusive)
DVStudyCache idxCache
 hierarchical cache structure to optimize index file access
IdxRecord idxRec
 record structure of index items (last read entry)
int idxRecPos
 position of last read index record (for optimization purposes)
OFBool imageInDatabase
 OFTrue if current image is already stored in database, OFFalse otherwise.
unsigned long minimumPrintBitmapWidth
 minimum width of print bitmap (used for implicit scaling)
unsigned long minimumPrintBitmapHeight
 minimum height of print bitmap (used for implicit scaling)
unsigned long maximumPrintBitmapWidth
 maximum width of print bitmap (used for implicit scaling)
unsigned long maximumPrintBitmapHeight
 maximum height of print bitmap (used for implicit scaling)
unsigned long maximumPrintPreviewWidth
 maximum width of print preview bitmap
unsigned long maximumPrintPreviewHeight
 maximum height of print preview bitmap
unsigned long maximumPreviewImageWidth
 maximum width of (optional) preview image
unsigned long maximumPreviewImageHeight
 maximum height of (optional) preview image
OFString currentPrinter
 target ID of current printer, empty if no printer exists in config file
OFString displayCurrentLUTID
 config file identifier of LUT currently selected as Display Presentation LUT
OFString printCurrentLUTID
 config file identifier of LUT currently selected as Print Presentation LUT
OFString printerMediumType
 printer medium type identifier, may be empty.
OFString printerFilmDestination
 printer film destination identifier, may be empty.
OFString printerFilmSessionLabel
 printer film session label, may be empty.
unsigned long printerNumberOfCopies
 printer number of copies
OFString printerPriority
 printer print priority, may be empty.
OFString printerOwnerID
 printer film session owner ID, may be empty.
OFBool activateAnnotation
 true if annotation should be created when spooling print job
OFBool prependDateTime
 true if date and time should be prepended to annotation text
OFBool prependPrinterName
 true if printer name should be prepended to annotation text
OFBool prependLighting
 true if reflected ambient light and illumination should be prepended to annotation text
OFString annotationText
 annotation text (if any)
OFLogFilelogFile
 general application log file

Detailed Description

Interface class for the Softcopy Presentation State viewer.

This class manages the database facilities, allows to start and stop network transactions and gives access to images and presentation states.

Definition at line 62 of file dviface.h.


Constructor & Destructor Documentation

DVInterface::DVInterface const char *  config_file = NULL,
OFBool  useLog = OFFalse
 

constructor.

Parameters:
config_file filename (path) of the config file to be used by the interface object. The caller should make sure that the config file really exists because the constructor cannot return an error status. If a non-existing filename (or NULL) is passed, an empty configuration file is assumed.
useLog (optional) flag specifying whether a general log file should be used (config entry GENERAL).


Member Function Documentation

OFCondition DVInterface::addImageReferenceToPState const char *  studyUID,
const char *  seriesUID,
const char *  instanceUID
 

adds an image which is contained in the database to the list of referenced images of the current presentation state.

This method acquires a database lock which must be explicitly freed by the user.

Parameters:
studyUID study instance UID of the image
seriesUID series instance UID of the image
instanceUID SOP instance UID of the image
Returns:
EC_Normal upon success, an error code otherwise.

OFCondition DVInterface::addToPrintHardcopyFromDB const char *  studyUID,
const char *  seriesUID,
const char *  instanceUID
 

adds an existing DICOM image (should be Hardcopy Grayscale) that is already present in the image database to the current print image queue without rendering it again.

The "requested image size" option is not used - the bitmap is treated as if the presentation mode was "SCALE TO FIT".

Parameters:
studyUID study instance UID of the image, as reported by getStudyUID()
seriesUID series instance UID of the image, as reported by getSeriesUID()
instanceUID SOP instance UID of the image, as reported by getInstanceUID()
Returns:
EC_Normal upon success, an error code otherwise.

OFCondition DVInterface::checkIOD const char *  studyUID,
const char *  seriesUID,
const char *  instanceUID
 

checks the contents of a DICOM file and displays an evaluation report on the screen.

A separate application or process is launched to handle the evaluation and display. This call returns when the check operation has successfully been launched. No information about the status or success of the process itself is being made available. This method acquires a database lock which must be explicitly freed by the user.

Parameters:
studyUID Study Instance UID of the IOD to be checked. Must be an IOD contained in the database.
seriesUID Series Instance UID of the IOD to be checked. Must be an IOD contained in the database.
instanceUID SOP Instance UID of the IOD to be checked. Must be an IOD contained in the database.
Returns:
EC_Normal when the process has successfully been launched, an error condition otherwise.

OFCondition DVInterface::checkIOD const char *  filename  ) 
 

checks the contents of a DICOM file and displays an evaluation report on the screen.

A separate application or process is launched to handle the evaluation and display. This call returns when the check operation has successfully been launched. No information about the status or success of the process itself is being made available. This method does not acquire a database lock.

Parameters:
filename path of file to be checked.
Returns:
EC_Normal when the process has successfully been launched, an error condition otherwise.

void DVInterface::clearFilmSessionSettings  ) 
 

resets the settings for basic film session (everything that is not managed by the Stored Print object) to initial state.

Affects medium type, film destination, film session label, priority, owner ID, and number of copies.

OFCondition DVInterface::createPrintJobFilenames const char *  printer,
OFString tempname,
OFString jobname
[private]
 

creates a new pair of filenames for print job creat