GrayscaleImage.hpp

Go to the documentation of this file.

/*
 * Copyright(c):
 * Signal Image and Communications (SIC) Department 
 * http://www.sic.sp2mi.univ-poitiers.fr/ 
 *  - University of Poitiers, France http://www.univ-poitiers.fr 
 *  - XLIM  Institute UMR CNRS 7252  http://www.xlim.fr/ 
 * 
 * and 
 * 
 * D2 Fluid, Thermic and Combustion 
 *  - University of Poitiers, France http://www.univ-poitiers.fr 
 *  - PPRIME Institute -  UPR CNRS 3346  http://www.pprime.fr
 *  - ISAE-ENSMA http://www.ensma.fr
 *
 * Contributor(s):
 * The SLIP team,
 * Benoit Tremblais <tremblais_AT_sic.univ-poitiers.fr>,
 * Laurent David <laurent.david_AT_lea.univ-poitiers.fr>, 
 * Ludovic Chatellier <ludovic.chatellier_AT_univ-poitiers.fr>, 
 * Lionel Thomas <lionel.thomas_AT_univ-poitiers.fr>, 
 * Denis Arrivault <arrivault_AT_sic.univ-poitiers.fr>, 
 * Julien Dombre <julien.dombre_AT_univ-poitiers.fr>.
 *
 * Description:
 * The Simple Library of Image Processing (SLIP) is a new image processing 
 * library. It is written in the C++ language following as much as possible 
 * the ISO/ANSI C++ standard. It is consequently compatible with any system  
 * satisfying the ANSI C++ complience. It works on different Unix , Linux ,  
 * Mircrosoft Windows and Mac OS X plateforms. SLIP is a research library that  
 * was created by the Signal, Image and Communications (SIC) departement of  
 * the XLIM, UMR 7252 CNRS Institute in collaboration with the Fluids, Thermic  
 * and Combustion departement of the P', UPR 3346 CNRS Institute of the  
 * University of Poitiers.
 * 
 * The SLIP Library source code has been registered to the APP (French Agency 
 * for the Protection of Programs) by the University of Poitiers and CNRS, 
 * under  registration number IDDN.FR.001.300034.000.S.P.2010.000.21000.

 * http://www.sic.sp2mi.univ-poitiers.fr/slip/
 *
 * This software is governed by the CeCILL-C license under French law and
 * abiding by the rules of distribution of free software.  You can  use, 
 * modify and/ or redistribute the software under the terms of the CeCILL-C 
 * license as circulated by CEA, CNRS and INRIA at the following URL 
 * http://www.cecill.info.
 * As a counterpart to the access to the source code and  rights to copy,
 * modify and redistribute granted by the license, users are provided only
 * with a limited warranty  and the software's author,  the holder of the
 * economic rights,  and the successive licensors  have only  limited
 * liability.
 * 
 * In this respect, the user's attention is drawn to the risks associated
 * with loading,  using,  modifying and/or developing or reproducing the
 * software by the user in light of its specific status of free software,
 * that may mean  that it is complicated to manipulate,  and  that  also
 * therefore means  that it is reserved for developers  and  experienced
 * professionals having in-depth computer knowledge. Users are therefore
 * encouraged to load and test the software's suitability as regards their
 * requirements in conditions enabling the security of their systems and/or
 * data to be ensured and,  more generally, to use and operate it in the 
 * same conditions as regards security. 
 *
 * The fact that you are presently reading this means that you have had
 * knowledge of the CeCILL-C license and that you accept its terms.
 */



#ifndef SLIP_GRAYSCALEIMAGE_HPP
#define SLIP_GRAYSCALEIMAGE_HPP

#include <iostream>
#include <iterator>
#include <cassert>
#include <numeric>
#include <cmath>
#include <string>
#include <cstddef>
//read/write image with ImageMagick
//breaking the ImageMagick dependency possibility
// Author : denis.arrivault\AT\inria.fr
// Date : 2013/04/05
// \since 1.4.0
#ifdef HAVE_MAGICK
#include <wand/magick_wand.h> 
#include <magick/api.h>
#endif
#include "Matrix.hpp"
#include "stride_iterator.hpp"
#include "iterator2d_box.hpp"
#include "iterator2d_range.hpp"
#include "apply.hpp"
#include "io_tools.hpp"

#include <boost/serialization/access.hpp>
#include <boost/serialization/split_member.hpp>
#include <boost/serialization/version.hpp>

namespace slip
{

template<class T>
class stride_iterator;

template<class T>
class iterator2d_box;


template<class T>
class const_iterator2d_box;

template<class T>
class const_iterator2d_range;

template <class T>
class DPoint2d;

template <class T>
class Point2d;

template <class T>
class Box2d;

template <class T>
class Range;

template <typename T>
class GrayscaleImage;

template <typename T>
class Matrix;

template <typename T>
std::ostream& operator<<(std::ostream & out, const slip::GrayscaleImage<T>& a);

template<typename T>
bool operator==(const slip::GrayscaleImage<T>& x, 
                                const slip::GrayscaleImage<T>& y);

template<typename T>
bool operator!=(const slip::GrayscaleImage<T>& x, 
                                const slip::GrayscaleImage<T>& y);

template<typename T>
bool operator<(const slip::GrayscaleImage<T>& x, 
                       const slip::GrayscaleImage<T>& y);

template<typename T>
bool operator>(const slip::GrayscaleImage<T>& x, 
                       const slip::GrayscaleImage<T>& y);

template<typename T>
bool operator<=(const slip::GrayscaleImage<T>& x, 
                                const slip::GrayscaleImage<T>& y);

template<typename T>
bool operator>=(const slip::GrayscaleImage<T>& x, 
                                const slip::GrayscaleImage<T>& y);

template <typename T>
class GrayscaleImage
{
public :

  typedef T value_type;
  typedef GrayscaleImage<T> self;
  typedef const GrayscaleImage<T> const_self;

  typedef value_type* pointer;
  typedef const value_type* const_pointer;
  typedef value_type& reference;
  typedef const value_type& const_reference;

