itkImageIOBase.h

Go to the documentation of this file.

/*=========================================================================

  Program:   Insight Segmentation & Registration Toolkit
  Module:    $RCSfile: itkImageIOBase.h,v $
  Language:  C++
  Date:      $Date: 2004/01/08 00:39:06 $
  Version:   $Revision: 1.29 $

  Copyright (c) Insight Software Consortium. All rights reserved.
  See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm 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 __itkImageIOBase_h
#define __itkImageIOBase_h

#include "itkLightProcessObject.h"
#include "itkObjectFactory.h"
#include "itkIndent.h"
#include "itkImageIORegion.h"
#include <string>

namespace itk
{

class ITK_EXPORT ImageIOBase : public LightProcessObject
{
public:
  typedef ImageIOBase            Self;
  typedef LightProcessObject  Superclass;
  typedef SmartPointer<Self>  Pointer;
  
  itkTypeMacro(ImageIOBase, Superclass);

  itkSetStringMacro(FileName);
  itkGetStringMacro(FileName);
  
  class UnknownType {};

  typedef  enum {UNKNOWN,UCHAR,CHAR,USHORT,SHORT,UINT,INT,
                 ULONG,LONG, FLOAT,DOUBLE,
                 RGB,RGBA,OFFSET,VECTOR,POINT,COVARIANTVECTOR} IODataType;

  void SetNumberOfDimensions(unsigned int);
  itkGetMacro(NumberOfDimensions, unsigned int);

  virtual void SetDimensions(unsigned int i, unsigned int dim);
  virtual unsigned int GetDimensions(unsigned int i) const
  { return m_Dimensions[i]; }

  virtual void SetOrigin(unsigned int i, double origin);
  virtual double GetOrigin(unsigned int i) const
  { return m_Origin[i]; }

  virtual void SetSpacing(unsigned int i, double spacing);
  virtual double GetSpacing(unsigned int i) const
  { return m_Spacing[i]; }

  itkSetMacro(IORegion, ImageIORegion);
  itkGetMacro(IORegion, ImageIORegion);

  virtual const std::type_info& GetPixelType() const;
  virtual void SetPixelType(const IODataType ctype);

  virtual bool SetPixelType(const std::type_info& ptype);

  itkSetMacro(ComponentType,IODataType);
  itkGetMacro(ComponentType,IODataType);

  itkSetMacro(NumberOfComponents,unsigned int);
  itkGetMacro(NumberOfComponents,unsigned int);

  std::string ReturnTypeAsString(IODataType) const;

  typedef  enum {ASCII,Binary,TypeNotApplicable} FileType;
  
  typedef  enum {BigEndian,LittleEndian,OrderNotApplicable} ByteOrder;
  
  itkSetMacro(FileType,FileType);
  itkGetConstMacro(FileType,FileType);
  void SetFileTypeToASCII()
  { this->SetFileType(ASCII); }
  void SetFileTypeToBinary()
  { this->SetFileType(Binary); }

  itkSetMacro(ByteOrder,ByteOrder);
  itkGetConstMacro(ByteOrder,ByteOrder);
  void SetByteOrderToBigEndian()
  { this->SetByteOrder(BigEndian); }
  void SetByteOrderToLittleEndian()
  { this->SetByteOrder(LittleEndian); }
  
  virtual unsigned int GetPixelStride () const;

  unsigned int GetImageSizeInPixels() const;

  unsigned int GetImageSizeInBytes() const;
  
  unsigned int GetImageSizeInComponents() const;

  /*-------- This part of the interfaces deals with reading data ----- */

  virtual bool CanReadFile(const char*) = 0;

  virtual bool CanStreamRead() { return false; };
  
  virtual void ReadImageInformation() = 0;
  
  virtual void Read(void* buffer) = 0;


  /*-------- This part of the interfaces deals with writing data ----- */

  virtual bool CanWriteFile(const char*)  = 0;

  virtual bool CanStreamWrite() { return false; };

  virtual void WriteImageInformation() = 0;
  
  virtual void Write( const void* buffer) = 0;

  /* --- Support reading and writing data as a series of files. --- */

  virtual bool SupportsDimension(unsigned long dim)
  {return (dim == 2);}

protected:
  ImageIOBase();
  ~ImageIOBase();
  void PrintSelf(std::ostream& os, Indent indent) const;

  const std::type_info& ConvertToTypeInfo(IODataType ) const;
  unsigned int GetSizeOfType(IODataType ) const;
    
  IODataType m_PixelType;

  IODataType m_ComponentType;

  ByteOrder      m_ByteOrder;
  FileType       m_FileType;

  bool m_Initialized;

  std::string m_FileName;

  unsigned int m_NumberOfComponents;

  unsigned int m_NumberOfDimensions;

  ImageIORegion m_IORegion;

  std::vector<unsigned int> m_Dimensions;

  std::vector<double> m_Spacing;

  std::vector<double> m_Origin;

  std::vector<unsigned int> m_Strides;

  virtual void Reset(const bool freeDynamic = true);

  void Resize(const unsigned int numDimensions, 
              const unsigned int* dimensions);

  void ComputeStrides();

  virtual unsigned int GetPixelSize() const;

  virtual unsigned int GetComponentSize() const;

  unsigned int GetComponentStride() const;

  unsigned int GetRowStride () const;

  unsigned int GetSliceStride () const;

  void WriteBufferAsASCII(std::ostream& os, const void *buffer, IODataType ctype,
                          unsigned int numComp);

  void ReadBufferAsASCII(std::istream& os, void *buffer, IODataType ctype,
                         unsigned int numComp);

  bool ReadBufferAsBinary(std::istream& os, void *buffer, unsigned int numComp);

private:
  ImageIOBase(const Self&); //purposely not implemented
  void operator=(const Self&); //purposely not implemented

};

} // end namespace itk

#endif // __itkImageIOBase_h

---