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
* \details 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 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 DICOMDIRGenerator
*/
} // end namespace gdcm
#endif //GDCMDICOMDIRGENERATOR_H
|
