Program: gdcm
Module: $RCSfile: gdcmFileHelper.h,v $
Language: C++
- Date: $Date: 2005/09/02 07:10:03 $
- Version: $Revision: 1.22 $
+ Date: $Date: 2005/11/28 15:20:33 $
+ Version: $Revision: 1.34 $
Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
l'Image). All rights reserved. See Doc/License.txt or
#define GDCMFILEHELPER_H
#include "gdcmDebug.h"
-#include "gdcmBase.h"
-//#include <iostream>
-
+#include "gdcmCommandManager.h"
namespace gdcm
{
class File;
-class ValEntry;
-class BinEntry;
+class DataEntry;
class SeqEntry;
class PixelReadConvert;
class PixelWriteConvert;
* for accessing the image/volume content. One can also use it to
* write Dicom/ACR-NEMA/RAW files.
*/
-class GDCM_EXPORT FileHelper : public Base
+class GDCM_EXPORT FileHelper : public CommandManager
{
+ gdcmTypeMacro(FileHelper);
+
public:
enum FileMode
{
};
public:
- FileHelper( );
- FileHelper( File *header );
- GDCM_LEGACY(FileHelper( std::string const &filename ));
+/// \brief Constructs a FileHelper with a RefCounter
+ static FileHelper *New() {return new FileHelper();}
+/// \brief Constructs a FileHelper with a RefCounter from a fileHelper
+ static FileHelper *New(File *header) {return new FileHelper(header);}
- virtual ~FileHelper();
-
void Print(std::ostream &os = std::cout, std::string const &indent = "");
/// Accessor to \ref File
void SetLoadMode(int loadMode);
void SetFileName(std::string const &fileName);
bool Load();
- /// to allow user to modify pixel order (e.g. Mirror, TopDown,...)
+ /// to allow user to modify pixel order (e.g. Mirror, UpsideDown,...)
void SetUserFunction( VOID_FUNCTION_PUINT8_PFILE_POINTER userFunc )
{ UserFunction = userFunc; }
// File methods
- bool SetValEntry(std::string const &content,
- uint16_t group, uint16_t elem);
- bool SetBinEntry(uint8_t *content, int lgth,
- uint16_t group, uint16_t elem);
-
- ValEntry *InsertValEntry(std::string const &content,
- uint16_t group, uint16_t elem);
- BinEntry *InsertBinEntry(uint8_t *binArea, int lgth,
+ bool SetEntryString(std::string const &content,
+ uint16_t group, uint16_t elem);
+ bool SetEntryBinArea(uint8_t *content, int lgth,
uint16_t group, uint16_t elem);
+
+ DataEntry *InsertEntryString(std::string const &content,
+ uint16_t group, uint16_t elem);
+ DataEntry *InsertEntryBinArea(uint8_t *binArea, int lgth,
+ uint16_t group, uint16_t elem);
SeqEntry *InsertSeqEntry(uint16_t group, uint16_t elem);
// File helpers
void SetWriteTypeToAcr() { SetWriteType(ACR); }
/// \brief Tells the writer we want to write as LibIDO
void SetWriteTypeToAcrLibido() { SetWriteType(ACR_LIBIDO); }
+ /// \brief Tells the writer we want to write as JPEG
+ void SetWriteTypeToJPEG() { SetWriteType(JPEG); }
/// \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)
+ /// (ImplicitVR, ExplicitVR, ACR, ACR_LIBIDO)
FileType GetWriteType() { return WriteType; }
// Write pixels of ONE image on hard drive
bool WriteDcmExplVR(std::string const &fileName);
bool WriteAcr (std::string const &fileName);
bool Write (std::string const &fileName);
-
+ /// \brief if user knows he didn't modify the pixels (e.g. he just anonymized
+ /// the file), he is allowed to ask to keep the original
+ /// 'Media Storage SOP Class UID' and 'Image Type'
+ void SetKeepMediaStorageSOPClassUID (bool v)
+ { KeepMediaStorageSOPClassUID = v; }
+ // no GetKeepMediaStorageSOPClassUID() method, on purpose!
+
protected:
+ FileHelper( );
+ FileHelper( File *header );
+ ~FileHelper();
+
bool CheckWriteIntegrity();
void SetWriteToRaw();
void RestoreWrite();
void SetWriteFileTypeToACR();
+ void SetWriteFileTypeToJPEG();
void SetWriteFileTypeToExplicitVR();
void SetWriteFileTypeToImplicitVR();
void RestoreWriteFileType();
void SetWriteToNoLibido();
void RestoreWriteOfLibido();
- ValEntry *CopyValEntry(uint16_t group, uint16_t elem);
- BinEntry *CopyBinEntry(uint16_t group, uint16_t elem,
- const std::string &vr);
+ DataEntry *CopyDataEntry(uint16_t group, uint16_t elem,
+ const TagName &vr = GDCM_VRUNKNOWN);
void CheckMandatoryElements();
+ void CheckMandatoryEntry(uint16_t group, uint16_t elem, std::string value);
+ void SetMandatoryEntry(uint16_t group, uint16_t elem, std::string value);
+ void CopyMandatoryEntry(uint16_t group, uint16_t elem, std::string value);
void RestoreWriteMandatory();
private:
/// gdcm::File to use to load the file
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.
- bool SelfHeader;
-
/// Whether already parsed or not
bool Parsed;
// 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, ...)
+
+ /// \brief Pointer to a user supplied function to allow modification
+ /// of pixel order (e.g. : Mirror, UpsideDown, 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;
+
+ /// \brief if user knows he didn't modify the pixels (e.g. he just
+ /// anonymized the file), he is allowed to ask to keep the original
+ /// 'Media Storage SOP Class UID' and 'Image Type'
+ bool KeepMediaStorageSOPClassUID;
};
} // end namespace gdcm
git://git.creatis.insa-lyon.fr / gdcm.git / blobdiff