iterator3d_box.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_ITERATOR3D_BOX_HPP
#define SLIP_ITERATOR3D_BOX_HPP

#include <iterator>
#include <cassert>

#include "DPoint2d.hpp"
#include "Point3d.hpp"
#include "DPoint3d.hpp"
#include "Box3d.hpp"
#include "iterator_types.hpp"
#include "iterator3d_plane.hpp"

namespace slip
{
  template <class Container3D>
  class iterator3d_box  
  {
  public:
    //typedef std::random_access_iterator_tag iterator_category;
    typedef std::random_access_iterator3d_tag iterator_category;
    typedef typename Container3D::value_type value_type;
    typedef DPoint3d<int> difference_type;
    typedef DPoint2d<int> diff2d;
    typedef typename Container3D::pointer pointer;
    typedef typename Container3D::reference reference;

    typedef iterator3d_box self;
    typedef typename Container3D::size_type size_type;

  
    iterator3d_box():
      cont3d_(0),pos_(0),x1_(0),x2_(0),x3_(0),box_(0,0,0,0,0,0)
    {}

    iterator3d_box(Container3D* c,
                                   const Box3d<int>& b):
      cont3d_(c),pos_((*c)[(b.front_upper_left())[0]][(b.front_upper_left())[1]] + (b.front_upper_left())[2]),x1_((b.front_upper_left())[0]),x2_((b.front_upper_left())[1]),x3_((b.front_upper_left())[2]),box_(b)
    {}

    iterator3d_box(const self& o):
      cont3d_(o.cont3d_),pos_(o.pos_),x1_(o.x1_),x2_(o.x2_),x3_(o.x3_),box_(o.box_)
    {}

    self& operator=(const self& o)
    {
      if(this != &o)
                {
                  this->cont3d_ = o.cont3d_;
                  this->pos_ = o.pos_;
                  this->x1_ = o.x1_;
                  this->x2_ = o.x2_;
                  this->x3_ = o.x3_;
                  this->box_ = o.box_;
                }
      return *this;
    }
    inline
    reference operator*()
    {
      return *pos_;
    }

 

    inline
    const reference operator*() const
    {
      return *pos_;
    }


    inline
    pointer operator->() const
    { 
      return &(operator*()); 
    }

    inline
    pointer operator->()
    { 
      return &(operator*()); 
    }

  
    inline
    self& operator++()
    {
      if(x3_ < (box_.back_bottom_right())[2])
                {
                  this->x3_++;
                  this->pos_++;
                }
      else if(x2_ < (box_.back_bottom_right())[1])
                {
                  this->x2_++;
                  this->x3_ = (box_.front_upper_left())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ < (box_.back_bottom_right())[0])
                {
                  this->x1_++;
                  this->x2_ = (box_.front_upper_left())[1];
                  this->x3_ = (box_.front_upper_left())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                  this->x1_ = (box_.back_bottom_right())[0] + 1;
                  this->x2_ = (box_.back_bottom_right())[1] + 1;
                  this->x3_ = (box_.back_bottom_right())[2] + 1;
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }

    inline
    self operator++(int)
    {
      self tmp = *this;
      ++(*this);
      return tmp;
    }

    inline
    self& operator--()
    {
      if(x3_ > (box_.front_upper_left())[2])
                {
                  this->x3_--;
                  this->pos_--;
                }
      else if (x2_ > (box_.front_upper_left())[1])
                {
                  this->x2_--;
                  this->x3_ = (box_.back_bottom_right())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if (x1_ > (box_.front_upper_left())[0])
                {
                  this->x1_--;
                  this->x2_ = (box_.back_bottom_right())[1];
                  this->x3_ = (box_.back_bottom_right())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                  this->x1_ = (box_.front_upper_left())[0] - 1;
                  this->x2_ = (box_.front_upper_left())[1] - 1;
                  this->x3_ = (box_.front_upper_left())[2] - 1;
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }

      return *this;
    }
  
    inline
    self operator--(int)
    {
      self tmp = *this;
      --(*this);
      return tmp;
    }

    inline
    friend bool operator==(const self& i1,
                                                   const self& i2)
    {
    
      return ( (i1.cont3d_ == i2.cont3d_) && (i1.pos_ == i2.pos_) 
                       && (i1.x1_ == i2.x1_) && (i1.x2_ == i2.x2_) && (i1.x3_ == i2.x3_));
    }

    inline
    friend bool operator!=(const self& i1,
                                                   const self& i2)
    {
      return ( (i1.cont3d_ != i2.cont3d_) || (i1.pos_ != i2.pos_)
                       || (i1.x1_ != i2.x1_) || (i1.x2_ != i2.x2_) || (i1.x3_ != i2.x3_));
    }
    inline
    friend bool operator<(const self& i1,
                                                  const self& i2)
    {
      
      return ( i1.pos_ < i2.pos_);
    }
    
    inline
    friend bool operator>(const self& i1,
                                                  const self& i2)
    {
      
      return (i2 < i1);
    }
    
    inline
    friend bool operator<=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i2 < i1);
    }
    
