]> Creatis software - gdcm.git/blobdiff - src/gdcmFileHelper.h
Comments
[gdcm.git] / src / gdcmFileHelper.h
index 4848a946b4faa6393daa61250dad16a457e3e503..327431ba5193a3e64202d348fa0911de455fa703 100644 (file)
@@ -3,8 +3,8 @@
   Program:   gdcm
   Module:    $RCSfile: gdcmFileHelper.h,v $
   Language:  C++
-  Date:      $Date: 2005/01/25 15:44:24 $
-  Version:   $Revision: 1.7 $
+  Date:      $Date: 2005/07/08 14:36:48 $
+  Version:   $Revision: 1.18 $
                                                                                 
   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
   l'Image). All rights reserved. See Doc/License.txt or
@@ -50,11 +50,19 @@ public:
    FileHelper( );
    FileHelper( File *header );
    FileHelper( std::string const &filename );
+   
    virtual ~FileHelper();
 
-   void Print(std::ostream &os = std::cout, std::string const & indent = ""); 
+   void Print(std::ostream &os = std::cout, std::string const &indent = ""); 
 
+   /// Accessor to \ref File
+   File *GetFile() { return FileInternal; }
+   
+
+   void SetLoadMode(int loadMode);
+   void SetFileName(std::string const &fileName);
+   bool Load();
+   
    // File methods
    bool SetValEntry(std::string const &content,
                     uint16_t group, uint16_t elem);
@@ -67,9 +75,7 @@ public:
                             uint16_t group, uint16_t elem);
    SeqEntry *InsertSeqEntry(uint16_t group, uint16_t elem);
 
-   /// Accessor to \ref File
-   File *GetFile() { return FileInternal; }
-
+   // File helpers
    size_t GetImageDataSize();
    size_t GetImageDataRawSize();
 
@@ -81,39 +87,58 @@ public:
 
    // User data
    void SetUserData(uint8_t *data, size_t expectedSize);
-   uint8_tGetUserData();
+   uint8_t *GetUserData();
    size_t GetUserDataSize();
-   // RBG data (from file
-   uint8_tGetRGBData();
+   // RBG data (from file)
+   uint8_t *GetRGBData();
    size_t GetRGBDataSize();
-   // RAW data (from file
-   uint8_tGetRawData();
+   // RAW data (from file)
+   uint8_t *GetRawData();
    size_t GetRawDataSize();
 
-   // Write pixels of ONE image on hard drive
-   // No test is made on processor "endianity"
-   // The user must call his reader correctly
-   bool WriteRawData  (std::string const &fileName);
-   bool WriteDcmImplVR(std::string const &fileName);
-   bool WriteDcmExplVR(std::string const &fileName);
-   bool WriteAcr      (std::string const &fileName);
-   bool Write         (std::string const &fileName);
-
+   // LUT
    uint8_t* GetLutRGBA();
+   int GetLutItemNumber();
+   int GetLutItemSize();
 
    // Write mode
-   void SetWriteModeToRaw()          { SetWriteMode(WMODE_RAW); };
-   void SetWriteModeToRGB()          { SetWriteMode(WMODE_RGB); };
-   void SetWriteMode(FileMode mode)  { WriteMode = mode; };
-   FileMode GetWriteMode()           { return WriteMode; };
+
+   /// \brief Tells the writer we want to keep 'Grey pixels + Palettes color'
+   ///        when possible (as opposed to convert 'Palettes color' to RGB)
+  void SetWriteModeToRaw()            { SetWriteMode(WMODE_RAW);  };
+   /// \brief Tells the writer we want to write RGB image when possible
+   ///        (as opposed to 'Grey pixels + Palettes color')
+   void SetWriteModeToRGB()           { SetWriteMode(WMODE_RGB);  };
+   /// \brief Sets the Write Mode ( )
+   void SetWriteMode(FileMode mode)   { WriteMode = mode;         };
+   /// \brief Gets the Write Mode ( )
+   FileMode GetWriteMode()            { return WriteMode;         };
 
    // Write format
+
+   /// \brief Tells the writer we want to write as Implicit VR
    void SetWriteTypeToDcmImplVR()     { SetWriteType(ImplicitVR); };
+   /// \brief Tells the writer we want to write as Explicit VR
    void SetWriteTypeToDcmExplVR()     { SetWriteType(ExplicitVR); };
-   void SetWriteTypeToAcr()           { SetWriteType(ACR); };
+   /// \brief Tells the writer we want to write as ACR-NEMA
+   void SetWriteTypeToAcr()           { SetWriteType(ACR);        };
+   /// \brief Tells the writer we want to write as LibIDO
    void SetWriteTypeToAcrLibido()     { SetWriteType(ACR_LIBIDO); };
-   void SetWriteType(FileType format) { WriteType = format; };
-   FileType GetWriteType()            { return WriteType; };
+   /// \brief Tells the writer which format we want to write
+   /// (ImplicitVR, ExplicitVR, ACR, ACR_LIBIDO)
+   void SetWriteType(FileType format) { WriteType = format;       };
+   /// \brief Gets the format we talled the write we wanted to write
+   ///   (ImplicitVR, ExplicitVR, ACR, ACR_LIBIDO)
+   FileType GetWriteType()            { return WriteType;         };
+
+   // Write pixels of ONE image on hard drive
+   // No test is made on processor "endianness"
+   // The user must call his reader correctly
+   bool WriteRawData  (std::string const &fileName);
+   bool WriteDcmImplVR(std::string const &fileName);
+   bool WriteDcmExplVR(std::string const &fileName);
+   bool WriteAcr      (std::string const &fileName);
+   bool Write         (std::string const &fileName);
 
 protected:
    bool CheckWriteIntegrity();
@@ -131,8 +156,11 @@ protected:
    void SetWriteToNoLibido();
    void RestoreWriteOfLibido();
 
-   ValEntry *CopyValEntry(uint16_t group,uint16_t elem);
-   BinEntry *CopyBinEntry(uint16_t group,uint16_t elem);
+   ValEntry *CopyValEntry(uint16_t group, uint16_t elem);
+   BinEntry *CopyBinEntry(uint16_t group, uint16_t elem, 
+                          const std::string &vr);
+   void CheckMandatoryElements();
+   void RestoreWriteMandatory();
 
 private:
    void Initialize();
@@ -144,22 +172,27 @@ private:
    File *FileInternal;
 
    /// \brief Whether the underlying \ref gdcm::File was loaded by
-   ///  the constructor or passed to the constructor. When false
-   ///  the destructor is in charge of deletion.
+   ///  the constructor or passed to the constructor. 
+   ///  When false the destructor is in charge of deletion.
    bool SelfHeader;
    
    /// Wether already parsed or not
    bool Parsed;
 
-   /// Utility pixel converter
+   // Utility pixel converter
+   /// \brief Pointer to the PixelReadConverter
    PixelReadConvert *PixelReadConverter;
+   /// \brief Pointer to the PixelWriteConverter
    PixelWriteConvert *PixelWriteConverter;
 
    // Utility header archive
+   /// \brief Pointer to the DocEntryArchive (used while writting process)
    DocEntryArchive *Archive;
 
    // Write variables
+   /// \brief (WMODE_RAW, WMODE_RGB)
    FileMode WriteMode;
+   /// \brief (ImplicitVR, ExplicitVR, ACR, ACR_LIBIDO)
    FileType WriteType;
 };
 } // end namespace gdcm