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 "ITKIOTIFFExport.h"

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

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

class ITKIOTIFF_EXPORT TIFFImageIO:public ImageIOBase
{
public:
  ITK_DISALLOW_COPY_AND_ASSIGN(TIFFImageIO);

  using Self = TIFFImageIO;
  using Superclass = ImageIOBase;
  using Pointer = SmartPointer< Self >;

  using RGBPixelType = RGBPixel< unsigned short  >;
  using PaletteType = std::vector< RGBPixelType >;

  itkNewMacro(Self);

  itkTypeMacro(TIFFImageIO, ImageIOBase);

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

  bool CanReadFile(const char *) override;

  void ReadImageInformation() override;

  void Read(void *buffer) override;

  virtual void ReadVolume(void *buffer);

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

  bool CanWriteFile(const char *) override;

  void WriteImageInformation() override;

  void Write(const void *buffer) override;

  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
      }
  }

  itkSetClampMacro(JPEGQuality, int, 1, 100);
  itkGetConstMacro(JPEGQuality, int);

  itkGetConstReferenceMacro(ColorPalette, PaletteType);

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

  void InternalWrite(const void *buffer);

  void InitializeColors();

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

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

  unsigned int  GetFormat();

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

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

  // Read and returns the raw bytes of tag t
  void * ReadRawByteFromTag(unsigned int t, unsigned int & value_count);

  // Populate m_ColorPalette from the file palette
  // The palette corresponds to the one of the first page in case of multipage tiff
  void PopulateColorPalette();

  TIFFReaderInternal *m_InternalImage;

  void ReadTIFFTags();

  int m_Compression{ TIFFImageIO::PackBits };
  int m_JPEGQuality{ 75 };

  PaletteType m_ColorPalette;

private:
  void ReadCurrentPage(void *out, size_t pixelOffset);

  template <typename TComponent>
  void ReadGenericImage(void *out,
                        unsigned int width,
                        unsigned int height);

  template <typename TComponent>
    void RGBAImageToBuffer( void *out, const uint32_t *tempImage );

  template <typename TType>
    void PutGrayscale( TType *to, TType * from,
                       unsigned int xsize, unsigned int ysize,
                       unsigned int toskew, unsigned int fromskew );

  template <typename TType>
    void PutRGB_( TType *to, TType * from,
                  unsigned int xsize, unsigned int ysize,
                  unsigned int toskew, unsigned int fromskew );


  template <typename TType, typename TFromType>
    void PutPaletteGrayscale( TType *to, TFromType * from,
                              unsigned int xsize, unsigned int ysize,
                              unsigned int toskew, unsigned int fromskew );

  template <typename TType, typename TFromType>
    void PutPaletteRGB( TType *to, TFromType * from,
                        unsigned int xsize, unsigned int ysize,
                        unsigned int toskew, unsigned int fromskew );

    template <typename TType, typename TFromType>
      void PutPaletteScalar( TType *to, TFromType * from,
                          unsigned int xsize, unsigned int ysize,
                          unsigned int toskew, unsigned int fromskew );

  unsigned short *m_ColorRed;
  unsigned short *m_ColorGreen;
  unsigned short *m_ColorBlue;
  int             m_TotalColors{ -1 };
  unsigned int    m_ImageFormat{ TIFFImageIO::NOFORMAT };
};
} // end namespace itk

#endif // itkTIFFImageIO_h