/usr/include/gdcm-2.2/gdcmDICOMDIRGenerator.h is in libgdcm2-dev 2.2.4-1.1ubuntu4.
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 | /*=========================================================================
Program: GDCM (Grassroots DICOM). A DICOM library
Copyright (c) 2006-2011 Mathieu Malaterre
All rights reserved.
See Copyright.txt or http://gdcm.sourceforge.net/Copyright.html for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
#ifndef GDCMDICOMDIRGENERATOR_H
#define GDCMDICOMDIRGENERATOR_H
#include "gdcmDirectory.h"
#include "gdcmTag.h"
#include <utility> // std::pair
namespace gdcm
{
class File;
class Scanner;
class SequenceOfItems;
class VL;
class DICOMDIRGeneratorInternal;
/**
* \brief DICOMDIRGenerator class
* This is a STD-GEN-CD DICOMDIR generator.
* ref: PS 3.11-2008 Annex D (Normative) - General Purpose CD-R and DVD Interchange Profiles
*
* \note
* PS 3.11 - 2008 / D.3.2 Physical Medium And Medium Format
* The STD-GEN-CD and STD-GEN-SEC-CD application profiles require the 120 mm CD-R physical
* medium with the ISO/IEC 9660 Media Format, as defined in PS3.12.
* See also PS 3.12 - 2008 / Annex F 120mm CD-R Medium (Normative) and
* PS 3.10 - 2008 / 8 DICOM File Service / 8.1 FILE-SET
*
* \warning:
* PS 3.11 - 2008 / D.3.1 SOP Classes and Transfer Syntaxes
* Composite Image & Stand-alone Storage are required to be stored as Explicit VR Little
* Endian Uncompressed (1.2.840.10008.1.2.1). When a DICOM file is found using another
* Transfer Syntax the generator will simply stops.
*
* \warning
* - Input files should be Explicit VR Little Endian
* - filenames should be valid VR::CS value (16 bytes, upper case ...)
*
* \bug:
* There is a current limitation of not handling Referenced SOP Class UID /
* Referenced SOP Instance UID simply because the gdcm::Scanner does not allow us
* See PS 3.11 / Table D.3-2 STD-GEN Additional DICOMDIR Keys
*/
class GDCM_EXPORT DICOMDIRGenerator
{
public:
typedef Directory::FilenamesType FilenamesType;
typedef Directory::FilenameType FilenameType;
DICOMDIRGenerator();
~DICOMDIRGenerator();
/// Set the list of filenames from which the DICOMDIR should be generated from
void SetFilenames( FilenamesType const & fns );
/// Set the root directory from which the filenames should be considered.
void SetRootDirectory( FilenameType const & root );
/// Set the File Set ID.
/// \warning this need to be a valid VR::CS value
void SetDescriptor( const char *d );
/// Main function to generate the DICOMDIR
bool Generate();
/// Set/Get file. The DICOMDIR file will be valid once a call to Generate has been done
void SetFile(const File& f);
File &GetFile();
protected:
Scanner &GetScanner();
bool AddPatientDirectoryRecord();
bool AddStudyDirectoryRecord();
bool AddSeriesDirectoryRecord();
bool AddImageDirectoryRecord();
private:
const char *ComputeFileID(const char *);
bool TraverseDirectoryRecords(VL start );
bool ComputeDirectoryRecordsOffset(const SequenceOfItems *sqi, VL start);
size_t FindNextDirectoryRecord( size_t item1, const char *directorytype );
SequenceOfItems *GetDirectoryRecordSequence();
size_t FindLowerLevelDirectoryRecord( size_t item1, const char *directorytype );
typedef std::pair< std::string, Tag> MyPair;
MyPair GetReferenceValueForDirectoryType(size_t item);
bool SeriesBelongToStudy(const char *seriesuid, const char *studyuid);
bool ImageBelongToSeries(const char *sopuid, const char *seriesuid, Tag const &t1, Tag const &t2);
bool ImageBelongToSameSeries(const char *sopuid, const char *seriesuid, Tag const &t);
DICOMDIRGeneratorInternal * Internals;
};
/**
* \example GenerateDICOMDIR.cs
* This is a C# example on how to use gdcm::DICOMDIRGenerator
*/
} // end namespace gdcm
#endif //GDCMDICOMDIRGENERATOR_H
|