itkImageIOBase.h

Go to the documentation of this file.

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

  Program:   Insight Segmentation & Registration Toolkit
  Module:    $RCSfile: itkImageIOBase.h,v $
  Language:  C++
  Date:      $Date: 2002/07/29 14:51:21 $
  Version:   $Revision: 1.20 $

  Copyright (c) 2002 Insight 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);

  class UnknownType {};

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

  itkSetStringMacro(FileName);
  itkGetStringMacro(FileName);
  
  itkSetStringMacro(FilePrefix);
  itkGetStringMacro(FilePrefix);
  
  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 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 void WriteImageInformation() = 0;
  
  virtual void Write( const void* buffer) = 0;

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;

  unsigned int m_NumberOfDimensions;

  ByteOrder      m_ByteOrder;
  FileType       m_FileType;

  bool m_Initialized;

  std::string m_FileName;

  std::string m_FilePrefix;

  unsigned int m_NumberOfComponents;

  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);

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

};

} // end namespace itk

#endif // __itkImageIOBase_h

---