itkTIFFImageIO.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef __itkTIFFImageIO_h
#define __itkTIFFImageIO_h

#include "itkImageIOBase.h"
#include <fstream>

#include "itk_tiff.h"

namespace itk
{
//BTX
class TIFFReaderInternal;
//ETX

class ITK_EXPORT TIFFImageIO:public ImageIOBase
{
public:
  typedef TIFFImageIO          Self;
  typedef ImageIOBase          Superclass;
  typedef SmartPointer< Self > Pointer;

  itkNewMacro(Self);

  itkTypeMacro(TIFFImageIO, ImageIOBase);

  /*-------- This part of the interface deals with reading data. ------ */

  virtual bool CanReadFile(const char *);

  virtual void ReadImageInformation();

  virtual void Read(void *buffer);

  virtual void ReadVolume(void *buffer);

  virtual void ReadTiles(void *buffer);

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

  virtual bool CanWriteFile(const char *);

  virtual void WriteImageInformation();

  virtual void Write(const void *buffer);

  enum { NOFORMAT, RGB_, GRAYSCALE, PALETTE_RGB, PALETTE_GRAYSCALE, OTHER };

  //BTX
  enum { // Compression types
    NoCompression,
    PackBits,
    JPEG,
    Deflate,
    LZW
    };
  //ETX

  // Description:
  // Set compression type. Sinze LZW compression is patented outside US, the
  // additional work steps have to be taken in order to use that compression.
  void SetCompressionToNoCompression() { this->SetCompression(NoCompression); }
  void SetCompressionToPackBits()      { this->SetCompression(PackBits); }
  void SetCompressionToJPEG()          { this->SetCompression(JPEG); }
  void SetCompressionToDeflate()       { this->SetCompression(Deflate); }
  void SetCompressionToLZW()           { this->SetCompression(LZW); }

  void SetCompression(int compression)
  {
    m_Compression = compression;

    // This If block isn't strictly necessary:
    // SetCompression(true); would be sufficient.  However, it reads strangely
    // for SetCompression(NoCompression) to then set SetCompression(true).
    // Doing it this way is probably also less likely to break in the future.
    if ( compression == NoCompression )
      {
      this->SetUseCompression(false); // this is for the ImageIOBase class
      }
    else
      {
      this->SetUseCompression(true);  // this is for the ImageIOBase class
      }
  }

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

  void InternalWrite(const void *buffer);

  void InitializeColors();

  void ReadGenericImage(void *out,
                        unsigned int itkNotUsed(width),
                        unsigned int height);

  // To support Zeiss images
  void ReadTwoSamplesPerPixelImage(void *out,
                                   unsigned int itkNotUsed(width),
                                   unsigned int height);

  int EvaluateImageAt(void *out, void *in);

  unsigned int  GetFormat();

  void GetColor(int index, unsigned short *red,
                unsigned short *green, unsigned short *blue);

  // Check that tag t can be found
  bool  CanFindTIFFTag(unsigned int t);

// This method, used obtaining the data from custom tags, requires the
// "private" libtiff tif_def.h, which is not installed in a system
// installation.
#ifndef ITK_USE_SYSTEM_TIFF
  // Read and returns the raw bytes of tag t
  void * ReadRawByteFromTag(unsigned int t, short & value_count);
#endif // ITK_USE_SYSTEM_TIFF

  TIFFReaderInternal *m_InternalImage;

  int m_Compression;

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

  unsigned short *m_ColorRed;
  unsigned short *m_ColorGreen;
  unsigned short *m_ColorBlue;
  int             m_TotalColors;
  unsigned int    m_ImageFormat;
};
} // end namespace itk

#endif // __itkTIFFImageIO_h