itkGiftiMeshIO.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  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 itkGiftiMeshIO_h
#define itkGiftiMeshIO_h
#include "ITKIOMeshGiftiExport.h"
 
#include <memory>
#include "itkMapContainer.h"
#include "itkMatrix.h"
#include "itkMeshIOBase.h"
#include "itkRGBAPixel.h"
 
#include <fstream>
#include <string>
 
namespace itk
{
 
class ITKIOMeshGifti_EXPORT GiftiMeshIO : public MeshIOBase
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(GiftiMeshIO);

  using Self = GiftiMeshIO;
  using Superclass = MeshIOBase;
  using ConstPointer = SmartPointer<const Self>;
  using Pointer = SmartPointer<Self>;
 
  using SizeValueType = Superclass::SizeValueType;
  using DirectionType = Matrix<double, 4, 4>;
  using RGBAPixelType = RGBAPixel<float>;
  using LabelColorContainer = MapContainer<int, RGBAPixelType>;
  using LabelNameContainer = MapContainer<int, std::string>;
  using LabelColorContainerPointer = LabelColorContainer::Pointer;
  using LabelNameContainerPointer = LabelNameContainer::Pointer;

  itkNewMacro(Self);

  itkOverrideGetNameOfClassMacro(GiftiMeshIO);
 
  itkGetConstMacro(ReadPointData, bool);
  itkSetMacro(ReadPointData, bool);
  itkBooleanMacro(ReadPointData);
 
  void
  SetDirection(const DirectionType & direction);
 
  itkGetConstReferenceMacro(Direction, DirectionType);
 
  LabelColorContainerPointer
  GetLabelColorTable();
  LabelNameContainerPointer
  GetLabelNameTable();
  void
  SetLabelColorTable(const LabelColorContainer * colorMap);
  void
  SetLabelNameTable(const LabelNameContainer * labelMap);
 
  /*-------- This part of the interfaces deals with reading data. ----- */

  bool
  CanReadFile(const char * fileName) override;

  void
  ReadMeshInformation() override;

  void
  ReadPoints(void * buffer) override;
 
  void
  ReadCells(void * buffer) override;
 
  void
  ReadPointData(void * buffer) override;
 
  void
  ReadCellData(void * buffer) override;
 
  /*-------- This part of the interfaces deals with writing data. ----- */

  bool
  CanWriteFile(const char * fileName) override;

  void
  WriteMeshInformation() override;

  void
  WritePoints(void * buffer) override;
 
  void
  WriteCells(void * buffer) override;
 
  void
  WritePointData(void * buffer) override;
 
  void
  WriteCellData(void * buffer) override;
 
  void
  Write() override;
 
protected:
  GiftiMeshIO();
  ~GiftiMeshIO() override;
 
  void
  PrintSelf(std::ostream & os, Indent indent) const override;
 
  template <typename TInput, typename TOutput>
  void
  ConvertBuffer(TInput * input, TOutput * output, SizeValueType numberOfElements)
  {
    if (input && output)
    {
      for (SizeValueType ii = 0; ii < numberOfElements; ++ii)
      {
        output[ii] = static_cast<TOutput>(input[ii]);
      }
    }
  }
 
private:
  // This proxy class provides a gifti_image pointer interface to the internal implementation
  // of itk::GiftiImageIO, while hiding the gifticlib interface from the external ITK interface.
  class GiftiImageProxy;
 
  // Note that it is essential that m_GiftiImageHolder is defined before m_GiftiImage, to ensure that
  // m_GiftiImage can directly get a proxy from m_GiftiImageHolder during GiftiImageIO construction.
  const std::unique_ptr<GiftiImageProxy> m_GiftiImageHolder;
 
  GiftiImageProxy & m_GiftiImage;
 
  bool          m_ReadPointData{};
  DirectionType m_Direction{};
 
  // Translate (G|N)ifti datatypes to IOComponentEnum
  IOComponentEnum
  GetComponentTypeFromGifti(int datatype);
 
  // Translate (G|N)ifti datatypes to IOPixelEnum
  IOPixelEnum
  GetPixelTypeFromGifti(int datatype);
 
  int
  GetNumberOfPixelComponentsFromGifti(int datatype);
};
} // end namespace itk
 
#endif