  typedef ptrdiff_t difference_type;
  typedef std::size_t size_type;

  typedef pointer iterator;
  typedef const_pointer const_iterator;
  
  typedef std::reverse_iterator<iterator> reverse_iterator;
  typedef std::reverse_iterator<const_iterator> const_reverse_iterator;


  typedef pointer row_iterator;
  typedef const_pointer const_row_iterator;
  typedef slip::stride_iterator<pointer> col_iterator;
  typedef slip::stride_iterator<const_pointer> const_col_iterator;

 
  typedef typename slip::Matrix<T>::iterator2d iterator2d;
  typedef typename slip::Matrix<T>::const_iterator2d const_iterator2d;
  typedef slip::stride_iterator<pointer> row_range_iterator;
  typedef slip::stride_iterator<const_pointer> const_row_range_iterator;
  typedef slip::stride_iterator<col_iterator> col_range_iterator;
  typedef slip::stride_iterator<const_col_iterator> const_col_range_iterator;
  typedef typename slip::Matrix<T>::iterator2d_range iterator2d_range;
  typedef typename slip::Matrix<T>::const_iterator2d_range const_iterator2d_range;


  typedef std::reverse_iterator<iterator> reverse_row_iterator;
  typedef std::reverse_iterator<const_iterator> const_reverse_row_iterator;
  typedef std::reverse_iterator<col_iterator> reverse_col_iterator;
  typedef std::reverse_iterator<const_col_iterator> const_reverse_col_iterator;
  typedef std::reverse_iterator<iterator2d> reverse_iterator2d;
  typedef std::reverse_iterator<const_iterator2d> const_reverse_iterator2d;
  typedef std::reverse_iterator<row_range_iterator> reverse_row_range_iterator;
  typedef std::reverse_iterator<const_row_range_iterator> const_reverse_row_range_iterator;
  typedef std::reverse_iterator<col_range_iterator> reverse_col_range_iterator;
  typedef std::reverse_iterator<const_col_range_iterator> const_reverse_col_range_iterator;
  typedef std::reverse_iterator<iterator2d_range> reverse_iterator2d_range;
  typedef std::reverse_iterator<const_iterator2d_range> const_reverse_iterator2d_range;

 //default iterator of the container
  typedef iterator2d default_iterator;
  typedef const_iterator2d const_default_iterator;

  static const std::size_t DIM = 2;

public:

  GrayscaleImage();
 
  GrayscaleImage(const size_type height,
                                 const size_type width);
  
  GrayscaleImage(const size_type height,
                                 const size_type width, 
                                 const T& val);
 
  GrayscaleImage(const size_type height,
                                 const size_type width, 
                                 const T* val);
 

  template<typename InputIterator>
  GrayscaleImage(const size_type height,
                                 const size_type width, 
                                 InputIterator first,
                                 InputIterator last)
  {
    matrix_ = new slip::Matrix<T>(height,width,first,last);
  } 

  GrayscaleImage(const self& rhs);

  ~GrayscaleImage();
  

  void resize(const size_type height,
                      const size_type width,
                      const T& val = T());


 

 
  iterator begin();


  iterator end();

  const_iterator begin() const;

  
  const_iterator end() const;
  
  reverse_iterator rbegin();
  
  reverse_iterator rend();
  
  const_reverse_iterator rbegin() const;

  
  const_reverse_iterator rend() const;

 
  row_iterator row_begin(const size_type row);

  
  row_iterator row_end(const size_type row);


  const_row_iterator row_begin(const size_type row) const;


  const_row_iterator row_end(const size_type row) const;
  
  col_iterator col_begin(const size_type col);


  col_iterator col_end(const size_type col);

  const_col_iterator col_begin(const size_type col) const;



  const_col_iterator col_end(const size_type col) const;


  row_range_iterator row_begin(const size_type row,
                                                       const slip::Range<int>& range);



  row_range_iterator row_end(const size_type row,
                                                     const slip::Range<int>& range);


  const_row_range_iterator row_begin(const size_type row,
                                                                     const slip::Range<int>& range) const;


  const_row_range_iterator row_end(const size_type row,
                                                                   const slip::Range<int>& range) const;


  col_range_iterator col_begin(const size_type col,
                                                       const slip::Range<int>& range);

  col_range_iterator col_end(const size_type col,
                                                     const slip::Range<int>& range);




  const_col_range_iterator col_begin(const size_type col,
                                                                     const slip::Range<int>& range) const;

 
  const_col_range_iterator col_end(const size_type col,
                                                                   const slip::Range<int>& range) const;

  

  reverse_row_iterator row_rbegin(const size_type row);


  reverse_row_iterator row_rend(const size_type row);

  const_reverse_row_iterator row_rbegin(const size_type row) const;

  const_reverse_row_iterator row_rend(const size_type row) const;

  reverse_col_iterator col_rbegin(const size_type col);

  
  reverse_col_iterator col_rend(const size_type col);

  const_reverse_col_iterator col_rbegin(const size_type col) const;

    
  const_reverse_col_iterator col_rend(const size_type col) const;
 

  reverse_row_range_iterator row_rbegin(const size_type row,
                                                                                const slip::Range<int>& range);

 
  reverse_row_range_iterator row_rend(const size_type row,
                                                                      const slip::Range<int>& range);



  const_reverse_row_range_iterator row_rbegin(const size_type row,
                                                                                      const slip::Range<int>& range) const;


  const_reverse_row_range_iterator row_rend(const size_type row,
                                                                                    const slip::Range<int>& range) const;
 
 


  reverse_col_range_iterator col_rbegin(const size_type col,
                                                                                const slip::Range<int>& range);

  reverse_col_range_iterator col_rend(const size_type col,
                                                                      const slip::Range<int>& range);


  const_reverse_col_range_iterator 
  col_rbegin(const size_type col,
                     const slip::Range<int>& range) const;

 
  const_reverse_col_range_iterator col_rend(const size_type col,
                                                                                    const slip::Range<int>& range) const;


