/usr/include/dcmtk/dcmrt/drmstrct.h is in libdcmtk-dev 3.6.1~20160216-4.
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 | /*
*
* Copyright (C) 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: dcmrt
*
* Author: Uli Schlachter
*
* Purpose: Mid-Level API for RT Structure Set objects
*
*/
#ifndef DRMSTRCT_H
#define DRMSTRCT_H
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/dcmrt/drtstrct.h"
/**
* helper class for working with radio therapy structure set objects. This class
* provides several helper functions on top of DRTStructureSet.
*
* @note These functions hopefully simplify working with DRTStructureSetIOD.
* This is a work in progress, please propose any improvements which would make
* working with this class easier for you and that your consider useful.
*/
class DCMTK_DCMRT_EXPORT DRTStructureSet : public DRTStructureSetIOD
{
public:
/** load an object from a file
* @param fileName name of the file to load (may contain wide chars if support enabled).
* Since there are various constructors for the OFFilename class, a "char *", "OFString"
* or "wchar_t *" can also be passed directly to this parameter.
* @param readMode read file with or without meta header, i.e. as a fileformat or a
* dataset. Use ERM_fileOnly in order to force the presence of a meta header.
* @param readXfer transfer syntax used to read the data (auto detection if EXS_Unknown)
* @return status, EC_Normal if successful, an error code otherwise
*/
virtual OFCondition loadFile(const OFFilename &fileName,
const E_FileReadMode readMode = ERM_autoDetect,
const E_TransferSyntax readXfer = EXS_Unknown);
/** find a frame of reference by its fraction UID.
* @param uid the UID to find.
* @return the item representing the frame of reference or the
* EmptyDefaultItem of the DRTReferencedFrameOfReferenceSequence.
*/
DRTReferencedFrameOfReferenceSequence::Item& getFrameOfReference(const OFString& uid);
/** find a region of interest by its roi number.
* @param roiNumber the ROI to find.
* @return the item representing the region of interest or the
* EmptyDefaultItem of the DRTStructureSetROISequence.
*/
DRTStructureSetROISequence::Item& getROI(Sint32 roiNumber);
/** find an observation by its observation number.
* @param observationNumber the observation number to find.
* @return the item representing the observation or the
* EmptyDefaultItem of the DRTRTROIObservationsSequence.
*/
DRTRTROIObservationsSequence::Item& getObservation(Sint32 observationNumber);
/** find an observation belonging to a given ROI number.
* @param roiNumber the ROI number to find.
* @return the item representing the observation or the
* EmptyDefaultItem of the DRTRTROIObservationsSequence.
*/
DRTRTROIObservationsSequence::Item& getObservationByROINumber(Sint32 roiNumber);
/** get all contours for a region of interest.
* @param result vector for storing the contours
* @param roiNumber ROI number to look for
* @return status, EC_Normal if successful, an error code otherwise
*/
OFCondition getContoursForROINumber(OFVector<DRTROIContourSequence::Item*> result, Sint32 roiNumber);
/** get all contours for a region of interest.
* @param result list for storing the contours
* @param roiNumber ROI number to look for
* @return status, EC_Normal if successful, an error code otherwise
*/
OFCondition getContoursForROINumber(OFList<DRTROIContourSequence::Item*> result, Sint32 roiNumber);
};
#endif
|