/*========================================================================= * * Copyright NumFOCUS * * 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 * * https://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 itkPNGImageIO_h #define itkPNGImageIO_h #include "ITKIOPNGExport.h" #include "itkImageIOBase.h" namespace itk { /** * \class PNGImageIO * * \brief ImageIO object for reading and writing PNG images * * Compression is support with only the default compressor. The * compression level option is supported in the range 0-9. * * \ingroup IOFilters * * \ingroup ITKIOPNG */ class ITKIOPNG_EXPORT PNGImageIO : public ImageIOBase { public: ITK_DISALLOW_COPY_AND_MOVE(PNGImageIO); /** Standard class type aliases. */ using Self = PNGImageIO; using Superclass = ImageIOBase; using Pointer = SmartPointer; using RGBPixelType = RGBPixel; using PaletteType = std::vector; /** Method for creation through the object factory. */ itkNewMacro(Self); /** \see LightObject::GetNameOfClass() */ itkOverrideGetNameOfClassMacro(PNGImageIO); /** Get a const ref to the palette of the image. In the case of non palette * image or ExpandRGBPalette set to true, a vector of size * 0 is returned */ itkGetConstReferenceMacro(ColorPalette, PaletteType); /** Set the palette of the image. */ void SetColorPalette(const PaletteType _arg) { if (this->m_ColorPalette != _arg) { this->m_ColorPalette = _arg; this->Modified(); } } /*-------- This part of the interface deals with reading data. ------ */ /** Determine the file type. Returns true if this ImageIO can read the * file specified. */ bool CanReadFile(const char *) override; /** Set the spacing and dimension information for the set filename. */ void ReadImageInformation() override; /** Reads the data from disk into the memory buffer provided. */ void Read(void * buffer) override; /** Reads 3D data from multiple files assuming one slice per file. */ virtual void ReadVolume(void * buffer); /*-------- This part of the interfaces deals with writing data. ----- */ /** Determine the file type. Returns true if this ImageIO can write the * file specified. */ bool CanWriteFile(const char *) override; /** Writes the spacing and dimensions of the image. * Assumes SetFileName has been called with a valid file name. */ void WriteImageInformation() override; /** Writes the data to disk from the memory buffer provided. Make sure * that the IORegion has been set properly. */ void Write(const void * buffer) override; protected: PNGImageIO(); ~PNGImageIO() override; void PrintSelf(std::ostream & os, Indent indent) const override; void WriteSlice(const std::string & fileName, const void * const buffer); PaletteType m_ColorPalette{}; }; } // end namespace itk #endif // itkPNGImageIO_h