  iterator2d upper_left();
  
  
  iterator2d bottom_right();


  const_iterator2d upper_left() const;
  
 
  const_iterator2d bottom_right() const;

  iterator2d upper_left(const Box2d<int>& box);

 
  iterator2d bottom_right(const Box2d<int>& box);


  const_iterator2d upper_left(const Box2d<int>& box) const;

 
  const_iterator2d bottom_right(const Box2d<int>& box) const;


  iterator2d_range upper_left(const Range<int>& row_range,
                                                      const Range<int>& col_range);

  iterator2d_range bottom_right(const Range<int>& row_range,
                                                                const Range<int>& col_range);


  const_iterator2d_range upper_left(const Range<int>& row_range,
                                                                    const Range<int>& col_range) const;


  const_iterator2d_range bottom_right(const Range<int>& row_range,
                                                                      const Range<int>& col_range) const;


 


  iterator2d_range upper_left(const Range<int>& range);
 

  iterator2d_range bottom_right(const Range<int>& range);

 

  
  const_iterator2d_range upper_left(const Range<int>& range) const;

 

  const_iterator2d_range bottom_right(const Range<int>& range) const;

 
  reverse_iterator2d rupper_left();
  
  reverse_iterator2d rbottom_right();

  const_reverse_iterator2d rupper_left() const;
 
 
  const_reverse_iterator2d rbottom_right() const;
  

  reverse_iterator2d rupper_left(const Box2d<int>& box);

  reverse_iterator2d rbottom_right(const Box2d<int>& box);

  const_reverse_iterator2d rupper_left(const Box2d<int>& box) const;


  const_reverse_iterator2d rbottom_right(const Box2d<int>& box) const;

 
  reverse_iterator2d_range rupper_left(const Range<int>& row_range,
                                                                       const Range<int>& col_range);


 
  reverse_iterator2d_range rbottom_right(const Range<int>& row_range,
                                                                                 const Range<int>& col_range);


 
  const_reverse_iterator2d_range rupper_left(const Range<int>& row_range,
                                                                                     const Range<int>& col_range) const;

  const_reverse_iterator2d_range rbottom_right(const Range<int>& row_range,
                                                                                       const Range<int>& col_range) const;


 
  reverse_iterator2d_range rupper_left(const Range<int>& range);



  reverse_iterator2d_range rbottom_right(const Range<int>& range);
  

  const_reverse_iterator2d_range rupper_left(const Range<int>& range) const;


  const_reverse_iterator2d_range rbottom_right(const Range<int>& range) const;
  

  
  friend std::ostream& operator<< <>(std::ostream & out, const self& a);

  #ifdef HAVE_MAGICK

  void read(const std::string& file_path_name);

  void write(const std::string& file_path_name) const;
#endif

  void write_ascii(const std::string& file_path_name) const
  {
    slip::write_ascii_2d<self,value_type>(*this,file_path_name);
  }

  void read_ascii(const std::string& file_path_name)
  {
    slip::read_ascii_2d<self>(*this,file_path_name);
  }

  GrayscaleImage& operator=(const self & rhs);

  self& operator=(const T& val);

  

  void fill(const T& value)
  {
    std::fill_n(this->begin(),size(),value);
  } 
  
  void fill(const T* value)
  {
    std::copy(value,value + size(),this->begin());
  } 

  template<typename InputIterator>
  void fill(InputIterator first,
                    InputIterator last)
  {
    std::copy(first,last,this->begin());
  }
  friend bool operator== <>(const GrayscaleImage<T>& x, 
                                                    const GrayscaleImage<T>& y);

  friend bool operator!= <>(const GrayscaleImage<T>& x, 
                                                    const GrayscaleImage<T>& y);

  friend bool operator< <>(const GrayscaleImage<T>& x, 
                                                   const GrayscaleImage<T>& y);

  friend bool operator> <>(const GrayscaleImage<T>& x, 
                                                   const GrayscaleImage<T>& y);

  friend bool operator<= <>(const GrayscaleImage<T>& x, 
                                                    const GrayscaleImage<T>& y);

  friend bool operator>= <>(const GrayscaleImage<T>& x, 
                                                    const GrayscaleImage<T>& y);


  pointer operator[](const size_type i);

  const_pointer operator[](const size_type i) const;


  reference operator()(const size_type i,
                                       const size_type j);
 
  const_reference operator()(const size_type i,
                                                     const size_type j) const;

  reference operator()(const Point2d<size_type>& point2d);
 
  const_reference operator()(const Point2d<size_type>& point2d) const;


  self operator()(const Range<int>& row_range,
                                  const Range<int>& col_range);

  std::string name() const;
  
  size_type dim1() const;

  size_type rows() const;
  
  size_type height() const;
  
  size_type dim2() const;

  size_type columns() const;
 
  size_type cols() const;

  size_type width() const;

  size_type size() const;

  size_type max_size() const;

  bool empty()const;

  void swap(self& M);

  self& operator+=(const T& val);
  self& operator-=(const T& val);
  self& operator*=(const T& val);
  self& operator/=(const T& val);
//   self& operator%=(const T& val);
//   self& operator^=(const T& val);
//   self& operator&=(const T& val);
//   self& operator|=(const T& val);
//   self& operator<<=(const T& val);
//   self& operator>>=(const T& val);


  self  operator-() const;
  //self  operator!() const;

  

  self& operator+=(const self& rhs);
  self& operator-=(const self& rhs);
  self& operator*=(const self& rhs);
  self& operator/=(const self& rhs);
    

  T& min() const;


  T& max() const;

  T sum() const;

  GrayscaleImage<T>& apply(T (*fun)(T));

  GrayscaleImage<T>& apply(T (*fun)(const T&));


 private:
  slip::Matrix<T>* matrix_;

