itkRGBPixel.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 __itkRGBPixel_h
#define __itkRGBPixel_h

// Undefine an eventual RGBPixel macro
#ifdef RGBPixel
#undef RGBPixel
#endif

#include "itkIndent.h"
#include "itkFixedArray.h"
#include "vnl/vnl_math.h"

namespace itk
{
template< typename TComponent = unsigned short >
class RGBPixel:public FixedArray< TComponent, 3 >
{
public:
  typedef RGBPixel                    Self;
  typedef FixedArray< TComponent, 3 > Superclass;

  typedef FixedArray< TComponent, 3 > BaseArray;

  itkStaticConstMacro(Dimension, unsigned int, 3);

  itkStaticConstMacro(Length, unsigned int, 3);

  typedef TComponent                                        ComponentType;
  typedef typename NumericTraits< ComponentType >::RealType LuminanceType;

  RGBPixel() {}

  RGBPixel (const ComponentType & r) { this->Fill(r); }

  template< class TRGBPixelValueType >
  RGBPixel(const RGBPixel< TRGBPixelValueType > & r):BaseArray(r) {}
  RGBPixel(const ComponentType r[3]):BaseArray(r) {}

  template< class TRGBPixelValueType >
  Self & operator=(const RGBPixel< TRGBPixelValueType > & r)
  {
    BaseArray::operator=(r);
    return *this;
  }

  Self & operator=(const ComponentType r[3]);

  Self operator+(const Self & vec) const;

  Self operator-(const Self & vec) const;

  const Self & operator+=(const Self & vec);

  const Self & operator-=(const Self & vec);

  Self operator *(const ComponentType & f) const;

  bool operator<(const Self & vec) const;

  bool operator==(const Self & vec) const;

  static unsigned int GetNumberOfComponents(){ return 3; }

  ComponentType GetNthComponent(int c) const { return this->operator[](c); }

  ComponentType GetScalarValue() const
  {
    return static_cast< ComponentType >( vcl_sqrt(
                                           static_cast< double >( this->operator[](0) )
                                           * static_cast< double >( this->operator[](0) )
                                           + static_cast< double >( this->operator[](1) )
                                           * static_cast< double >( this->operator[](1) )
                                           + static_cast< double >( this->operator[](2) )
                                           * static_cast< double >( this->operator[](2) ) ) );
  }

  void SetNthComponent(int c, const ComponentType & v) {  this->operator[](c) = v; }

  void SetRed(ComponentType red) { this->operator[](0) = red; }

  void SetGreen(ComponentType green) { this->operator[](1) = green; }

  void SetBlue(ComponentType blue) { this->operator[](2) = blue; }

  void Set(ComponentType red, ComponentType green, ComponentType blue)
  {
    this->operator[](0) = red;
    this->operator[](1) = green;
    this->operator[](2) = blue;
  }

  const ComponentType & GetRed(void) const { return this->operator[](0); }

  const ComponentType & GetGreen(void) const { return this->operator[](1); }

  const ComponentType & GetBlue(void) const { return this->operator[](2); }

  LuminanceType GetLuminance(void) const;
};

template< typename TComponent  >
ITK_EXPORT std::ostream & operator<<(std::ostream & os,
                                     const RGBPixel< TComponent > & c);

template< typename TComponent  >
ITK_EXPORT std::istream & operator>>(std::istream & is,
                                     RGBPixel< TComponent > & c);
} // end namespace itk

// Define instantiation macro for this template.
#define ITK_TEMPLATE_RGBPixel(_, EXPORT, TypeX, TypeY)        \
  namespace itk                                               \
  {                                                           \
  _( 1 ( class EXPORT RGBPixel< ITK_TEMPLATE_1 TypeX > ) )    \
  namespace Templates                                         \
  {                                                           \
  typedef RGBPixel< ITK_TEMPLATE_1 TypeX > RGBPixel##TypeY; \
  }                                                           \
  }

#if ITK_TEMPLATE_EXPLICIT
#include "Templates/itkRGBPixel+-.h"
#endif

//
// Numeric traits must be included after (optionally) including the explicit
// instantiations control of this class, in case the implicit instantiation
// needs to be disabled.
//
// NumericTraits must be included before (optionally) including the .hxx file,
// in case the .hxx requires to use NumericTraits.
//
#include "itkNumericTraitsRGBPixel.h"

#if ITK_TEMPLATE_TXX
#include "itkRGBPixel.hxx"
#endif

#endif