/usr/include/dcmtk/dcmpstat/dvpshlp.h is in libdcmtk-dev 3.6.2-3build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 | /*
*
* Copyright (C) 1998-2012, 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, Joerg Riesmeier
*
* Purpose:
* classes: DVPSHelper
*
*/
#ifndef DVPSHLP_H
#define DVPSHLP_H
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/dcmpstat/dpdefine.h"
#include "dcmtk/dcmdata/dcsequen.h"
class DcmFileFormat;
/** this class contains a collection of static helper methods.
*/
class DCMTK_DCMPSTAT_EXPORT DVPSHelper
{
public:
/** helper function which loads a DICOM file and returns a
* pointer to a DcmFileFormat object if loading succeeds.
* @param filename name of DICOM file to be loaded
* @param fileformat pointer to DcmFileFormat object passed back here
* @return EC_Normal upon success, an error code otherwise.
*/
static OFCondition loadFileFormat(const char *filename, DcmFileFormat *&fileformat);
/** helper function which saves a DICOM object to file.
* @param filename name of DICOM file to be created
* @param fileformat DICOM object to be saved
* @param explicitVR selects the transfer syntax to be written.
* True selects Explicit VR Little Endian, False selects Implicit VR Little Endian.
* @return EC_Normal upon success, an error code otherwise.
*/
static OFCondition saveFileFormat(const char *filename,
DcmFileFormat *fileformat,
OFBool explicitVR);
/** helper function that inserts a new element into a DICOM dataset.
* A new DICOM element of the type determined by the tag is created.
* The string value (if any) is assigned and the element is inserted
* into the dataset. Only tags corresponding to string VRs may be passed.
* @param item the dataset into which the new element is inserted
* @param tag the tag key of the new DICOM element, must have string VR.
* @param value the value to be inserted. If omitted, an empty element is created.
* @return EC_Normal upon success, an error code otherwise.
*/
static OFCondition putStringValue(DcmItem *item, DcmTagKey tag, const char *value=NULL);
/** helper function that inserts a new element into a DICOM dataset.
* A new DICOM element of type "US" is created, the value is assigned
* and the element is inserted into the dataset.
* @param item the dataset into which the new element is inserted
* @param tag the tag key of the new DICOM element, must have "US" VR.
* @param value the value to be inserted.
* @return EC_Normal upon success, an error code otherwise.
*/
static OFCondition putUint16Value(DcmItem *item, DcmTagKey tag, Uint16 value);
/** helper function that cleans up pending processes under Unix.
* No function if used on Windows.
*/
static void cleanChildren();
/** helper function that writes the current date in DICOM format (YYYYMMDD)
* @param str current date is written to this string
*/
static void currentDate(OFString &str);
/** helper function that writes the current time in DICOM format (HHMMSS)
* @param str current time is written to this string
*/
static void currentTime(OFString &str);
/** assigns the given value to the given DICOM element if it is empty
* and the status is OK, returns new status.
* @param result status in/out
* @param a_name DICOM element to be set
* @param a_value new value, must not be NULL.
*/
static void setDefault(OFCondition& result, DcmElement& a_name, const char *a_value);
/** static helper method that checks whether the given sequence contains an
* item with a ReferencedSOPClassUID element that matches the given UID string.
* @param seq sequence to be searched, should be a PrintManagementCapabilitiesSequence.
* @param uid UID string
* @return OFTrue if found, OFFalse otherwise. Returns OFFalse if uid is NULL.
*/
static OFBool haveReferencedUIDItem(DcmSequenceOfItems& seq, const char *uid);
/** static helper method that adds an item to the given sequence. The item
* contains a ReferencedSOPClassUID element with the given UID string as value.
* @param seq sequence to be added to, should be a PrintManagementCapabilitiesSequence.
* @param uid UID string, must not be NULL
* @return EC_Normal if successful, an error code otherwise.
*/
static OFCondition addReferencedUIDItem(DcmSequenceOfItems& seq, const char *uid);
};
#endif
|