 private:
    friend class boost::serialization::access;
    template<class Archive>
    void save(Archive & ar, const unsigned int version) const
    {
      ar & this->matrix_;
    }
    template<class Archive>
    void load(Archive & ar, const unsigned int version)
    {
      ar & this->matrix_;
    }
    BOOST_SERIALIZATION_SPLIT_MEMBER();
};

  typedef slip::GrayscaleImage<double> GrayscaleImage_d;
  typedef slip::GrayscaleImage<float> GrayscaleImage_f;
  typedef slip::GrayscaleImage<long> GrayscaleImage_l;
  typedef slip::GrayscaleImage<unsigned long> GrayscaleImage_ul;
  typedef slip::GrayscaleImage<short> GrayscaleImage_s;
  typedef slip::GrayscaleImage<unsigned short> GrayscaleImage_us;
  typedef slip::GrayscaleImage<int> GrayscaleImage_i;
  typedef slip::GrayscaleImage<unsigned int> GrayscaleImage_ui;
  typedef slip::GrayscaleImage<char> GrayscaleImage_c;
  typedef slip::GrayscaleImage<unsigned char> GrayscaleImage_uc;


}//slip::

namespace slip{
template<typename T>
GrayscaleImage<T> operator+(const GrayscaleImage<T>& M1, 
                                                    const GrayscaleImage<T>& M2);

template<typename T>
GrayscaleImage<T> operator+(const GrayscaleImage<T>& M1, 
                                    const T& val);

  template<typename T>
  GrayscaleImage<T> operator+(const T& val, 
                                      const GrayscaleImage<T>& M1);
  
template<typename T>
GrayscaleImage<T> operator-(const GrayscaleImage<T>& M1, 
                                    const GrayscaleImage<T>& M2);

template<typename T>
GrayscaleImage<T> operator-(const GrayscaleImage<T>& M1, 
                                    const T& val);

  template<typename T>
  GrayscaleImage<T> operator-(const T& val, 
                                      const GrayscaleImage<T>& M1);
  
  template<typename T>
  GrayscaleImage<T> operator*(const GrayscaleImage<T>& M1, 
                                      const GrayscaleImage<T>& M2);

  template<typename T>
  GrayscaleImage<T> operator*(const GrayscaleImage<T>& M1, 
                                      const T& val);

  template<typename T>
  GrayscaleImage<T> operator*(const T& val, 
                                      const GrayscaleImage<T>& M1);
  
  template<typename T>
  GrayscaleImage<T> operator/(const GrayscaleImage<T>& M1, 
                                      const GrayscaleImage<T>& M2);

  template<typename T>
  GrayscaleImage<T> operator/(const GrayscaleImage<T>& M1, 
                                      const T& val);



  template<typename T>
  T& min(const GrayscaleImage<T>& M1);
  
  template<typename T>
  T& max(const GrayscaleImage<T>& M1);

}//slip::

namespace slip
{
  template<typename T>
  inline
  GrayscaleImage<T>::GrayscaleImage():
    matrix_(new slip::Matrix<T>())
  {}

  template<typename T>
  inline
  GrayscaleImage<T>::GrayscaleImage(const typename GrayscaleImage<T>::size_type height,
                                                                    const typename GrayscaleImage<T>::size_type width):
    matrix_(new slip::Matrix<T>(height,width))
  {}
  
  template<typename T>
  inline
  GrayscaleImage<T>::GrayscaleImage(const typename GrayscaleImage<T>::size_type height,
                                                                    const typename GrayscaleImage<T>::size_type width, 
                                                                    const T& val):
    matrix_(new slip::Matrix<T>(height,width,val))
  {}

  template<typename T>
  inline
  GrayscaleImage<T>::GrayscaleImage(const typename GrayscaleImage<T>::size_type height,
                                                                    const typename GrayscaleImage<T>::size_type width, 
                                                                    const T* val):
    matrix_(new slip::Matrix<T>(height,width,val))   
  {}
  
  template<typename T>
  inline
  GrayscaleImage<T>::GrayscaleImage(const GrayscaleImage<T>& rhs):
    matrix_(new slip::Matrix<T>((*rhs.matrix_)))
  {}