    inline
    friend bool operator>=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i1 < i2);
    }
    inline
    self& operator+=(const difference_type& d)
    {
      this->x1_ += d.dx1();
      this->x2_ += d.dx2();
      this->x3_ += d.dx3();
      this->pos_ = cont3d_->begin() + 
                (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }

 
  
    inline
    self& operator-=(const difference_type& d)
    {
      this->x1_ -= d.dx1();
      this->x2_ -= d.dx2();
      this->x3_ -= d.dx3();
      this->pos_ = cont3d_->begin() + 
                (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
  

   
    inline
    self operator+(const difference_type& d)
    {
      self tmp = *this;
      tmp += d;
      return tmp;
    }
  
    inline
    self operator-(const difference_type& d)
    {
      self tmp = *this;
      tmp -= d;
      return tmp;
    }

    inline
    friend difference_type operator-(const self& i1,
                                                                     const self& i2)
    {
      return difference_type(int(i1.x1_ - i2.x1_),int(i1.x2_ - i2.x2_),int(i1.x3_ - i2.x3_));
    }
  
  
    inline
    reference operator[](difference_type d)
    {
      return (*cont3d_)[this->x1_+d.dx1()][this->x2_+d.dx2()][this->x3_+d.dx3()];
    }

    inline
    pointer operator[](diff2d d)
    {
      return (*cont3d_)[this->x1_+ d.dx1()][this->x2_ + d.dx2()];
    }
 
    inline
    pointer* operator[](int n)
    {
      return (*cont3d_)[this->x1_+ n];
    }

 

    inline
    const pointer* operator[](int n) const
    {
      return (*cont3d_)[this->x1_+ n];
    }
    
    inline
    typename Container3D::slice_iterator slice_begin(size_type row, size_type col)
    {
      return cont3d_->slice_begin(this->box_.front_upper_left()[1] + row, this->box_.front_upper_left()[2] + col) +  this->box_.front_upper_left()[0];
    }

    inline
    typename Container3D::slice_iterator slice_end(size_type row, size_type col)
    {
      return this->slice_begin(row,col) + this->box_.depth();
    }


    inline
    typename Container3D::row_iterator row_begin(size_type slice, size_type row)
    {
      return cont3d_->row_begin(this->box_.front_upper_left()[0] + slice, this->box_.front_upper_left()[1] + row) + this->box_.front_upper_left()[2];
    }

    inline
    typename Container3D::row_iterator row_end(size_type slice, size_type row)
    {
      return this->row_begin(slice,row) + this->box_.width();
    }

    inline
    typename Container3D::col_iterator col_begin(size_type slice, size_type col)
    {
      return cont3d_->col_begin(this->box_.front_upper_left()[0] + slice, this->box_.front_upper_left()[2] + col) +  this->box_.front_upper_left()[1];
    }

    inline
    typename Container3D::col_iterator col_end(size_type slice, size_type col)
    {
      return this->col_begin(slice,col) + this->box_.height();
    }

    inline
    typename Container3D::iterator2d plane_upper_left(const slip::PLANE_ORIENTATION p, const size_type xp)
    {
      if(p==0)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[1],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[1],this->box_.back_bottom_right()[2]);
                  return cont3d_->plane_upper_left(p,this->box_.front_upper_left()[0] + xp,b);
                }
      if(p==1)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[2]);
                  return cont3d_->plane_upper_left(p,this->box_.front_upper_left()[1] + xp,b);
                } 
      slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[1],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[1]);
      return cont3d_->plane_upper_left(p,this->box_.front_upper_left()[2] + xp,b);
     }

    inline
    typename Container3D::iterator2d plane_bottom_right(const slip::PLANE_ORIENTATION p, const size_type xp)
    {
      if(p==0)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[1],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[1],this->box_.back_bottom_right()[2]);
                  return cont3d_->plane_bottom_right(p,this->box_.front_upper_left()[0] + xp,b);
                }
      if(p==1)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[2]);
                  return cont3d_->plane_bottom_right(p,this->box_.front_upper_left()[1] + xp,b);
                } 
      slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[1],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[1]);
      return cont3d_->plane_bottom_right(p,this->box_.front_upper_left()[2] + xp,b);
     }

 

    inline
    int x1() const
    {
      return this->x1_;
    }
    inline
    int k() const
    {
      return this->x1_;
    }
    inline
    int x2() const
    {
      return this->x2_;
    }
    inline
    int i() const
    {
      return this->x2_;
    }
    inline
    int x3() const
    {
      return this->x3_;
    }
    inline
    int j() const
    {
      return this->x3_;
    }
  
  private: 
    Container3D* cont3d_; // pointer to the 3d container
    pointer pos_;         // linear position within the container
    int x1_;              // first subscript position 
    int x2_;              // second subscript position
    int x3_;              // third subscript position
    Box3d<int> box_;      // box to iterate 
  };

  
  template <class Container3D>
  class const_iterator3d_box  
  {
  public:
    //typedef std::random_access_iterator_tag iterator_category;
    typedef std::random_access_iterator3d_tag iterator_category;
    typedef typename Container3D::value_type value_type;
    typedef DPoint2d<int> diff2d;
    typedef DPoint3d<int> difference_type;
    typedef typename Container3D::const_pointer pointer;
    typedef typename Container3D::const_reference reference;

    typedef const_iterator3d_box self;

    typedef typename Container3D::size_type size_type;
  
    const_iterator3d_box():
      cont3d_(0),pos_(0),x1_(0),x2_(0),x3_(0),box_(0,0,0,0,0,0)
    {}

    const_iterator3d_box(Container3D* c, const Box3d<int>& b):
      cont3d_(c),pos_((*c)[(b.front_upper_left())[0]][(b.front_upper_left())[1]] + (b.front_upper_left())[2])
      ,x1_((b.front_upper_left())[0]),x2_((b.front_upper_left())[1]),x3_((b.front_upper_left())[2]),box_(b)
    {}
    
    const_iterator3d_box(const self& o):
      cont3d_(o.cont3d_),pos_(o.pos_),x1_(o.x1_),x2_(o.x2_),x3_(o.x3_),box_(o.box_)
    {}

    self& operator=(const self& o)
    {
      if(this != &o)
                {
                  this->cont3d_ = o.cont3d_;
                  this->pos_ = o.pos_;
                  this->x1_ = o.x1_;
                  this->x2_ = o.x2_;
                  this->x3_ = o.x3_;
                  this->box_ = o.box_;
                }
      return *this;
    }
    inline
    reference operator*() const
    {
      return *pos_;
    }


    inline
    pointer operator->() const
    { 
      return &(operator*()); 
    }

  
    inline
    self& operator++()
    {
      if(x3_ < (box_.back_bottom_right())[2])
                {
                  this->x3_++;
                  this->pos_++;
                }
      else if(x2_ < (box_.back_bottom_right())[1])
                {
                  this->x2_++;
                  this->x3_ = (box_.front_upper_left())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if(x1_ < (box_.back_bottom_right())[0])
                {
                  this->x1_++;
                  this->x2_ = (box_.front_upper_left())[1];
                  this->x3_ = (box_.front_upper_left())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                  this->x1_ = (box_.back_bottom_right())[0] + 1;
                  this->x2_ = (box_.back_bottom_right())[1] + 1;
                  this->x3_ = (box_.back_bottom_right())[2] + 1;
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }

    inline
    self operator++(int)
    {
      self tmp = *this;
      ++(*this);
      return tmp;
    }

    inline
    self& operator--()
    {
      if(x3_ > (box_.front_upper_left())[2])
                {
                  this->x3_--;
                  this->pos_--;
                }
      else if (x2_ > (box_.front_upper_left())[1])
                {
                  this->x2_--;
                  this->x3_ = (box_.back_bottom_right())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else if (x1_ > (box_.front_upper_left())[0])
                {
                  this->x1_--;
                  this->x2_ = (box_.back_bottom_right())[1];
                  this->x3_ = (box_.back_bottom_right())[2];
                  this->pos_ = cont3d_->begin() + 
                    (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                    (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      else
                {
                 this->x1_ = (box_.front_upper_left())[0] - 1;
                 this->x2_ = (box_.front_upper_left())[1] - 1;
                 this->x3_ = (box_.front_upper_left())[2] - 1;
                 this->pos_ = cont3d_->begin() + 
                   (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                   (this->x2_* int(cont3d_->cols())) + this->x3_;
                }
      return *this;
    }
  
    inline
    self operator--(int)
    {
      self tmp = *this;
      --(*this);
      return tmp;
    }

    inline
    friend bool operator==(const self& i1,
                                                   const self& i2)
    {
    
      return ( (i1.cont3d_ == i2.cont3d_) && (i1.pos_ == i2.pos_) 
                       && (i1.x1_ == i2.x1_) && (i1.x2_ == i2.x2_) && (i1.x3_ == i2.x3_) );
    }

    inline
    friend bool operator!=(const self& i1,
                                                   const self& i2)
    {
      return ( (i1.cont3d_ != i2.cont3d_) || (i1.pos_ != i2.pos_)
                       || (i1.x1_ != i2.x1_) || (i1.x2_ != i2.x2_) || (i1.x3_ != i2.x3_) );
    }
    inline
    friend bool operator<(const self& i1,
                                                  const self& i2)
    {
      
      return ( i1.pos_ < i2.pos_);
    }
    
    inline
    friend bool operator>(const self& i1,
                                                  const self& i2)
    {
      
      return (i2 < i1);
    }
    
    inline
    friend bool operator<=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i2 < i1);
    }
    
    inline
    friend bool operator>=(const self& i1,
                                                   const self& i2)
    {
      
      return  !(i1 < i2);
    }
    inline
    self& operator+=(const difference_type& d)
    {
      this->x1_ += d.dx1();
      this->x2_ += d.dx2();
      this->x3_ += d.dx3();
      this->pos_ = cont3d_->begin() + 
                (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }

 
  
    inline
    self& operator-=(const difference_type& d)
    {
      this->x1_ -= d.dx1();
      this->x2_ -= d.dx2();
      this->x3_ -= d.dx3();
      this->pos_ = cont3d_->begin() + 
                (this->x1_ * int(cont3d_->rows() * int(cont3d_->cols()))) + 
                (this->x2_* int(cont3d_->cols())) + this->x3_;
      return *this;
    }
  

   
    inline
    self operator+(const difference_type& d)
    {
      self tmp = *this;
      tmp += d;
      return tmp;
    }

   
    inline
    self operator-(const difference_type& d)
    {
      self tmp = *this;
      tmp -= d;
      return tmp;
    }

 
    inline
    friend difference_type operator-(const self& i1,
                                                                     const self& i2)
    {
      return difference_type(int(i1.x1_ - i2.x1_),int(i1.x2_ - i2.x2_),int(i1.x3_ - i2.x3_));
    }
   
    inline
    reference operator[](difference_type d) const
    {
      return (*cont3d_)[this->x1_+d.dx1()][this->x2_+d.dx2()][this->x3_+d.dx3()];
    }

    inline
    pointer operator[](diff2d d) const
    {
      return (*cont3d_)[this->x1_+ d.dx1()][this->x2_ + d.dx2()];
    }

    
    inline
    pointer* operator[](int n) const
    {
      return (*cont3d_)[this->x1_+ n];
    }

    inline
    typename Container3D::const_slice_iterator slice_begin(size_type row, size_type col) const
    {
      Container3D const * tp(cont3d_);
      return tp->slice_begin(this->box_.front_upper_left()[1] + row, this->box_.front_upper_left()[2] + col) +  this->box_.front_upper_left()[0];
    }

    inline
    typename Container3D::const_slice_iterator slice_end(size_type row, size_type col) const
    {
     Container3D const * tp(cont3d_);
     return this->slice_begin(row,col) + this->box_.depth();
    }

    inline
    typename Container3D::const_row_iterator row_begin(size_t slice, size_type row) const
    {
      Container3D const * tp(cont3d_);
      return tp->row_begin(this->box_.front_upper_left()[0] + slice, this->box_.front_upper_left()[1] + row) + this->box_.front_upper_left()[2];
    }

 
    inline
    typename Container3D::const_row_iterator row_end(size_t slice, size_type row) const
    {
      return this->row_begin(slice,row) + this->box_.width();
    }

 
  
    inline
    typename Container3D::const_col_iterator col_begin(size_t slice, size_type col) const
    {
      Container3D const * tp(cont3d_);
      return tp->col_begin(this->box_.front_upper_left()[0] + slice, this->box_.front_upper_left()[2] + col) +  this->box_.front_upper_left()[1];
    }


  inline
    typename Container3D::const_col_iterator col_end(size_t slice, size_type col) const
    {
      return this->col_begin(slice,col) + this->box_.height();
    }

    inline
    typename Container3D::const_iterator2d plane_upper_left(const slip::PLANE_ORIENTATION p, const size_type xp)
    {
      Container3D const * tp(cont3d_);
      if(p==0)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[1],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[1],this->box_.back_bottom_right()[2]);
                  return tp->plane_upper_left(p,this->box_.front_upper_left()[0] + xp,b);
                }
      if(p==1)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[2]);
                  return tp->plane_upper_left(p,this->box_.front_upper_left()[1] + xp,b);
                } 
      slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[1],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[1]);
      return tp->plane_upper_left(p,this->box_.front_upper_left()[2] + xp,b);
    }

    inline
    typename Container3D::const_iterator2d plane_bottom_right(const slip::PLANE_ORIENTATION p, const size_type xp)
    {
      Container3D const * tp(cont3d_);
      if(p==0)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[1],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[1],this->box_.back_bottom_right()[2]);
                  return tp->plane_bottom_right(p,this->box_.front_upper_left()[0] + xp,b);
                }
      if(p==1)
                {
                  slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[2],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[2]);
                  return tp->plane_bottom_right(p,this->box_.front_upper_left()[1] + xp,b);
                } 
      slip::Box2d<int> b(this->box_.front_upper_left()[0],this->box_.front_upper_left()[1],this->box_.back_bottom_right()[0],this->box_.back_bottom_right()[1]);
      return tp->plane_bottom_right(p,this->box_.front_upper_left()[2] + xp,b);
     }

 
  
    inline
    int x1() const
    {
      return this->x1_;
    }
    inline
    int k() const
    {
      return this->x1_;
    }
    inline
    int x2() const
    {
      return this->x2_;
    }
    inline
    int i() const
    {
      return this->x2_;
    }
    inline
    int x3() const
    {
      return this->x3_;
    }
    inline
    int j() const
    {
      return this->x3_;
    }
    
  private: 
    Container3D* cont3d_; // pointer to the 3d container
    pointer pos_;         // linear position within the container
    int x1_;              // first subscript position 
    int x2_;              // second subscript position
    int x3_;
    Box3d<int> box_;      // box to iterate 
  };


 
}//slip::

#endif //SLIP_ITERATOR3D_BOX_HPP