X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmFileHelper.h;h=39348bf7ee2c82d0c7f8ed4c63de6154d35361f9;hb=951d1f96c7bff6329f19fa28444fae5c941c352d;hp=4848a946b4faa6393daa61250dad16a457e3e503;hpb=ce8913daafe02955368fd2f07e777e86824467cc;p=gdcm.git diff --git a/src/gdcmFileHelper.h b/src/gdcmFileHelper.h index 4848a946..39348bf7 100644 --- a/src/gdcmFileHelper.h +++ b/src/gdcmFileHelper.h @@ -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/08/19 13:15:05 $ + Version: $Revision: 1.21 $ Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de l'Image). All rights reserved. See Doc/License.txt or @@ -19,8 +19,11 @@ #ifndef GDCMFILEHELPER_H #define GDCMFILEHELPER_H -#include +#include "gdcmDebug.h" #include "gdcmBase.h" +//#include + + namespace gdcm { @@ -31,6 +34,9 @@ class SeqEntry; class PixelReadConvert; class PixelWriteConvert; class DocEntryArchive; + +typedef void (*VOID_FUNCTION_PUINT8_PFILE_POINTER)(uint8_t *, File *); + //----------------------------------------------------------------------------- /** * \brief In addition to Dicom header exploration, this class is designed @@ -49,12 +55,22 @@ public: public: FileHelper( ); FileHelper( File *header ); - FileHelper( std::string const &filename ); - + GDCM_LEGACY(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(); + /// to allow user to modify pixel order (e.g. Mirror, TopDown, 90°Rotate,...) + void SetUserFunction( VOID_FUNCTION_PUINT8_PFILE_POINTER userFunc ) + { UserFunction = userFunc; } // File methods bool SetValEntry(std::string const &content, uint16_t group, uint16_t elem); @@ -67,53 +83,71 @@ 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(); uint8_t *GetImageData(); uint8_t *GetImageDataRaw(); - size_t GetImageDataIntoVector(void *destination, size_t maxSize); + + GDCM_LEGACY(size_t GetImageDataIntoVector(void *destination,size_t maxSize)); void SetImageData(uint8_t *data, size_t expectedSize); // User data void SetUserData(uint8_t *data, size_t expectedSize); - uint8_t* GetUserData(); + uint8_t *GetUserData(); size_t GetUserDataSize(); - // RBG data (from file - uint8_t* GetRGBData(); + // RBG data (from file) + uint8_t *GetRGBData(); size_t GetRGBDataSize(); - // RAW data (from file - uint8_t* GetRawData(); + // 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 +165,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,23 +181,35 @@ 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 + /// Whether 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; + /// Pointer to a user supplied function to allow modification of pixel order + /// (i.e. : Mirror, TopDown, 90°Rotation, ...) + /// use as : void userSuppliedFunction(uint8_t *im, gdcm::File *f) + /// NB : the "uint8_t *" type of first param is just for prototyping. + /// User will Cast it according what he founds with f->GetPixelType() + /// See vtkgdcmSerieViewer for an example + VOID_FUNCTION_PUINT8_PFILE_POINTER UserFunction; }; } // end namespace gdcm