Boost GIL


position_iterator.hpp
1//
2// Copyright 2005-2007 Adobe Systems Incorporated
3//
4// Distributed under the Boost Software License, Version 1.0
5// See accompanying file LICENSE_1_0.txt or copy at
6// http://www.boost.org/LICENSE_1_0.txt
7//
8#ifndef BOOST_GIL_POSITION_ITERATOR_HPP
9#define BOOST_GIL_POSITION_ITERATOR_HPP
10
11#include <boost/gil/locator.hpp>
12
13#include <boost/stl_interfaces/iterator_interface.hpp>
14
15#include <type_traits>
16
17namespace boost { namespace gil {
18
23
30template <typename Deref, int Dim>
31class position_iterator : public stl_interfaces::iterator_interface<
32#if !BOOST_STL_INTERFACES_USE_DEDUCED_THIS
33 position_iterator<Deref,Dim>,
34#endif
35 std::random_access_iterator_tag,
36 typename Deref::value_type,
37 typename Deref::reference,
38 typename Deref::value_type*,
39 typename Deref::argument_type::template axis<Dim>::coord_t>
40{
41public:
42 using parent_t = stl_interfaces::iterator_interface<
43#if !BOOST_STL_INTERFACES_USE_DEDUCED_THIS
45#endif
46 std::random_access_iterator_tag,
47 typename Deref::value_type,
48 typename Deref::reference,
49 typename Deref::value_type*,
50 typename Deref::argument_type::template axis<Dim>::coord_t>;
51
52 using difference_type = typename parent_t::difference_type;
53 using reference = typename parent_t::reference;
54 using iterator_category = typename parent_t::iterator_concept;
55
56 using point_t = typename Deref::argument_type;
57
59 position_iterator(point_t const& p, point_t const& step, Deref const& d) : _p(p), _step(step), _d(d) {}
60
61 position_iterator(position_iterator const& p) : _p(p._p), _step(p._step), _d(p._d) {}
62
63 template <typename D>
64 position_iterator(position_iterator<D,Dim> const& p) : _p(p._p), _step(p._step), _d(p._d) {}
65
66 auto operator=(position_iterator const& p) -> position_iterator&
67 {
68 _p=p._p;
69 _d=p._d;
70 _step=p._step;
71 return *this;
72 }
73
74 auto pos() const -> point_t const& { return _p; }
75 auto step() const -> point_t const& { return _step; }
76 auto deref_fn() const -> Deref const& { return _d; }
77
78 void set_step(difference_type s) { _step[Dim]=s; }
79
80 constexpr auto operator*() const noexcept -> reference { return dereference(); }
81
82 constexpr auto operator+=(difference_type d) noexcept -> position_iterator& { advance(d); return *this; }
83
84 constexpr auto operator++() noexcept -> position_iterator& { increment(); return *this; }
85 constexpr auto operator--() noexcept -> position_iterator& { decrement(); return *this; }
86
87 constexpr auto operator++(int) noexcept -> position_iterator { auto tmp = *this; increment(); return tmp; }
88 constexpr auto operator--(int) noexcept -> position_iterator { auto tmp = *this; decrement(); return tmp; }
89
90 constexpr auto operator-(position_iterator other) const noexcept { return -distance_to(other); }
91
92 constexpr bool operator==(position_iterator other) const noexcept { return equal(other); }
93
94private:
95 point_t _p, _step;
96 Deref _d;
97
98 template <typename DE, int DI> friend class position_iterator;
99 friend struct boost::stl_interfaces::access;
100 reference dereference() const { return _d(_p); }
101 void increment() { _p[Dim]+=_step[Dim]; }
102 void decrement() { _p[Dim]-=_step[Dim]; }
103 void advance(difference_type d) { _p[Dim]+=d*_step[Dim]; }
104
105 difference_type distance_to(const position_iterator& it) const { return (it._p[Dim]-_p[Dim])/_step[Dim]; }
106 bool equal(const position_iterator& it) const { return _p==it._p; }
107};
108
109template <typename Deref,int Dim>
110struct const_iterator_type<position_iterator<Deref,Dim> > {
112};
113
114template <typename Deref, int Dim>
115struct iterator_is_mutable<position_iterator<Deref, Dim>>
116 : std::integral_constant<bool, Deref::is_mutable>
117{
118};
119
121// PixelBasedConcept
123
124template <typename Deref,int Dim>
125struct color_space_type<position_iterator<Deref,Dim> > : public color_space_type<typename Deref::value_type> {};
126
127template <typename Deref,int Dim>
128struct channel_mapping_type<position_iterator<Deref,Dim> > : public channel_mapping_type<typename Deref::value_type> {};
129
130template <typename Deref,int Dim>
131struct is_planar<position_iterator<Deref, Dim>> : std::false_type {};
132
133template <typename Deref,int Dim>
134struct channel_type<position_iterator<Deref,Dim> > : public channel_type<typename Deref::value_type> {};
135
137// HasDynamicXStepTypeConcept
139
140template <typename Deref,int Dim>
141struct dynamic_x_step_type<position_iterator<Deref,Dim> > {
142 using type = position_iterator<Deref,Dim>;
143};
144
145} } // namespace boost::gil
146
147#endif
An iterator that remembers its current X,Y position and invokes a function object with it upon derefe...
Definition position_iterator.hpp:40
defined(BOOST_NO_CXX17_HDR_MEMORY_RESOURCE)
Definition algorithm.hpp:36
Returns the type of an iterator just like the input iterator, except operating over immutable values.
Definition pixel_iterator.hpp:40