  template<typename T>
  inline
  GrayscaleImage<T>::~GrayscaleImage()
  {
    delete matrix_;
  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator=(const GrayscaleImage<T> & rhs)
  {
    if(this != &rhs)
      {
                *matrix_ = *(rhs.matrix_);
      }
    return *this;
  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator=(const T& val)
  {
    std::fill_n(matrix_->begin(),matrix_->size(),val);
    return *this;
  }
  
  template<typename T>
  inline
  void GrayscaleImage<T>::resize(const typename GrayscaleImage<T>::size_type height,
                                                                 const typename GrayscaleImage<T>::size_type width,
                                                                 const T& val)
  {
    matrix_->resize(height,width,val);
  }

 
  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator GrayscaleImage<T>::begin()
  {
    return matrix_->begin();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator GrayscaleImage<T>::end()
  {
    return matrix_->end();
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator GrayscaleImage<T>::begin() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->begin();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator GrayscaleImage<T>::end() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->end();
  }
  

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator GrayscaleImage<T>::rbegin()
  {
    return typename GrayscaleImage<T>::reverse_iterator(this->end());
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator GrayscaleImage<T>::rend()
  {
    return typename GrayscaleImage<T>::reverse_iterator(this->begin());
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator 
  GrayscaleImage<T>::rbegin() const
  {
    return typename GrayscaleImage<T>::const_reverse_iterator(this->end());
  }

  template<typename T>
  inline
  std::reverse_iterator<const T*> 
  GrayscaleImage<T>::rend() const
  {
    return std::reverse_iterator<const T*>(begin());
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::row_iterator 
  GrayscaleImage<T>::row_begin(const typename GrayscaleImage<T>::size_type row)
  {
    return matrix_->row_begin(row);
  }

 template<typename T>
 inline
 typename GrayscaleImage<T>::row_iterator 
 GrayscaleImage<T>::row_end(const typename GrayscaleImage<T>::size_type row)
 {
    return matrix_->row_end(row);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::col_iterator
  GrayscaleImage<T>::col_begin(const typename GrayscaleImage<T>::size_type col)
  {
    return matrix_->col_begin(col);
  }


  template<typename T>
  inline
  typename GrayscaleImage<T>::col_iterator 
  GrayscaleImage<T>::col_end(const typename GrayscaleImage<T>::size_type col)
  {
    return matrix_->col_end(col);
  }


 template<typename T>
 inline
 typename GrayscaleImage<T>::const_row_iterator 
 GrayscaleImage<T>::row_begin(const typename GrayscaleImage<T>::size_type row) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->row_begin(row);
  }

 template<typename T>
 inline
 typename GrayscaleImage<T>::const_row_iterator 
 GrayscaleImage<T>::row_end(const typename GrayscaleImage<T>::size_type row) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->row_end(row);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_col_iterator 
  GrayscaleImage<T>::col_begin(const typename GrayscaleImage<T>::size_type col) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->col_begin(col);
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_col_iterator
  GrayscaleImage<T>::col_end(const typename GrayscaleImage<T>::size_type col) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->col_end(col);
  }


  //
 template<typename T>
 inline
 typename GrayscaleImage<T>::reverse_row_iterator 
 GrayscaleImage<T>::row_rbegin(const typename GrayscaleImage<T>::size_type row)
  {
    return matrix_->row_rbegin(row);
  }
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_row_iterator  
  GrayscaleImage<T>::row_rbegin(const typename GrayscaleImage<T>::size_type row) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->row_rbegin(row);
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_row_iterator 
  GrayscaleImage<T>::row_rend(const typename GrayscaleImage<T>::size_type row)
  {
    return matrix_->row_rend(row);
  }
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_row_iterator  
  GrayscaleImage<T>::row_rend(const typename GrayscaleImage<T>::size_type row) const
  {
   slip::Matrix<T> const * tp(matrix_);
    return tp->row_rend(row);
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_col_iterator
  GrayscaleImage<T>::col_rbegin(const typename GrayscaleImage<T>::size_type col)
  {
    return matrix_->col_rbegin(col);
  }
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_col_iterator GrayscaleImage<T>::col_rbegin(const typename GrayscaleImage<T>::size_type col) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->col_rbegin(col);
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_col_iterator 
  GrayscaleImage<T>::col_rend(const typename GrayscaleImage<T>::size_type col)
  {
    return matrix_->col_rend(col);
  }
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_col_iterator
  GrayscaleImage<T>::col_rend(const typename GrayscaleImage<T>::size_type col) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->col_rend(col);
  }

   template<typename T>
  inline
  typename GrayscaleImage<T>::row_range_iterator 
  GrayscaleImage<T>::row_begin(const typename GrayscaleImage<T>::size_type row,
                                       const slip::Range<int>& range)
  {
    return matrix_->row_begin(row,range);
  }

   template<typename T>
  inline
   typename GrayscaleImage<T>::const_row_range_iterator 
   GrayscaleImage<T>::row_begin(const typename GrayscaleImage<T>::size_type row,
                                                const slip::Range<int>& range) const
   {
     slip::Matrix<T> const * tp(matrix_);
     return tp->row_begin(row,range);
   }

  template<typename T>
  inline
  typename GrayscaleImage<T>::col_range_iterator 
  GrayscaleImage<T>::col_begin(const typename GrayscaleImage<T>::size_type col,
                                       const slip::Range<int>& range)
  {
    return matrix_->col_begin(col,range);
  }

   template<typename T>
  inline
   typename GrayscaleImage<T>::const_col_range_iterator 
   GrayscaleImage<T>::col_begin(const typename GrayscaleImage<T>::size_type col,
                                                const slip::Range<int>& range) const
   {
     slip::Matrix<T> const * tp(matrix_);
    return tp->col_begin(col,range);
   }
  

  template<typename T>
  inline
  typename GrayscaleImage<T>::row_range_iterator 
  GrayscaleImage<T>::row_end(const typename GrayscaleImage<T>::size_type row,
                                       const slip::Range<int>& range)
  {
    return matrix_->row_end(row,range);
  }

   template<typename T>
  inline
   typename GrayscaleImage<T>::const_row_range_iterator 
   GrayscaleImage<T>::row_end(const typename GrayscaleImage<T>::size_type row,
                                                const slip::Range<int>& range) const
   {
     slip::Matrix<T> const * tp(matrix_);
     return tp->row_end(row,range);
   }

  template<typename T>
  inline
  typename GrayscaleImage<T>::col_range_iterator 
  GrayscaleImage<T>::col_end(const typename GrayscaleImage<T>::size_type col,
                                     const slip::Range<int>& range)
  {
    return matrix_->col_end(col,range);
  }

   template<typename T>
  inline
   typename GrayscaleImage<T>::const_col_range_iterator 
   GrayscaleImage<T>::col_end(const typename GrayscaleImage<T>::size_type col,
                                      const slip::Range<int>& range) const
   {
     slip::Matrix<T> const * tp(matrix_);
     return tp->col_end(col,range);
   }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_row_range_iterator 
  GrayscaleImage<T>::row_rbegin(const typename GrayscaleImage<T>::size_type row,
                                                const slip::Range<int>& range)
  {
     return typename GrayscaleImage<T>::reverse_row_range_iterator(this->row_end(row,range));
  }

 template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_row_range_iterator 
  GrayscaleImage<T>::row_rbegin(const typename GrayscaleImage<T>::size_type row,
                                                 const slip::Range<int>& range) const
  {
    return typename GrayscaleImage<T>::const_reverse_row_range_iterator(this->row_end(row,range));
  }


  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_col_range_iterator 
  GrayscaleImage<T>::col_rbegin(const typename GrayscaleImage<T>::size_type col,
                                                 const slip::Range<int>& range)
  {
    return typename GrayscaleImage<T>::reverse_col_range_iterator(this->col_end(col,range));
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_col_range_iterator 
  GrayscaleImage<T>::col_rbegin(const typename GrayscaleImage<T>::size_type col,
                                                 const slip::Range<int>& range) const
  {
    return typename GrayscaleImage<T>::const_reverse_col_range_iterator(this->col_end(col,range));
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_row_range_iterator 
  GrayscaleImage<T>::row_rend(const typename GrayscaleImage<T>::size_type row,
                                       const slip::Range<int>& range)
  {
    return typename GrayscaleImage<T>::reverse_row_range_iterator(this->row_begin(row,range));
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_row_range_iterator 
  GrayscaleImage<T>::row_rend(const typename GrayscaleImage<T>::size_type row,
                                                 const slip::Range<int>& range) const
  {
    return typename GrayscaleImage<T>::const_reverse_row_range_iterator(this->row_begin(row,range));
  }


  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_col_range_iterator 
  GrayscaleImage<T>::col_rend(const typename GrayscaleImage<T>::size_type col,
                                       const slip::Range<int>& range)
  {
    return typename GrayscaleImage<T>::reverse_col_range_iterator(this->col_begin(col,range));
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_col_range_iterator 
  GrayscaleImage<T>::col_rend(const typename GrayscaleImage<T>::size_type col,
                                       const slip::Range<int>& range) const
  {
    return typename GrayscaleImage<T>::const_reverse_col_range_iterator(this->col_begin(col,range));
  }




  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d GrayscaleImage<T>::upper_left()
  {
    return  matrix_->upper_left();
  }

   template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d GrayscaleImage<T>::upper_left() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->upper_left();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d GrayscaleImage<T>::bottom_right()
  {
    return matrix_->bottom_right();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d GrayscaleImage<T>::bottom_right() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->bottom_right();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d 
  GrayscaleImage<T>::upper_left(const Box2d<int>& box)
  {
    return matrix_->upper_left(box);
  }


  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d GrayscaleImage<T>::upper_left(const Box2d<int>& box) const
  {
   slip::Matrix<T> const * tp(matrix_);
    return tp->upper_left(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d 
  GrayscaleImage<T>::bottom_right(const Box2d<int>& box)
  {
    return matrix_->bottom_right(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d GrayscaleImage<T>::bottom_right(const Box2d<int>& box) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->bottom_right(box);
  }

   template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d_range 
  GrayscaleImage<T>::upper_left(const Range<int>& row_range,
                                                 const Range<int>& col_range)
  {
    return matrix_->upper_left(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d_range 
  GrayscaleImage<T>::upper_left(const Range<int>& row_range,
                                                const Range<int>& col_range) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->upper_left(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d_range 
  GrayscaleImage<T>::bottom_right(const Range<int>& row_range,
                                                  const Range<int>& col_range)
  {
    return matrix_->bottom_right(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d_range 
  GrayscaleImage<T>::bottom_right(const Range<int>& row_range,
                                                  const Range<int>& col_range) const
  {
   slip::Matrix<T> const * tp(matrix_);
    return tp->bottom_right(row_range,col_range);
  }

   template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d_range 
  GrayscaleImage<T>::upper_left(const Range<int>& range)
  {
    return matrix_->upper_left(range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d_range 
  GrayscaleImage<T>::upper_left(const Range<int>& range) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->upper_left(range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::iterator2d_range 
  GrayscaleImage<T>::bottom_right(const Range<int>& range)
  {
    return matrix_->bottom_right(range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_iterator2d_range 
  GrayscaleImage<T>::bottom_right(const Range<int>& range) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->bottom_right(range);
  }

  
    template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d 
  GrayscaleImage<T>::rbottom_right()
  {
    return matrix_->rbottom_right();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d 
  GrayscaleImage<T>::rbottom_right() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rbottom_right();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d 
  GrayscaleImage<T>::rupper_left()
  {
    return matrix_->rupper_left();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d 
  GrayscaleImage<T>::rupper_left() const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rupper_left();
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d 
  GrayscaleImage<T>::rbottom_right(const Box2d<int>& box)
  {
    return matrix_->rbottom_right(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d 
  GrayscaleImage<T>::rbottom_right(const Box2d<int>& box) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rbottom_right(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d 
  GrayscaleImage<T>::rupper_left(const Box2d<int>& box)
  {
    return matrix_->rupper_left(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d 
  GrayscaleImage<T>::rupper_left(const Box2d<int>& box) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rupper_left(box);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d_range 
  GrayscaleImage<T>::rupper_left(const Range<int>& row_range,
                                                  const Range<int>& col_range)
  {
    return matrix_->rupper_left(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d_range 
  GrayscaleImage<T>::rupper_left(const Range<int>& row_range,
                                                 const Range<int>& col_range) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rupper_left(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d_range 
  GrayscaleImage<T>::rbottom_right(const Range<int>& row_range,
                                                    const Range<int>& col_range)
  {
    return matrix_->rbottom_right(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d_range 
  GrayscaleImage<T>::rbottom_right(const Range<int>& row_range,
                                                    const Range<int>& col_range) const
  {
    slip::Matrix<T> const * tp(matrix_);
    return tp->rbottom_right(row_range,col_range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d_range 
  GrayscaleImage<T>::rupper_left(const Range<int>& range)
  {
    return this->rupper_left(range,range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d_range 
  GrayscaleImage<T>::rupper_left(const Range<int>& range) const
  {
    return this->rupper_left(range,range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::reverse_iterator2d_range 
  GrayscaleImage<T>::rbottom_right(const Range<int>& range)
  {
    return this->rbottom_right(range,range);
  }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reverse_iterator2d_range 
  GrayscaleImage<T>::rbottom_right(const Range<int>& range) const
  {
    return this->rbottom_right(range,range);
  }

  template <typename T>
  inline
  std::ostream& operator<<(std::ostream & out, 
                                                   const GrayscaleImage<T>& a)
  {
    out<<*(a.matrix_)<<std::endl;
    return out;
  }

  #ifdef HAVE_MAGICK
  template<>
  inline
  void GrayscaleImage<unsigned char>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_char(file_path_name,*this);
  }

   template<>
  inline
  void GrayscaleImage<short>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_short(file_path_name,*this);
  }

  template<>
  inline
  void GrayscaleImage<int>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_int(file_path_name,*this);
  }

  template<>
  inline
  void GrayscaleImage<long>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_long(file_path_name,*this);
  }

  template<>
  inline
  void GrayscaleImage<float>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_float(file_path_name,*this);
  }

  template<>
  inline
  void GrayscaleImage<double>::read(const std::string& file_path_name)
  {
    slip::read_magick_gray_double(file_path_name,*this);
  }
#endif

  template<>
  inline
  void GrayscaleImage<unsigned char>::write_ascii(const std::string& file_path_name) const
  {
    slip::write_ascii_2d<self,int>(*this,file_path_name); 
  }
#ifdef HAVE_MAGICK
  template<>
  inline
  void GrayscaleImage<unsigned char>::write(const std::string& file_path_name) const
  {
    slip::write_magick_gray_char(this->begin(),
                                                                 this->width(),this->height(),
                                                                 file_path_name);
  }

 template<>
  inline
  void GrayscaleImage<short>::write(const std::string& file_path_name) const
  {
    slip::write_magick_gray_short(this->begin(),
                                                                  this->width(),this->height(),
                                                                  file_path_name);
  }

  template<>
  inline
  void GrayscaleImage<int>::write(const std::string& file_path_name) const
  {
     slip::write_magick_gray_int(this->begin(),
                                                                 this->width(),this->height(),
                                                                 file_path_name);
  }

  template<>
  inline
  void GrayscaleImage<long>::write(const std::string& file_path_name) const
  {
      slip::write_magick_gray_long(this->begin(),
                                                                   this->width(),this->height(),
                                                                   file_path_name);
  }

  template<>
  inline
  void GrayscaleImage<float>::write(const std::string& file_path_name) const
  {
    slip::write_magick_gray_float(this->begin(),
                                                                  this->width(),this->height(),
                                                                  file_path_name);
  }

  template<>
  inline
  void GrayscaleImage<double>::write(const std::string& file_path_name) const
  {
    slip::write_magick_gray_double(this->begin(),
                                                                   this->width(),this->height(),
                                                                   file_path_name);
  }
#endif

  template<typename T>
  inline
  typename GrayscaleImage<T>::pointer 
  GrayscaleImage<T>::operator[](const typename GrayscaleImage<T>::size_type i)
  {
    return (*matrix_)[i];
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_pointer  
  GrayscaleImage<T>::operator[](const typename GrayscaleImage<T>::size_type i) const 
  {
    return (*matrix_)[i];
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::reference
  GrayscaleImage<T>::operator()(const typename GrayscaleImage<T>::size_type i,
                                                                const typename GrayscaleImage<T>::size_type j)
  {
    return (*matrix_)[i][j];
  }
  
  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reference 
  GrayscaleImage<T>::operator()(const typename GrayscaleImage<T>::size_type i,
                                                                const typename GrayscaleImage<T>::size_type j) const
  {
    return (*matrix_)[i][j];
  }

 template<typename T>
  inline
  typename GrayscaleImage<T>::reference 
  GrayscaleImage<T>::operator()(const Point2d<typename GrayscaleImage<T>::size_type>& point2d)
   {
     return (*matrix_)(point2d);
   }

  template<typename T>
  inline
  typename GrayscaleImage<T>::const_reference 
  GrayscaleImage<T>::operator()(const Point2d<typename GrayscaleImage<T>::size_type>& point2d) const
   {
     return (*matrix_)(point2d);
   }


  template<typename T>
  inline
  GrayscaleImage<T> 
  GrayscaleImage<T>::operator()(const Range<int>& row_range,
                                                 const Range<int>& col_range)
  {
    assert((*this)[0] != 0);
    assert(row_range.is_valid());
    assert(row_range.start() < int(this->dim2()));
    assert(row_range.stop()  < int(this->dim2()));
    assert(col_range.is_valid());
    assert(col_range.start() < int(this->dim1()));
    assert(col_range.stop()  < int(this->dim1()));
    std::size_t rows = row_range.iterations();
    std::size_t cols = col_range.iterations();
    return GrayscaleImage<T>(rows+1,cols+1,matrix_->upper_left(row_range,col_range),
                                       matrix_->bottom_right(row_range,col_range));
  } 
  

  template<typename T>
  inline
  std::string 
  GrayscaleImage<T>::name() const {return "GrayscaleImage";} 

  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::dim1() const {return matrix_->dim1();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::height() const {return matrix_->dim1();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::rows() const {return matrix_->dim1();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::dim2() const {return matrix_->dim2();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::width() const {return matrix_->dim2();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::columns() const {return matrix_->dim2();} 

  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::cols() const {return matrix_->dim2();} 
 
  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::size() const {return matrix_->size();}

  template<typename T>
  inline
  typename GrayscaleImage<T>::size_type 
  GrayscaleImage<T>::max_size() const 
  {
    return typename GrayscaleImage<T>::size_type(-1)/sizeof(T);
  }

  
  template<typename T>
  inline
  bool GrayscaleImage<T>::empty()const {return matrix_->empty();}

  template<typename T>
  inline
  void GrayscaleImage<T>::swap(GrayscaleImage<T>& M)
  {
    matrix_->swap(*(M.matrix_));
  }

 template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator+=(const T& val)
  {
    matrix_->operator+=(val);
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator-=(const T& val)
  {
    matrix_->operator-=(val);
    return *this;

  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator*=(const T& val)
  {
    matrix_->operator*=(val);
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator/=(const T& val)
  {
    matrix_->operator/=(val);
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T> GrayscaleImage<T>::operator-() const
  {
    *matrix_ = matrix_->operator-();
    return *this;
  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator+=(const GrayscaleImage<T>& rhs)
  {
    matrix_->operator+=(*(rhs.matrix_));
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator-=(const GrayscaleImage<T>& rhs)
  {
    matrix_->operator-=(*(rhs.matrix_));
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator*=(const GrayscaleImage<T>& rhs)
  {
    matrix_->operator*=(*(rhs.matrix_));
    return *this;
  }
  
  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::operator/=(const GrayscaleImage<T>& rhs)
  {
    matrix_->operator/=(*(rhs.matrix_));
    return *this;
  }
                

  template<typename T>
  inline
  T& GrayscaleImage<T>::min() const
  {
    return matrix_->min();
  }

  template<typename T>
  inline
  T& GrayscaleImage<T>::max() const
  {
    return matrix_->max();
  }

  template<typename T>
  inline
  T GrayscaleImage<T>::sum() const
  {
    return matrix_->sum();
  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::apply(T (*fun)(T))
  {
    matrix_->apply(fun);
    return *this;
  }

  template<typename T>
  inline
  GrayscaleImage<T>& GrayscaleImage<T>::apply(T (*fun)(const T&))
  {
    matrix_->apply(fun);
    return *this;
  }
  /* @{ */
 template<typename T>
  inline
  GrayscaleImage<T> operator+(const GrayscaleImage<T>& M1, 
                                                      const GrayscaleImage<T>& M2)
  {
    assert(M1.dim1() == M2.dim1());
    assert(M1.dim2() == M2.dim2());
    GrayscaleImage<T> tmp(M1.dim1(),M1.dim2());
    std::transform(M1.begin(),M1.end(),M2.begin(),tmp.begin(),std::plus<T>());
    return tmp;
  }

  template<typename T>
  inline
  GrayscaleImage<T> operator+(const GrayscaleImage<T>& M1, 
                                                      const T& val)
  {
    GrayscaleImage<T>  tmp = M1;
    tmp += val;
    return tmp;
  }

  template<typename T>
  inline
  GrayscaleImage<T> operator+(const T& val,
                                                      const GrayscaleImage<T>& M1)
  {
    return M1 + val;
  }


template<typename T>
inline
GrayscaleImage<T> operator-(const GrayscaleImage<T>& M1, 
                                                    const GrayscaleImage<T>& M2)
{
  assert(M1.dim1() == M2.dim1());
  assert(M1.dim2() == M2.dim2());
  GrayscaleImage<T> tmp(M1.dim1(),M1.dim2());
  std::transform(M1.begin(),M1.end(),M2.begin(),tmp.begin(),std::minus<T>());
  return tmp;
}

template<typename T>
inline
GrayscaleImage<T> operator-(const GrayscaleImage<T>& M1, 
                                                    const T& val)
{
  GrayscaleImage<T>  tmp = M1;
  tmp -= val;
  return tmp;
}

template<typename T>
inline
GrayscaleImage<T> operator-(const T& val,
                                                    const GrayscaleImage<T>& M1)
{
  return M1 - val;
}

template<typename T>
inline
GrayscaleImage<T> operator*(const GrayscaleImage<T>& M1, 
                                                    const GrayscaleImage<T>& M2)
{
  assert(M1.dim1() == M2.dim1());
  assert(M1.dim2() == M2.dim2());
  GrayscaleImage<T> tmp(M1.dim1(),M1.dim2());
  std::transform(M1.begin(),M1.end(),M2.begin(),tmp.begin(),std::multiplies<T>());
  return tmp;
}

template<typename T>
inline
GrayscaleImage<T> operator*(const GrayscaleImage<T>& M1, 
                                                    const T& val)
{
  GrayscaleImage<T>  tmp = M1;
  tmp *= val;
  return tmp;
}

template<typename T>
inline
GrayscaleImage<T> operator*(const T& val,
                                                    const GrayscaleImage<T>& M1)
{
  return M1 * val;
}

template<typename T>
inline
GrayscaleImage<T> operator/(const GrayscaleImage<T>& M1, 
                                                    const GrayscaleImage<T>& M2)
{
  assert(M1.dim1() == M2.dim1());
  assert(M1.dim2() == M2.dim2());
  GrayscaleImage<T> tmp(M1.dim1(),M1.dim2());
  std::transform(M1.begin(),M1.end(),M2.begin(),tmp.begin(),std::divides<T>());
  return tmp;
}

template<typename T>
inline
GrayscaleImage<T> operator/(const GrayscaleImage<T>& M1, 
                                    const T& val)
{
  GrayscaleImage<T>  tmp = M1;
  tmp /= val;
  return tmp;
}


/* @} */


template<typename T>
inline
T& min(const GrayscaleImage<T>& M1)
{
  return M1.min();
}
template<typename T>
inline
T& max(const GrayscaleImage<T>& M1)
{
  return M1.max();
}

  /* @{ */
template<typename T>
inline
bool operator==(const GrayscaleImage<T>& x, 
                                const GrayscaleImage<T>& y)
{
  return ( x.size() == y.size()
                   && std::equal(x.begin(),x.end(),y.begin())); 
}

template<typename T>
inline
bool operator!=(const GrayscaleImage<T>& x, 
                                const GrayscaleImage<T>& y)
{
  return !(x == y);
}
/* @} */

  /* @{ */
template<typename T>
inline
bool operator<(const GrayscaleImage<T>& x, 
                       const GrayscaleImage<T>& y)
{
  return std::lexicographical_compare(x.begin(), x.end(),
                                                                      y.begin(), y.end());
}

//MoreThanComparable
template<typename T>
inline
bool operator>(const GrayscaleImage<T>& x, 
                       const GrayscaleImage<T>& y)
{
  return (y < x);
}

//LessThanEqualComparable
template<typename T>
inline
bool operator<=(const GrayscaleImage<T>& x, 
                                const GrayscaleImage<T>& y)
{
  return !(y < x);
}

//MoreThanEqualComparable
template<typename T>
inline
bool operator>=(const GrayscaleImage<T>& x, 
                                const GrayscaleImage<T>& y)
{
  return !(x < y);
} 
/* @} */

}//slip::

#endif //SLIP_GRAYSCALEIMAGE_HPP