X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmDictSet.h;h=2d7789ab4c0eeb2ced2007386d12c32473a197a7;hb=ba78e6c6d47d6db1528e8e88e5ebde7296a26692;hp=0e2aed0b3a39a207fc4c6dface09f26b3f28b9fd;hpb=565a47ec4e037897aaf770aeccc5d67d7ad7b478;p=gdcm.git

diff --git a/src/gdcmDictSet.h b/src/gdcmDictSet.h
index 0e2aed0b..2d7789ab 100644
--- a/src/gdcmDictSet.h
+++ b/src/gdcmDictSet.h
@@ -1,48 +1,86 @@
-// gdcmDictSet.h
+/*=========================================================================
+                                                                                
+  Program:   gdcm
+  Module:    $RCSfile: gdcmDictSet.h,v $
+  Language:  C++
+  Date:      $Date: 2004/12/03 20:16:57 $
+  Version:   $Revision: 1.29 $
+                                                                                
+  Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
+  l'Image). All rights reserved. See Doc/License.txt or
+  http://www.creatis.insa-lyon.fr/Public/Gdcm/License.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 notices for more information.
+                                                                                
+=========================================================================*/
 
 #ifndef GDCMDICTSET_H
 #define GDCMDICTSET_H
 
+#include "gdcmDict.h"
+
 #include <map>
 #include <list>
-#include "gdcmCommon.h"
-#include "gdcmDict.h"
 
-////////////////////////////////////////////////////////////////////////////
-// Container for managing a set of loaded dictionaries. Sharing dictionaries
-// should avoid :
-// * reloading an allready loaded dictionary,
-// * having many in memory representations of the same dictionary.
+namespace gdcm 
+{
+typedef std::map<DictKey, Dict*> DictSetHT;
 
-typedef string DictKey;
-typedef map<DictKey, gdcmDict*> DictSetHT;
+//-----------------------------------------------------------------------------
+/*
+ * \defgroup DictSet
+ * \brief  Container for managing a set of loaded dictionaries.
+ * \note   Hopefully, sharing dictionaries should avoid
+ * \par    reloading an already loaded dictionary (saving time)
+ * \par    having many in memory representations of the same dictionary
+ *        (saving memory).
+ */
+class GDCM_EXPORT DictSet
+{
+public:
+   DictSet();
+   ~DictSet();
+
+   void Print(std::ostream& os);
+
+   EntryNamesList * GetPubDictEntryNames();
+   EntryNamesByCatMap * GetPubDictEntryNamesByCategory();
+
+   Dict* LoadDictFromFile( std::string const & fileName,
+                           DictKey const & name );
+
+   Dict* GetDict( DictKey const & DictName );
+
+   /// \brief   Retrieve the default reference DICOM V3 public dictionary.
+   Dict* GetDefaultPubDict() { return GetDict(PUB_DICT_NAME); };
+
+   // \brief   Retrieve the virtual reference DICOM dictionary.
+   // \warning : not end user intended
+   // Dict* GetVirtualDict() { return &VirtualEntry; };
+
+   DictEntry* NewVirtualDictEntry(uint16_t group, uint16_t element,
+                                  TagName vr     = "Unknown",
+                                  TagName fourth = "Unknown",
+                                  TagName name   = "Unknown");
+
+   static std::string BuildDictPath();
+
+protected:
+   bool AppendDict(Dict *NewDict, DictKey const & name);
 
-class GDCM_EXPORT gdcmDictSet {
-private:
-	DictSetHT dicts;
-	int AppendDict(gdcmDict* NewDict);
-	void LoadDictFromFile(string filename, DictKey);
 private:
-	static string DictPath;      // Directory path to dictionaries
-	static string BuildDictPath(void);
-	static gdcmDict* DefaultPubDict;
-public:
-	static list<string> * GetPubDictTagNames(void);
-	static map<string, list<string> >* GetPubDictTagNamesByCategory(void);
-	static gdcmDict* LoadDefaultPubDict(void);
-
-	gdcmDictSet(void);
-	// TODO Swig int LoadDictFromFile(string filename);
-   // QUESTION: the following function might not be thread safe !? Maybe
-   //           we need some mutex here, to avoid concurent creation of
-   //           the same dictionary !?!?!
-	// TODO Swig int LoadDictFromName(string filename);
-	// TODO Swig int LoadAllDictFromDirectory(string DirectoryName);
-	// TODO Swig string* GetAllDictNames();
-	//
-	void Print(ostream&);
-	gdcmDict* GetDict(DictKey DictName);
-	gdcmDict* GetDefaultPubDict(void);
+   /// Hash table of all dictionaries contained in this DictSet
+   DictSetHT Dicts;
+
+   /// Directory path to dictionaries
+   std::string DictPath;
+
+   /// H table for the on the fly created DictEntries  
+   TagKeyHT VirtualEntry; 
 };
+} // end namespace gdcm
 
+//-----------------------------------------------------------------------------
 #endif