gdcmFile.h

Go to the documentation of this file.

/*=========================================================================
                                                                                
  Program:   gdcm
  Module:    $RCSfile: gdcmFile.h,v $
  Language:  C++
  Date:      $Date: 2007/08/22 16:14:04 $
  Version:   $Revision: 1.133 $
                                                                                
  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 _GDCMFILE_H_
#define _GDCMFILE_H_

#include "gdcmDebug.h"
#include "gdcmDocument.h"
#include "gdcmTagKey.h"


namespace GDCM_NAME_SPACE 
{

class RLEFramesInfo;
class JPEGFragmentsInfo;

//-----------------------------------------------------------------------------
// Dicom Part 3.3 Compliant
enum ModalityType {
   Unknow,
   AU,       // Voice Audio
   AS,       // Angioscopy
   BI,       // Biomagnetic Imaging
   CF,       // Cinefluorography
   CP,       // Culposcopy
   CR,       // Computed Radiography
   CS,       // Cystoscopy
   CT,       // Computed Tomography
   DD,       // Duplex Dopler
   DF,       // Digital Fluoroscopy
   DG,       // Diaphanography
   DM,       // Digital Microscopy
   DS,       // Digital Substraction Angiography
   DX,       // Digital Radiography
   ECG,      // Echocardiography
   EPS,      // Basic Cardiac EP
   ES,       // Endoscopy
   FA,       // Fluorescein Angiography
   FS,       // Fundoscopy
   HC,       // Hard Copy
   HD,       // Hemodynamic
   LP,       // Laparoscopy
   LS,       // Laser Surface Scan
   MA,       // Magnetic Resonance Angiography
   MR,       // Magnetic Resonance
   NM,       // Nuclear Medicine
   OT,       // Other
   PT,       // Positron Emission Tomography
   RF,       // Radio Fluoroscopy
   RG,       // Radiographic Imaging
   RTDOSE,   // Radiotherapy Dose
   RTIMAGE,  // Radiotherapy Image
   RTPLAN,   // Radiotherapy Plan
   RTSTRUCT, // Radiotherapy Structure Set
   SM,       // Microscopic Imaging
   ST,       // Single-photon Emission Computed Tomography
   TG,       // Thermography
   US,       // Ultrasound
   VF,       // Videofluorography
   XA,       // X-Ray Angiography
   XC        // Photographic Imaging
};

//-----------------------------------------------------------------------------

class GDCM_EXPORT File : public Document
{
   gdcmTypeMacro(File);

public:
   static File *New() {return new File();}

   // Loading
  // GDCM_LEGACY(bool Load( std::string const &filename ))
   bool Load();
   // Standard values and informations contained in the header
   bool IsReadable();

   void SetFourthDimensionLocation(uint16_t group, uint16_t elem) {
                   FourthDimensionLocation = TagKey(group, elem); }

   // Some heuristic based accessors, end user intended
   int GetImageNumber();
   ModalityType GetModality();

   int GetXSize();
   int GetYSize();
   int GetZSize();
   int GetTSize(); // unnormalized in DICOM V3

   bool GetSpacing(float &xspacing, float &yspacing, float &zspacing);
   float GetXSpacing();
   float GetYSpacing();
   float GetZSpacing();

   float GetXOrigin();
   float GetYOrigin();
   float GetZOrigin();

   float GetXCosineOnX();
   float GetXCosineOnY();  
   float GetXCosineOnZ();
   float GetYCosineOnX();
   float GetYCosineOnY();  
   float GetYCosineOnZ();   
     
   bool GetImageOrientationPatient( float iop[6] );
   bool GetImagePositionPatient( float ipp[3] );
   
   int GetBitsStored();
   int GetBitsAllocated();
   int GetHighBitPosition();
   int GetSamplesPerPixel();
   int GetPlanarConfiguration();
   int GetPixelSize();
   std::string GetPixelType();
   bool IsSignedPixelData();
   bool IsMonochrome();
   bool IsMonochrome1();
   bool IsPaletteColor();
   bool IsYBRFull();

   bool HasLUT();
   int GetLUTNbits();

   // For rescaling graylevel:
   bool GetRescaleSlopeIntercept(double &slope, double &intercept);   
   double GetRescaleIntercept();
   double GetRescaleSlope();

   int GetNumberOfScalarComponents();
   int GetNumberOfScalarComponentsRaw();

   uint16_t GetGrPixel()  { return GrPixel; }
   uint16_t GetNumPixel() { return NumPixel; }

   size_t GetPixelOffset();
   size_t GetPixelAreaLength();

   RLEFramesInfo *GetRLEInfo() { return RLEInfo; }
   JPEGFragmentsInfo *GetJPEGInfo() { return JPEGInfo; }

// Anonymization process
   void AddAnonymizeElement (uint16_t group, uint16_t elem, 
                             std::string const &value);
   void ClearAnonymizeList() { UserAnonymizeList.clear(); }      
   void AnonymizeNoLoad();
   bool AnonymizeFile();

   bool Write(std::string fileName, FileType filetype);

protected:
   File();
   virtual ~File();
   bool MayIWrite(uint16_t group)
     { if (group < 8 &&  group !=2 ) return false; else return true; }
      
   RLEFramesInfo *RLEInfo;
   JPEGFragmentsInfo *JPEGInfo;

   uint16_t NumPixel;
   uint16_t GrPixel;
   TagKey FourthDimensionLocation;

private:
   bool DoTheLoadingJob();
   void ComputeRLEInfo();
   void ComputeJPEGFragmentInfo();
   bool     ReadTag(uint16_t, uint16_t);
   uint32_t ReadTagLength(uint16_t, uint16_t);
   void ReadEncapsulatedBasicOffsetTable();
   uint32_t *BasicOffsetTableItemValue;

};
} // end namespace gdcm

//-----------------------------------------------------------------------------
#endif

---