itkConvolutionImageFilterBase.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 itkConvolutionImageFilterBase_h
#define itkConvolutionImageFilterBase_h
 
#include "itkImageToImageFilter.h"
#include "itkZeroFluxNeumannBoundaryCondition.h"
#include "ITKConvolutionExport.h"
 
namespace itk
{
class ConvolutionImageFilterBaseEnums
{
public:
  enum class ConvolutionImageFilterOutputRegion : uint8_t
  {
    SAME = 0,
    VALID
  };
};

extern ITKConvolution_EXPORT std::ostream &
operator<<(std::ostream & out, const ConvolutionImageFilterBaseEnums::ConvolutionImageFilterOutputRegion value);

template <typename TInputImage, typename TKernelImage = TInputImage, typename TOutputImage = TInputImage>
class ITK_TEMPLATE_EXPORT ConvolutionImageFilterBase : public ImageToImageFilter<TInputImage, TOutputImage>
{
public:
  ITK_DISALLOW_COPY_AND_MOVE(ConvolutionImageFilterBase);
 
  using Self = ConvolutionImageFilterBase;
  using Superclass = ImageToImageFilter<TInputImage, TOutputImage>;
  using Pointer = SmartPointer<Self>;
  using ConstPointer = SmartPointer<const Self>;

  itkOverrideGetNameOfClassMacro(ConvolutionImageFilterBase);

  static constexpr unsigned int ImageDimension = TInputImage::ImageDimension;
 
  using InputImageType = TInputImage;
  using OutputImageType = TOutputImage;
  using KernelImageType = TKernelImage;
  using InputPixelType = typename InputImageType::PixelType;
  using OutputPixelType = typename OutputImageType::PixelType;
  using KernelPixelType = typename KernelImageType::PixelType;
  using InputIndexType = typename InputImageType::IndexType;
  using OutputIndexType = typename OutputImageType::IndexType;
  using KernelIndexType = typename KernelImageType::IndexType;
  using InputSizeType = typename InputImageType::SizeType;
  using OutputSizeType = typename OutputImageType::SizeType;
  using KernelSizeType = typename KernelImageType::SizeType;
  using SizeValueType = typename InputSizeType::SizeValueType;
  using InputRegionType = typename InputImageType::RegionType;
  using OutputRegionType = typename OutputImageType::RegionType;
  using KernelRegionType = typename KernelImageType::RegionType;

  using BoundaryConditionType = ImageBoundaryCondition<TInputImage>;
#ifndef ITK_FUTURE_LEGACY_REMOVE
  using BoundaryConditionPointerType [[deprecated("Please just use `BoundaryConditionType *` instead!")]] =
    BoundaryConditionType *;
#endif
  using DefaultBoundaryConditionType = ZeroFluxNeumannBoundaryCondition<TInputImage>;

  itkSetMacro(BoundaryCondition, BoundaryConditionType *);
  itkGetConstMacro(BoundaryCondition, BoundaryConditionType *);
  itkSetInputMacro(KernelImage, KernelImageType);
  itkGetInputMacro(KernelImage, KernelImageType);
  itkSetMacro(Normalize, bool);
  itkGetConstMacro(Normalize, bool);
  itkBooleanMacro(Normalize);
  using OutputRegionModeEnum = ConvolutionImageFilterBaseEnums::ConvolutionImageFilterOutputRegion;
#if !defined(ITK_LEGACY_REMOVE)
  using OutputRegionModeType = ConvolutionImageFilterBaseEnums::ConvolutionImageFilterOutputRegion;
  // We need to expose the enum values at the class level
  // for backwards compatibility
  static constexpr OutputRegionModeEnum SAME = OutputRegionModeEnum::SAME;
  static constexpr OutputRegionModeEnum VALID = OutputRegionModeEnum::VALID;
#endif

  itkSetEnumMacro(OutputRegionMode, OutputRegionModeEnum);
  itkGetEnumMacro(OutputRegionMode, OutputRegionModeEnum);
  virtual void
  SetOutputRegionModeToSame();
  virtual void
  SetOutputRegionModeToValid();
protected:
  ConvolutionImageFilterBase();
  ~ConvolutionImageFilterBase() override = default;
 
  void
  PrintSelf(std::ostream & os, Indent indent) const override;

  void
  GenerateOutputInformation() override;

  OutputRegionType
  GetValidRegion() const;

  void
  VerifyInputInformation() const override
  {}
 
private:
  bool m_Normalize{ false };
 
  DefaultBoundaryConditionType m_DefaultBoundaryCondition{};
  BoundaryConditionType *      m_BoundaryCondition{};
 
  OutputRegionModeEnum m_OutputRegionMode{ ConvolutionImageFilterBaseEnums::ConvolutionImageFilterOutputRegion::SAME };
};
} // end namespace itk
 
#ifndef ITK_MANUAL_INSTANTIATION
#  include "itkConvolutionImageFilterBase.hxx"
#endif
 
#endif