itkMaskImageFilter.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 itkMaskImageFilter_h
#define itkMaskImageFilter_h

#include "itkBinaryGeneratorImageFilter.h"
#include "itkNumericTraits.h"
#include "itkVariableLengthVector.h"
#include "itkMath.h"

namespace itk
{
namespace Functor
{
template< typename TInput, typename TMask, typename TOutput = TInput >
class MaskInput
{
public:
  using AccumulatorType = typename NumericTraits< TInput >::AccumulateType;

  MaskInput()
  {
    m_MaskingValue = NumericTraits< TMask >::ZeroValue();
    InitializeOutsideValue( static_cast<TOutput*>( nullptr ) );
  }
  ~MaskInput() = default;
  bool operator!=(const MaskInput &) const
  {
    return false;
  }

  bool operator==(const MaskInput & other) const
  {
    return !( *this != other );
  }

  inline TOutput operator()(const TInput & A, const TMask & B) const
  {
    if ( B != m_MaskingValue )
      {
      return static_cast< TOutput >( A );
      }
    else
      {
      return m_OutsideValue;
      }
  }

  void SetOutsideValue(const TOutput & outsideValue)
  {
    m_OutsideValue = outsideValue;
  }

  const TOutput & GetOutsideValue() const
  {
    return m_OutsideValue;
  }

  void SetMaskingValue(const TMask & maskingValue)
  {
    m_MaskingValue = maskingValue;
  }

  const TMask & GetMaskingValue() const
  {
    return m_MaskingValue;
  }

private:

  template < typename TPixelType >
  void InitializeOutsideValue( TPixelType * )
  {
    this->m_OutsideValue = NumericTraits< TPixelType >::ZeroValue();
  }

  template < typename TValue >
  void InitializeOutsideValue( VariableLengthVector<TValue> * )
  {
    // set the outside value to be of zero length
    this->m_OutsideValue = VariableLengthVector< TValue >(0);
  }

  TOutput m_OutsideValue;
  TMask   m_MaskingValue;
};
}

template< typename TInputImage, typename TMaskImage, typename TOutputImage = TInputImage >
class MaskImageFilter:
  public
  BinaryGeneratorImageFilter< TInputImage, TMaskImage, TOutputImage >

{
public:
  ITK_DISALLOW_COPY_AND_ASSIGN(MaskImageFilter);

  using Self = MaskImageFilter;
  using Superclass = BinaryGeneratorImageFilter< TInputImage, TMaskImage, TOutputImage >;

  using FunctorType =  Functor::MaskInput< typename TInputImage::PixelType,
                                           typename TMaskImage::PixelType,
                                           typename TOutputImage::PixelType >;

  using Pointer = SmartPointer< Self >;
  using ConstPointer = SmartPointer< const Self >;

  itkNewMacro(Self);

  itkTypeMacro(MaskImageFilter,
               BinaryGeneratorImageFilter);

  using MaskImageType = TMaskImage;

  void SetMaskImage(const MaskImageType *maskImage)
  {
    // Process object is not const-correct so the const casting is required.
    this->SetNthInput( 1, const_cast< MaskImageType * >( maskImage ) );
  }
  const MaskImageType * GetMaskImage()
  {
    return static_cast<const MaskImageType*>(this->ProcessObject::GetInput(1));
  }

  void SetOutsideValue(const typename TOutputImage::PixelType & outsideValue)
  {
    if ( Math::NotExactlyEquals(this->GetOutsideValue(), outsideValue) )
      {
      this->Modified();
      this->GetFunctor().SetOutsideValue(outsideValue);
      }
  }

  const typename TOutputImage::PixelType & GetOutsideValue() const
  {
    return this->GetFunctor().GetOutsideValue();
  }

  void SetMaskingValue(const typename TMaskImage::PixelType & maskingValue)
  {
    if ( this->GetMaskingValue() != maskingValue )
      {
      this->Modified();
      this->GetFunctor().SetMaskingValue(maskingValue);
      }
  }

  const typename TMaskImage::PixelType & GetMaskingValue() const
  {
    return this->GetFunctor().GetMaskingValue();
  }

#ifdef ITK_USE_CONCEPT_CHECKING
  // Begin concept checking
  itkConceptMacro( MaskEqualityComparableCheck,
                   ( Concept::EqualityComparable< typename TMaskImage::PixelType > ) );
  itkConceptMacro( InputConvertibleToOutputCheck,
                   ( Concept::Convertible< typename TInputImage::PixelType,
                                           typename TOutputImage::PixelType > ) );
  // End concept checking
#endif

protected:
  MaskImageFilter() = default;
  ~MaskImageFilter() override = default;

  void PrintSelf(std::ostream & os, Indent indent) const override
  {
    Superclass::PrintSelf(os, indent);
    os << indent << "OutsideValue: "  << this->GetOutsideValue() << std::endl;
  }

  void BeforeThreadedGenerateData() override
    {
      using PixelType = typename TOutputImage::PixelType;
      this->CheckOutsideValue( static_cast<PixelType*>(nullptr) );

      this->SetFunctor(this->GetFunctor());
    }

private:
  itkGetConstReferenceMacro(Functor, FunctorType);
  FunctorType & GetFunctor() { return m_Functor; }

  FunctorType    m_Functor;

  template < typename TPixelType >
  void CheckOutsideValue( const TPixelType * ) {}

  template < typename TValue >
  void CheckOutsideValue( const VariableLengthVector< TValue > * )
  {
    // Check to see if the outside value contains only zeros. If so,
    // resize it to have the same number of zeros as the output
    // image. Otherwise, check that the number of components in the
    // outside value is the same as the number of components in the
    // output image. If not, throw an exception.
    VariableLengthVector< TValue > currentValue =
      this->GetFunctor().GetOutsideValue();
    VariableLengthVector< TValue > zeroVector( currentValue.GetSize() );
    zeroVector.Fill( NumericTraits< TValue >::ZeroValue() );

    if ( currentValue == zeroVector )
      {
      zeroVector.SetSize( this->GetOutput()->GetVectorLength() );
      zeroVector.Fill( NumericTraits< TValue >::ZeroValue() );
      this->GetFunctor().SetOutsideValue( zeroVector );
      }
    else if ( this->GetFunctor().GetOutsideValue().GetSize() !=
              this->GetOutput()->GetVectorLength() )
      {
      itkExceptionMacro(
        << "Number of components in OutsideValue: "
        <<  this->GetFunctor().GetOutsideValue().GetSize()
        << " is not the same as the "
        << "number of components in the image: "
        << this->GetOutput()->GetVectorLength());
      }
  }

};
} // end namespace itk

#endif