/usr/include/dcmtk/dcmfg/fgplanor.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 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | /*
*
* Copyright (C) 2015-2016, Open Connections GmbH
* All rights reserved. See COPYRIGHT file for details.
*
* This software and supporting documentation are maintained by
*
* OFFIS e.V.
* R&D Division Health
* Escherweg 2
* D-26121 Oldenburg, Germany
*
*
* Module: dcmfg
*
* Author: Michael Onken
*
* Purpose: Class for managing Plane Orientation (Patient) Functional Group
*
*/
#ifndef FGPLANOR_H
#define FGPLANOR_H
#include "dcmtk/config/osconfig.h"
#include "dcmtk/dcmfg/fgbase.h"
#include "dcmtk/dcmdata/dcsequen.h"
#include "dcmtk/dcmdata/dcvrds.h"
/** Class representing the Plane Orientation (Patient) Functional Group Macro.
* It specifies the direction cosines of the first row and the first column
* with respect to the patient.
*/
class DCMTK_DCMFG_EXPORT FGPlaneOrientationPatient : public FGBase
{
public:
/** Constructor, creates empty functional group
*/
FGPlaneOrientationPatient();
/** Destructor, frees memory
*/
virtual ~FGPlaneOrientationPatient();
/** Returns a deep copy of this object
* @return Deep copy of this object
*/
virtual FGBase *clone() const;
/** Convenience function to create a minimal functional group.
* @param imageOrientationPatientRowX Row X Value
* @param imageOrientationPatientRowY Row Y Value
* @param imageOrientationPatientRowZ Row Z Value
* @param imageOrientationPatientColX Column X Value
* @param imageOrientationPatientColY Column Y Value
* @param imageOrientationPatientColZ Column Z Value
* @return The functional group created with above parameters
*/
static FGPlaneOrientationPatient* createMinimal(const OFString& imageOrientationPatientRowX,
const OFString& imageOrientationPatientRowY,
const OFString& imageOrientationPatientRowZ,
const OFString& imageOrientationPatientColX,
const OFString& imageOrientationPatientColY,
const OFString& imageOrientationPatientColZ);
/** Get shared type of this functional group (can be both, shared and
* per-frame)
* @return Always returns DcmFGTypes::EFGS_BOTH
*/
virtual DcmFGTypes::E_FGSharedType getSharedType() const {return DcmFGTypes::EFGS_BOTH;}
/** Clears all data
*/
virtual void clearData();
/** Check whether this group contains valid data
* @return EC_Normal if data is valid, error otherwise
*/
virtual OFCondition check() const;
/** Read functional group from item, must contain the Plane Orientation
* Sequence
* @param item The item to read from
* @return EC_Normal if reading was successful, error otherwise
*/
virtual OFCondition read(DcmItem& item);
/** Writes functional group to given item (will write Plane Orientation
* Sequence to it)
* @param item The item to write to
* @return EC_Normal if writing was successful, error otherwise
*/
virtual OFCondition write(DcmItem& item);
/** Comparison operator that compares the normalized value of this object
* with a given object of the same type, i.e.\ the elements within both
* functional groups (this and rhs parameter) are compared by value!
* Both objects (this and rhs) need to have the same type (i.e.\ both
* FGUnknown) to be comparable. This function is used in order
* to decide whether a functional group already exists, or is new. This
* is used in particular to find out whether a given functional group
* can be shared (i.e.\ the same information already exists as shared
* functional group) or is different from the same shared group. In that
* case the shared functional group must be distributed into per-frame
* functional groups, instead. The exact implementation for implementing
* the comparison is not relevant. However, it must be a comparison
* by value.
* @param rhs the right hand side of the comparison
* @return 0 if the object values are equal.
* -1 if either the value of the first component that does not match
* is lower in the this object, or all compared components match
* but this component is shorter. Also returned if this type and
* rhs type (DcmFGTypes::E_FGType) do not match.
* 1 if either the value of the first component that does not match
* is greater in this object, or all compared components match
* but this component is longer.
*/
virtual int compare(const FGBase& rhs) const;
// --- get() functionality ---
/** Get Image Orientation Patient
* @param value Reference to variable in which the value should be stored
* @param pos Index of the value to get (0..vm-1), -1 for all components
* @return EC_Normal if successful, an error code otherwise
*/
virtual OFCondition getImageOrientationPatient(OFString& value,
const signed long pos);
/** Retrieve all values of Image Orientation Patient at the same time
* @param rowX Row X Value
* @param rowY Row Y Value
* @param rowZ Row Z Value
* @param colX Column X Value
* @param colY Column Y Value
* @param colZ Column Z Value
* @return EC_Normal if successful, an error code otherwise
*/
virtual OFCondition getImageOrientationPatient(Float64& rowX,
Float64& rowY,
Float64& rowZ,
Float64& colX,
Float64& colY,
Float64& colZ);
// --- set() functionality ---
/** Set all values of Image Orientation Patient at once
* @param rowX Row X Value
* @param rowY Row Y Value
* @param rowZ Row Z Value
* @param colX Column X Value
* @param colY Column Y Value
* @param colZ Column Z Value
* @param checkValue If OFTrue, values are checked for validity
* @return EC_Normal if successful, an error code otherwise
*/
virtual OFCondition setImageOrientationPatient(const OFString& rowX,
const OFString& rowY,
const OFString& rowZ,
const OFString& colX,
const OFString& colY,
const OFString& colZ,
const OFBool checkValue = OFTrue);
private:
/* Content of Plane Orientation (Patient) Macro */
/// Image Orientation (Patient) (DS, VM 6, Required type 1C)
DcmDecimalString m_ImageOrientationPatient;
};
#endif // FGPLANOR_H
|