Program: gdcm
Module: $RCSfile: gdcmDicomDir.h,v $
Language: C++
- Date: $Date: 2004/10/09 03:21:55 $
- Version: $Revision: 1.33 $
+ Date: $Date: 2005/07/08 19:07:12 $
+ Version: $Revision: 1.63 $
Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
l'Image). All rights reserved. See Doc/License.txt or
#ifndef GDCMDICOMDIR_H
#define GDCMDICOMDIR_H
-#include "gdcmCommon.h"
#include "gdcmDocument.h"
-#include "gdcmDicomDirPatient.h"
-#include "gdcmDicomDirMeta.h"
-#include "gdcmDicomDirElement.h"
#include <list>
#include <vector>
+namespace gdcm
+{
//-----------------------------------------------------------------------------
-typedef std::list<gdcmDicomDirPatient*> ListDicomDirPatient;
-typedef std::vector<gdcmDocument*> VectDocument;
+class DicomDirPatient;
+class DicomDirMeta;
+class DicomDirElement;
+class DicomDirStudy;
+class DicomDirSerie;
+class DicomDirVisit;
+class DicomDirImage;
+class SQItem;
+
+typedef std::list<DicomDirPatient *> ListDicomDirPatient;
+typedef std::vector<Document *> VectDocument;
-typedef GDCM_EXPORT void(gdcmMethod)(void* = NULL);
//-----------------------------------------------------------------------------
-
/**
- * \ingroup gdcmDicomDir
- * \brief gdcmDicomDir defines an object representing a DICOMDIR in memory.
- *
+ * \brief DicomDir defines an object representing a DICOMDIR in memory
+ * as a tree-like structure DicomDirPatient
+ * -> DicomDirStudy
+ * -> DicomDirSerie
+ * -> DicomDirImage
*/
-class GDCM_EXPORT gdcmDicomDir: public gdcmDocument
+class GDCM_EXPORT DicomDir: public Document
{
public:
- gdcmDicomDir( std::string const & fileName, bool parseDir = false );
- gdcmDicomDir();
-
- ~gdcmDicomDir();
+ typedef void Method(void*);
- /// \brief canonical Printer
- /// \sa SetPrintLevel
- virtual void Print(std::ostream &os = std::cout);
+ DicomDir( std::string const &filename, bool parseDir = false );
+ DicomDir();
+
+ ~DicomDir();
- /// Informations contained in the parser
+ bool Load( std::string const &filename );
+ bool Load( );
+ void Print(std::ostream &os = std::cout, std::string const &indent = "" );
+
+ /// Sets the root Directory name to parse, recursively
+ void SetDirectoryName(std::string const &dirName)
+ { ParseDir = true; if (Filename != dirName)
+ Filename = dirName, IsDocumentModified = true; };
+ /// Accessor to \ref Filename
+ virtual void SetFileName(std::string const &fileName)
+ { ParseDir = false; if (Filename != fileName)
+ Filename = fileName, IsDocumentModified = true; }
+
+ /// DEPRECATED : use SetDirectoryName
+ void SetParseDir(bool parseDir) { ParseDir = parseDir; };
+
+ // Informations contained in the parser
virtual bool IsReadable();
- /// Returns a pointer to the gdcmDicomDirMeta for this DICOMDIR.
- gdcmDicomDirMeta* GetDicomDirMeta() { return MetaElems; };
+ // Meta
+ DicomDirMeta *NewMeta();
+ /// Returns a pointer to the DicomDirMeta for this DICOMDIR.
+ DicomDirMeta *GetMeta() { return MetaElems; };
- /// Returns the PATIENT chained List for this DICOMDIR.
- ListDicomDirPatient &GetDicomDirPatients() { return Patients; };
+ // Patients
+ DicomDirPatient *NewPatient();
+ void ClearPatient();
- /// Parsing
+ DicomDirPatient *GetFirstPatient();
+ DicomDirPatient *GetNextPatient();
+
+ // Parsing
void ParseDirectory();
-
- void SetStartMethod(gdcmMethod*, void* = NULL, gdcmMethod* = NULL);
- void SetStartMethodArgDelete(gdcmMethod*);
- void SetProgressMethod(gdcmMethod* ,void* = NULL, gdcmMethod* = NULL);
- void SetProgressMethodArgDelete(gdcmMethod*);
- void SetEndMethod(gdcmMethod*, void* = NULL,gdcmMethod* = NULL);
- void SetEndMethodArgDelete(gdcmMethod*);
+
+ // Note: the DicomDir:: namespace prefix is needed by Swig in the
+ // following method declarations. Refer to gdcmPython/gdcm.i
+ // for the reasons of this unnecessary notation at C++ level.
+ void SetStartMethod( DicomDir::Method *method,
+ void *arg = NULL,
+ DicomDir::Method *argDelete = NULL );
+ void SetProgressMethod( DicomDir::Method *method,
+ void *arg = NULL,
+ DicomDir::Method *argDelete = NULL );
+ void SetEndMethod( DicomDir::Method *method,
+ void *arg = NULL,
+ DicomDir::Method *argDelete = NULL );
+ void SetStartMethodArgDelete ( DicomDir::Method *m );
+ void SetProgressMethodArgDelete( DicomDir::Method *m );
+ void SetEndMethodArgDelete ( DicomDir::Method *m );
/// GetProgress GetProgress
float GetProgress() { return Progress; };
-
/// AbortProgress AbortProgress
void AbortProgress() { Abort = true; };
-
/// IsAborted IsAborted
bool IsAborted() { return Abort; };
-
- /// Adding
- gdcmDicomDirMeta* NewMeta();
- gdcmDicomDirPatient* NewPatient();
- /// Write
- bool WriteDicomDir(std::string const & fileName);
+ // Write
+ bool WriteDicomDir(std::string const &fileName);
- /// Types of the gdcmDicomDirObject within the gdcmDicomDir
+ bool AnonymizeDicomDir();
+
+ /// Types of the DicomDirObject within the DicomDir
typedef enum
{
GDCM_DICOMDIR_NONE,
GDCM_DICOMDIR_PATIENT,
GDCM_DICOMDIR_STUDY,
GDCM_DICOMDIR_SERIE,
+ GDCM_DICOMDIR_VISIT,
GDCM_DICOMDIR_IMAGE
- } gdcmDicomDirType;
+ } DicomDirType;
protected:
- void CreateDicomDirChainedList(std::string const & path);
+ void CreateDicomDirChainedList(std::string const &path);
void CallStartMethod();
void CallProgressMethod();
void CallEndMethod();
private:
void Initialize();
void CreateDicomDir();
- void AddDicomDirMeta();
- void AddDicomDirPatientToEnd(gdcmSQItem* s);
- void AddDicomDirStudyToEnd (gdcmSQItem* s);
- void AddDicomDirSerieToEnd (gdcmSQItem* s);
- void AddDicomDirImageToEnd (gdcmSQItem* s);
-
- void SetElements(std::string &path, VectDocument &list);
- void SetElement (std::string &path,gdcmDicomDirType type,
- gdcmDocument* header);
-
- static bool HeaderLessThan(gdcmDocument* header1,gdcmDocument* header2);
+ bool DoTheLoadingJob();
+ bool AddPatientToEnd(DicomDirPatient *dd);
+ bool AddStudyToEnd (DicomDirStudy *dd);
+ bool AddSerieToEnd (DicomDirSerie *dd);
+ bool AddVisitToEnd (DicomDirVisit *dd);
+ bool AddImageToEnd (DicomDirImage *dd);
+
+ void SetElements(std::string const &path, VectDocument const &list);
+ void SetElement (std::string const &path, DicomDirType type,
+ Document *header);
+ void MoveSQItem(DocEntrySet *dst, DocEntrySet *src);
+
+ static bool HeaderLessThan(Document *header1, Document *header2);
// Variables
- /// Pointer on *the* gdcmDicomDirObject 'DicomDirMeta Elements'
- gdcmDicomDirMeta* MetaElems;
+ /// Pointer on *the* DicomDirObject 'DicomDirMeta Elements'
+ DicomDirMeta *MetaElems;
- /// Chained list of DicomDirPatient (to be exploited recursively)
+ /// Chained list of DicomDirPatient (to be exploited hierarchicaly)
ListDicomDirPatient Patients;
+ ListDicomDirPatient::iterator ItPatient;
/// pointer to the initialisation method for any progress bar
- gdcmMethod* StartMethod;
+ Method *StartMethod;
/// pointer to the incrementation method for any progress bar
- gdcmMethod* ProgressMethod;
+ Method *ProgressMethod;
/// pointer to the termination method for any progress bar
- gdcmMethod* EndMethod;
+ Method *EndMethod;
/// pointer to the ??? method for any progress bar
- gdcmMethod* StartMethodArgDelete;
+ Method *StartMethodArgDelete;
/// pointer to the ??? method for any progress bar
- gdcmMethod* ProgressMethodArgDelete;
+ Method* ProgressMethodArgDelete;
/// pointer to the ??? method for any progress bar
- gdcmMethod* EndMethodArgDelete;
+ Method *EndMethodArgDelete;
/// pointer to the ??? for any progress bar
- void* StartArg;
+ void *StartArg;
/// pointer to the ??? for any progress bar
- void* ProgressArg;
+ void *ProgressArg;
/// pointer to the ??? for any progress bar
- void* EndArg;
+ void *EndArg;
/// value of the ??? for any progress bar
float Progress;
/// value of the ??? for any progress bar
bool Abort;
+ bool ParseDir;
};
-
+} // end namespace gdcm
//-----------------------------------------------------------------------------
#endif