boost/gil
2
0
Fork 0
mirror of https://github.com/boostorg/gil.git synced 2026-01-25 18:22:16 +00:00
Code Issues Projects Releases Wiki Activity
Files
43e8aef5bd0bd032f628401be21fbdf232e82b58
gil/develop/doc/html/reference/locator_8hpp_source.html
github-actions[bot] 3b73200ee1 deploy: 49d9276706
2025-04-04 16:28:54 +00:00

345 lines
60 KiB
HTML
Raw Blame History

<!-- HTML header for doxygen 1.8.13-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Generic Image Library: locator.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-boost.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div class="boost-header">
<table border="0" cellpadding="7" cellspacing="0" width="100%" summary="header">
<tr>
<td valign="top" width="300">
<h3><a href="../index.html"><img alt="Boost GIL" src="../_static/gil.png" border="0"></a></h3>
</td>
<td ><h1 align="center"><a href="../index.html"></a></h1></td>
<td></td>
</tr>
</table>
</div>
<hr/>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- Generated by Doxygen 1.9.8 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */
</script>
<div id="main-nav"></div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(document).ready(function() { init_codefold(0); });
/* @license-end */
</script>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_1878a3f4746a95c6aad317458cc7ef80.html">boost</a></li><li class="navelem"><a class="el" href="dir_df4750f408086f9b9c1b5ee4251365ff.html">gil</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle"><div class="title">locator.hpp</div></div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno"> 1</span><span class="comment">//</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno"> 2</span><span class="comment">// Copyright 2005-2007 Adobe Systems Incorporated</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno"> 3</span><span class="comment">//</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno"> 4</span><span class="comment">// Distributed under the Boost Software License, Version 1.0</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno"> 5</span><span class="comment">// See accompanying file LICENSE_1_0.txt or copy at</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno"> 6</span><span class="comment">// http://www.boost.org/LICENSE_1_0.txt</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno"> 7</span><span class="comment">//</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno"> 8</span><span class="preprocessor">#ifndef BOOST_GIL_LOCATOR_HPP</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno"> 9</span><span class="preprocessor">#define BOOST_GIL_LOCATOR_HPP</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno"> 10</span> </div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno"> 11</span><span class="preprocessor">#include &lt;boost/gil/step_iterator.hpp&gt;</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno"> 12</span><span class="preprocessor">#include &lt;boost/gil/point.hpp&gt;</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno"> 13</span> </div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno"> 14</span><span class="preprocessor">#include &lt;boost/assert.hpp&gt;</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno"> 15</span> </div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno"> 16</span><span class="preprocessor">#include &lt;cstddef&gt;</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno"> 17</span> </div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno"> 18</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceboost.html">boost</a> { <span class="keyword">namespace </span>gil {</div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno"> 19</span> </div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno"> 21</span> </div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno"> 22</span><span class="comment">//forward declarations</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno"> 23</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> P&gt; std::ptrdiff_t memunit_step(<span class="keyword">const</span> P*);</div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno"> 24</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> P&gt; P* memunit_advanced(<span class="keyword">const</span> P* p, std::ptrdiff_t diff);</div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno"> 25</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> P&gt; P&amp; memunit_advanced_ref(P* p, std::ptrdiff_t diff);</div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno"> 26</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Iterator, <span class="keyword">typename</span> D&gt; <span class="keyword">struct </span>iterator_add_deref;</div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno"> 27</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">class </span>point;</div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span><span class="keyword">namespace </span>detail {</div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span> <span class="comment">// helper class specialized for each axis of pixel_2d_locator</span></div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span> <span class="keyword">template</span> &lt;std::<span class="keywordtype">size_t</span> D, <span class="keyword">typename</span> Loc&gt; <span class="keyword">class </span>locator_axis;</div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno"> 31</span>}</div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span> </div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">struct </span>channel_type;</div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">struct </span>color_space_type;</div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">struct </span>channel_mapping_type;</div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">struct </span>is_planar;</div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt; <span class="keyword">struct </span>num_channels;</div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span> </div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno"> 42</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> LocatorOrView&gt;</div>
<div class="foldopen" id="foldopen00043" data-start="{" data-end="};">
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno"><a class="line" href="structboost_1_1gil_1_1transposed__type.html"> 43</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structboost_1_1gil_1_1transposed__type.html">transposed_type</a></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno"> 44</span>{</div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno"> 45</span> <span class="keyword">using </span>type = LocatorOrView;</div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno"> 46</span>};</div>
</div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno"> 47</span> </div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno"> 106</span> </div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno"> 107</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc, <span class="keyword">typename</span> XIterator, <span class="keyword">typename</span> YIterator&gt; <span class="comment">// The concrete subclass, the X-iterator and the Y-iterator</span></div>
<div class="foldopen" id="foldopen00108" data-start="{" data-end="};">
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno"><a class="line" href="classboost_1_1gil_1_1pixel__2d__locator__base.html"> 108</a></span><span class="keyword">class </span><a class="code hl_class" href="classboost_1_1gil_1_1pixel__2d__locator__base.html">pixel_2d_locator_base</a></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span>{</div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno"> 111</span> <span class="keyword">using </span>x_iterator = XIterator;</div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno"> 112</span> <span class="keyword">using </span>y_iterator = YIterator;</div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno"> 113</span> </div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno"> 114</span> <span class="comment">// aliasesrequired by ConstRandomAccessNDLocatorConcept</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno"> 115</span> <span class="keyword">static</span> <span class="keyword">const</span> std::size_t num_dimensions=2;</div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno"> 116</span> <span class="keyword">using </span>value_type = <span class="keyword">typename</span> std::iterator_traits&lt;x_iterator&gt;::value_type;</div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno"> 117</span> <span class="keyword">using </span>reference = <span class="keyword">typename</span> std::iterator_traits&lt;x_iterator&gt;::reference; <span class="comment">// result of dereferencing</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno"> 118</span> <span class="keyword">using </span>coord_t = <span class="keyword">typename</span> std::iterator_traits&lt;x_iterator&gt;::difference_type; <span class="comment">// 1D difference type (same for all dimensions)</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno"> 119</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a> = <a class="code hl_class" href="classboost_1_1gil_1_1point.html">point&lt;coord_t&gt;</a>; <span class="comment">// result of operator-(locator,locator)</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno"> 120</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a> = <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>;</div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno"> 121</span> <span class="keyword">template</span> &lt;std::<span class="keywordtype">size_t</span> D&gt; <span class="keyword">struct </span>axis</div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno"> 122</span> {</div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno"> 123</span> <span class="keyword">using </span>coord_t = <span class="keyword">typename</span> detail::locator_axis&lt;D,Loc&gt;::coord_t;</div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno"> 124</span> <span class="keyword">using </span>iterator = <span class="keyword">typename</span> detail::locator_axis&lt;D,Loc&gt;::iterator;</div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno"> 125</span> };</div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno"> 126</span> </div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno"> 127</span><span class="comment">// aliases required by ConstRandomAccess2DLocatorConcept</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno"> 128</span> <span class="keyword">using </span>x_coord_t = <span class="keyword">typename</span> point_t::template axis&lt;0&gt;::coord_t;</div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno"> 129</span> <span class="keyword">using </span>y_coord_t = <span class="keyword">typename</span> point_t::template axis&lt;1&gt;::coord_t;</div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno"> 130</span> </div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno"> 131</span> <span class="keywordtype">bool</span> operator!=(<span class="keyword">const</span> Loc&amp; p)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !(concrete()==p); }</div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno"> 132</span> </div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno"> 133</span> x_iterator x_at(x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=<a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a>(dx,dy); <span class="keywordflow">return</span> tmp.x(); }</div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno"> 134</span> x_iterator x_at(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=d; <span class="keywordflow">return</span> tmp.x(); }</div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno"> 135</span> y_iterator y_at(x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=<a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a>(dx,dy); <span class="keywordflow">return</span> tmp.y(); }</div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno"> 136</span> y_iterator y_at(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=d; <span class="keywordflow">return</span> tmp.y(); }</div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno"> 137</span> Loc xy_at(x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=<a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a>(dx,dy); <span class="keywordflow">return</span> tmp; }</div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno"> 138</span> Loc xy_at(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ Loc tmp=concrete(); tmp+=d; <span class="keywordflow">return</span> tmp; }</div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno"> 139</span> </div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno"> 140</span> <span class="keyword">template</span> &lt;std::<span class="keywordtype">size_t</span> D&gt; <span class="keyword">typename</span> axis&lt;D&gt;::iterator&amp; axis_iterator() { <span class="keywordflow">return</span> detail::locator_axis&lt;D,Loc&gt;()(concrete()); }</div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno"> 141</span> <span class="keyword">template</span> &lt;std::<span class="keywordtype">size_t</span> D&gt; <span class="keyword">typename</span> axis&lt;D&gt;::iterator <span class="keyword">const</span>&amp; axis_iterator()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> detail::locator_axis&lt;D,Loc&gt;()(concrete()); }</div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno"> 142</span> <span class="keyword">template</span> &lt;std::<span class="keywordtype">size_t</span> D&gt; <span class="keyword">typename</span> axis&lt;D&gt;::iterator axis_iterator(<a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a> <span class="keyword">const</span>&amp; p)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> detail::locator_axis&lt;D,Loc&gt;()(concrete(),p); }</div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno"> 143</span> </div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno"> 144</span> reference operator()(x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> *x_at(dx,dy); }</div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno"> 145</span> reference operator[](<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> *x_at(d.x,d.y); }</div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno"> 146</span> </div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno"> 147</span> reference operator*()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> *concrete().x(); }</div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno"> 148</span> </div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno"> 149</span> Loc&amp; operator+=(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d) { concrete().x()+=d.x; concrete().y()+=d.y; <span class="keywordflow">return</span> concrete(); }</div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno"> 150</span> Loc&amp; operator-=(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d) { concrete().x()-=d.x; concrete().y()-=d.y; <span class="keywordflow">return</span> concrete(); }</div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno"> 151</span> </div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno"> 152</span> Loc operator+(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> xy_at(d); }</div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno"> 153</span> Loc operator-(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> xy_at(-d); }</div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno"> 154</span> </div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno"> 155</span> <span class="comment">// Some locators can cache 2D coordinates for faster subsequent access. By default there is no caching</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno"> 156</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1point.html">cached_location_t</a> = <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>;</div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno"> 157</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">cached_location_t</a> cache_location(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> d; }</div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno"> 158</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">cached_location_t</a> cache_location(x_coord_t dx, y_coord_t dy)<span class="keyword">const </span>{ <span class="keywordflow">return</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">difference_type</a>(dx,dy); }</div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno"> 159</span> </div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno"> 160</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno"> 161</span> Loc&amp; concrete() { <span class="keywordflow">return</span> (Loc&amp;)*<span class="keyword">this</span>; }</div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno"> 162</span> <span class="keyword">const</span> Loc&amp; concrete()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> (<span class="keyword">const</span> Loc&amp;)*<span class="keyword">this</span>; }</div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno"> 163</span> </div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno"> 164</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> X&gt; <span class="keyword">friend</span> <span class="keyword">class </span>pixel_2d_locator;</div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno"> 165</span>};</div>
</div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno"> 166</span> </div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno"> 167</span><span class="comment">// helper classes for each axis of pixel_2d_locator_base</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno"> 168</span><span class="keyword">namespace </span>detail {</div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno"> 169</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc&gt;</div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno"> 170</span> <span class="keyword">class </span>locator_axis&lt;0,Loc&gt; {</div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno"> 171</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1point.html">point_t</a> = <span class="keyword">typename</span> Loc::point_t;</div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno"> 172</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno"> 173</span> <span class="keyword">using </span>coord_t = <span class="keyword">typename</span> point_t::template axis&lt;0&gt;::coord_t;</div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno"> 174</span> <span class="keyword">using </span>iterator = <span class="keyword">typename</span> Loc::x_iterator;</div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno"> 175</span> </div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno"> 176</span> <span class="keyword">inline</span> iterator&amp; operator()( Loc&amp; loc)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.x(); }</div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno"> 177</span> <span class="keyword">inline</span> iterator <span class="keyword">const</span>&amp; operator()(<span class="keyword">const</span> Loc&amp; loc)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.x(); }</div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno"> 178</span> <span class="keyword">inline</span> iterator operator()( Loc&amp; loc, point_t <span class="keyword">const</span>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.x_at(d); }</div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno"> 179</span> <span class="keyword">inline</span> iterator operator()(<span class="keyword">const</span> Loc&amp; loc, point_t <span class="keyword">const</span>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.x_at(d); }</div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno"> 180</span> };</div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno"> 181</span> </div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno"> 182</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc&gt;</div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno"> 183</span> <span class="keyword">class </span>locator_axis&lt;1,Loc&gt; {</div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno"> 184</span> <span class="keyword">using </span>point_t = <span class="keyword">typename</span> Loc::point_t;</div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno"> 185</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno"> 186</span> <span class="keyword">using </span>coord_t = <span class="keyword">typename</span> point_t::template axis&lt;1&gt;::coord_t;</div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno"> 187</span> <span class="keyword">using </span>iterator = <span class="keyword">typename</span> Loc::y_iterator;</div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno"> 188</span> </div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno"> 189</span> <span class="keyword">inline</span> iterator&amp; operator()( Loc&amp; loc)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.y(); }</div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno"> 190</span> <span class="keyword">inline</span> iterator <span class="keyword">const</span>&amp; operator()(<span class="keyword">const</span> Loc&amp; loc)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.y(); }</div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno"> 191</span> <span class="keyword">inline</span> iterator operator()( Loc&amp; loc, point_t <span class="keyword">const</span>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.y_at(d); }</div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno"> 192</span> <span class="keyword">inline</span> iterator operator()(<span class="keyword">const</span> Loc&amp; loc, point_t <span class="keyword">const</span>&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> loc.y_at(d); }</div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno"> 193</span> };</div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno"> 194</span>}</div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno"> 195</span> </div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno"> 196</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc, <span class="keyword">typename</span> XIt, <span class="keyword">typename</span> YIt&gt;</div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno"> 197</span><span class="keyword">struct </span>channel_type&lt;pixel_2d_locator_base&lt;Loc,XIt,YIt&gt; &gt; : <span class="keyword">public</span> channel_type&lt;XIt&gt; {};</div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno"> 198</span> </div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno"> 199</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc, <span class="keyword">typename</span> XIt, <span class="keyword">typename</span> YIt&gt;</div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno"> 200</span><span class="keyword">struct </span>color_space_type&lt;pixel_2d_locator_base&lt;Loc,XIt,YIt&gt; &gt; : <span class="keyword">public</span> color_space_type&lt;XIt&gt; {};</div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno"> 201</span> </div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno"> 202</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc, <span class="keyword">typename</span> XIt, <span class="keyword">typename</span> YIt&gt;</div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno"> 203</span><span class="keyword">struct </span>channel_mapping_type&lt;pixel_2d_locator_base&lt;Loc,XIt,YIt&gt; &gt; : <span class="keyword">public</span> channel_mapping_type&lt;XIt&gt; {};</div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno"> 204</span> </div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno"> 205</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> Loc, <span class="keyword">typename</span> XIt, <span class="keyword">typename</span> YIt&gt;</div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno"> 206</span><span class="keyword">struct </span>is_planar&lt;pixel_2d_locator_base&lt;Loc,XIt,YIt&gt; &gt; : <span class="keyword">public</span> is_planar&lt;XIt&gt; {};</div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno"> 207</span> </div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno"> 228</span> </div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno"> 229</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> StepIterator&gt;</div>
<div class="foldopen" id="foldopen00230" data-start="{" data-end="};">
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno"><a class="line" href="classboost_1_1gil_1_1memory__based__2d__locator.html"> 230</a></span><span class="keyword">class </span><a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a> : <span class="keyword">public</span> <a class="code hl_class" href="classboost_1_1gil_1_1pixel__2d__locator__base.html">pixel_2d_locator_base</a>&lt;memory_based_2d_locator&lt;StepIterator&gt;, typename iterator_adaptor_get_base&lt;StepIterator&gt;::type, StepIterator&gt; {</div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno"> 231</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a> = <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;StepIterator&gt;</a>;</div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno"> 232</span> BOOST_GIL_CLASS_REQUIRE(StepIterator, boost::gil, <a class="code hl_struct" href="structboost_1_1gil_1_1_step_iterator_concept.html">StepIteratorConcept</a>)</div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno"> 233</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno"> 234</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1pixel__2d__locator__base.html">parent_t</a> = <a class="code hl_class" href="classboost_1_1gil_1_1pixel__2d__locator__base.html">pixel_2d_locator_base&lt;memory_based_2d_locator&lt;StepIterator&gt;</a>, <span class="keyword">typename</span> <a class="code hl_struct" href="structboost_1_1gil_1_1iterator__adaptor__get__base.html">iterator_adaptor_get_base&lt;StepIterator&gt;::type</a>, StepIterator&gt;;</div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno"> 235</span> <span class="keyword">using </span><a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">const_t</a> = <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;typename const_iterator_type&lt;StepIterator&gt;::type</a>&gt;; <span class="comment">// same as this type, but over const values</span></div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno"> 236</span> </div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno"> 237</span> <span class="keyword">using </span>coord_t = <span class="keyword">typename</span> parent_t::coord_t;</div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno"> 238</span> <span class="keyword">using </span>x_coord_t = <span class="keyword">typename</span> parent_t::x_coord_t;</div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno"> 239</span> <span class="keyword">using </span>y_coord_t = <span class="keyword">typename</span> parent_t::y_coord_t;</div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno"> 240</span> <span class="keyword">using </span>x_iterator = <span class="keyword">typename</span> parent_t::x_iterator;</div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno"> 241</span> <span class="keyword">using </span>y_iterator = <span class="keyword">typename</span> parent_t::y_iterator;</div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno"> 242</span> <span class="keyword">using </span>difference_type = <span class="keyword">typename</span> <a class="code hl_class" href="classboost_1_1gil_1_1point.html">parent_t::difference_type</a>;</div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno"> 243</span> <span class="keyword">using </span>reference = <span class="keyword">typename</span> parent_t::reference;</div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno"> 244</span> </div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno"> 245</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Deref&gt; <span class="keyword">struct </span>add_deref</div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno"> 246</span> {</div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno"> 247</span> <span class="keyword">using </span>type = <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;typename iterator_add_deref&lt;StepIterator,Deref&gt;::type</a>&gt;;</div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno"> 248</span> <span class="keyword">static</span> type make(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;StepIterator&gt;</a>&amp; loc, <span class="keyword">const</span> Deref&amp; nderef) {</div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno"> 249</span> <span class="keywordflow">return</span> type(<a class="code hl_struct" href="structboost_1_1gil_1_1iterator__add__deref.html">iterator_add_deref&lt;StepIterator,Deref&gt;::make</a>(loc.y(),nderef));</div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno"> 250</span> }</div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno"> 251</span> };</div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno"> 252</span> </div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno"> 253</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>() {}</div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno"> 254</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(<span class="keyword">const</span> StepIterator&amp; yit) : _p(yit) {}</div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno"> 255</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt; <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;SI&gt;</a>&amp; loc, coord_t y_step) : _p(loc.x(), loc.row_size()*y_step) {}</div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno"> 256</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt; <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;SI&gt;</a>&amp; loc, coord_t x_step, coord_t y_step, <span class="keywordtype">bool</span> transpose=<span class="keyword">false</span>)</div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno"> 257</span> : _p(make_step_iterator(loc.x(),(transpose ? loc.row_size() : loc.pixel_size())*x_step),</div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno"> 258</span> (transpose ? loc.pixel_size() : loc.row_size())*y_step ) {}</div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno"> 259</span> </div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno"> 260</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(x_iterator xit, std::ptrdiff_t row_bytes) : _p(xit,row_bytes) {}</div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno"> 261</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> X&gt; <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator&lt;X&gt;</a>&amp; pl) : _p(pl._p) {}</div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno"> 262</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>&amp; pl) : _p(pl._p) {}</div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno"> 263</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>&amp; operator=(<a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a> <span class="keyword">const</span>&amp; other) = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno"> 264</span> </div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno"> 265</span> <span class="keywordtype">bool</span> operator==(<span class="keyword">const</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a>&amp; p)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> _p==p._p; }</div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno"> 266</span> </div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno"> 267</span> x_iterator <span class="keyword">const</span>&amp; x()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> _p.base(); }</div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno"> 268</span> y_iterator <span class="keyword">const</span>&amp; y()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> _p; }</div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno"> 269</span> x_iterator&amp; x() { <span class="keywordflow">return</span> _p.base(); }</div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno"> 270</span> y_iterator&amp; y() { <span class="keywordflow">return</span> _p; }</div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno"> 271</span> </div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno"> 272</span> <span class="comment">// These are faster versions of functions already provided in the superclass</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno"> 273</span> x_iterator x_at (x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_advanced(x(), offset(dx,dy)); }</div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno"> 274</span> x_iterator x_at (<span class="keyword">const</span> difference_type&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_advanced(x(), offset(d.x,d.y)); }</div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno"> 275</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a> xy_at (x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a>(x_at( dx , dy ), row_size()); }</div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno"> 276</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a> xy_at (<span class="keyword">const</span> difference_type&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a>(x_at( d.x, d.y), row_size()); }</div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno"> 277</span> reference operator()(x_coord_t dx, y_coord_t dy)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_advanced_ref(x(),offset(dx,dy)); }</div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno"> 278</span> reference operator[](<span class="keyword">const</span> difference_type&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_advanced_ref(x(),offset(d.x,d.y)); }</div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno"> 279</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a>&amp; operator+=(<span class="keyword">const</span> difference_type&amp; d) { memunit_advance(x(),offset(d.x,d.y)); <span class="keywordflow">return</span> *<span class="keyword">this</span>; }</div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno"> 280</span> <a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a>&amp; operator-=(<span class="keyword">const</span> difference_type&amp; d) { memunit_advance(x(),offset(-d.x,-d.y)); <span class="keywordflow">return</span> *<span class="keyword">this</span>; }</div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno"> 281</span> </div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno"> 282</span> <span class="comment">// Memory-based locators can have 1D caching of 2D relative coordinates</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno"> 283</span> <span class="keyword">using </span>cached_location_t = std::ptrdiff_t; <span class="comment">// type used to store relative location (to allow for more efficient repeated access)</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno"> 284</span> cached_location_t cache_location(<span class="keyword">const</span> difference_type&amp; d)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> offset(d.x,d.y); }</div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno"> 285</span> cached_location_t cache_location(x_coord_t dx, y_coord_t dy)<span class="keyword">const </span>{ <span class="keywordflow">return</span> offset(dx,dy); }</div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno"> 286</span> reference operator[](<span class="keyword">const</span> cached_location_t&amp; loc)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_advanced_ref(x(),loc); }</div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno"> 287</span> </div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno"> 288</span> <span class="comment">// Only make sense for memory-based locators</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno"> 289</span> std::ptrdiff_t row_size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_step(y()); } <span class="comment">// distance in mem units (bytes or bits) between adjacent rows</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno"> 290</span> std::ptrdiff_t pixel_size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> memunit_step(x()); } <span class="comment">// distance in mem units (bytes or bits) between adjacent pixels on the same row</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno"> 291</span> </div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno"> 292</span> <span class="keywordtype">bool</span> is_1d_traversable(x_coord_t width)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> row_size()-pixel_size()*width==0; } <span class="comment">// is there no gap at the end of each row?</span></div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno"> 293</span> </div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno"> 294</span> <span class="comment">// Returns the vertical distance (it2.y-it1.y) between two x_iterators given the difference of their x positions</span></div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno"> 295</span> std::ptrdiff_t y_distance_to(<a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">this_t</a> <span class="keyword">const</span>&amp; p2, x_coord_t xDiff)<span class="keyword"> const</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno"> 296</span><span class="keyword"> </span>{</div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno"> 297</span> std::ptrdiff_t rowDiff = memunit_distance(x(), p2.x()) - pixel_size() * xDiff;</div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno"> 298</span> BOOST_ASSERT((rowDiff % row_size()) == 0);</div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno"> 299</span> <span class="keywordflow">return</span> rowDiff / row_size();</div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno"> 300</span> }</div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno"> 301</span> </div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno"> 302</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno"> 303</span> <span class="keyword">template</span> &lt;<span class="keyword">typename</span> X&gt; <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>;</div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno"> 304</span> std::ptrdiff_t offset(x_coord_t x, y_coord_t y)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> y*row_size() + x*pixel_size(); }</div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno"> 305</span> StepIterator _p;</div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno"> 306</span>};</div>
</div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno"> 307</span> </div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno"> 309</span><span class="comment">// PixelBasedConcept</span></div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno"> 311</span> </div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno"> 312</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno"> 313</span><span class="keyword">struct </span>color_space_type&lt;<a class="code hl_class" href="classboost_1_1gil_1_1memory__based__2d__locator.html">memory_based_2d_locator</a>&lt;SI&gt; &gt; : <span class="keyword">public</span> color_space_type&lt;typename memory_based_2d_locator&lt;SI&gt;::parent_t&gt; {</div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno"> 314</span>};</div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno"> 315</span> </div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno"> 316</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno"> 317</span><span class="keyword">struct </span>channel_mapping_type&lt;memory_based_2d_locator&lt;SI&gt; &gt; : <span class="keyword">public</span> channel_mapping_type&lt;typename memory_based_2d_locator&lt;SI&gt;::parent_t&gt; {</div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno"> 318</span>};</div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno"> 319</span> </div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno"> 320</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno"> 321</span><span class="keyword">struct </span>is_planar&lt;memory_based_2d_locator&lt;SI&gt; &gt; : <span class="keyword">public</span> is_planar&lt;typename memory_based_2d_locator&lt;SI&gt;::parent_t&gt; {</div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno"> 322</span>};</div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno"> 323</span> </div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno"> 324</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno"> 325</span><span class="keyword">struct </span>channel_type&lt;memory_based_2d_locator&lt;SI&gt; &gt; : <span class="keyword">public</span> channel_type&lt;typename memory_based_2d_locator&lt;SI&gt;::parent_t&gt; {</div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno"> 326</span>};</div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno"> 327</span> </div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno"> 329</span><span class="comment">// HasDynamicXStepTypeConcept</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno"> 331</span> </div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno"> 332</span><span class="comment">// Take the base iterator of SI (which is typically a step iterator) and change it to have a step in x</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno"> 333</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno"> 334</span><span class="keyword">struct </span>dynamic_x_step_type&lt;memory_based_2d_locator&lt;SI&gt; &gt; {</div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno"> 335</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno"> 336</span> <span class="keyword">using </span>base_iterator_t = <span class="keyword">typename</span> iterator_adaptor_get_base&lt;SI&gt;::type;</div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno"> 337</span> <span class="keyword">using </span>base_iterator_step_t = <span class="keyword">typename</span> dynamic_x_step_type&lt;base_iterator_t&gt;::type;</div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno"> 338</span> <span class="keyword">using </span>dynamic_step_base_t = <span class="keyword">typename</span> iterator_adaptor_rebind&lt;SI, base_iterator_step_t&gt;::type;</div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno"> 339</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno"> 340</span> <span class="keyword">using </span>type = memory_based_2d_locator&lt;dynamic_step_base_t&gt;;</div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno"> 341</span>};</div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno"> 342</span> </div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno"> 344</span><span class="comment">// HasDynamicYStepTypeConcept</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno"> 346</span> </div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno"> 347</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> SI&gt;</div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno"> 348</span><span class="keyword">struct </span>dynamic_y_step_type&lt;memory_based_2d_locator&lt;SI&gt; &gt; {</div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno"> 349</span> <span class="keyword">using </span>type = memory_based_2d_locator&lt;SI&gt;;</div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno"> 350</span>};</div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno"> 351</span>} } <span class="comment">// namespace boost::gil</span></div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno"> 352</span> </div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno"> 353</span><span class="preprocessor">#endif</span></div>
<div class="ttc" id="aclassboost_1_1gil_1_1memory__based__2d__locator_html"><div class="ttname"><a href="classboost_1_1gil_1_1memory__based__2d__locator.html">boost::gil::memory_based_2d_locator</a></div><div class="ttdoc">Memory-based pixel locator. Models: PixelLocatorConcept,HasDynamicXStepTypeConcept,...</div><div class="ttdef"><b>Definition</b> locator.hpp:230</div></div>
<div class="ttc" id="aclassboost_1_1gil_1_1pixel__2d__locator__base_html"><div class="ttname"><a href="classboost_1_1gil_1_1pixel__2d__locator__base.html">boost::gil::pixel_2d_locator_base</a></div><div class="ttdoc">base class for models of PixelLocatorConcept</div><div class="ttdef"><b>Definition</b> locator.hpp:109</div></div>
<div class="ttc" id="aclassboost_1_1gil_1_1point_html"><div class="ttname"><a href="classboost_1_1gil_1_1point.html">boost::gil::point</a></div><div class="ttdoc">2D point both axes of which have the same dimension typeModels: Point2DConcept</div><div class="ttdef"><b>Definition</b> point.hpp:36</div></div>
<div class="ttc" id="anamespaceboost_html"><div class="ttname"><a href="namespaceboost.html">boost</a></div><div class="ttdoc">defined(BOOST_NO_CXX17_HDR_MEMORY_RESOURCE)</div><div class="ttdef"><b>Definition</b> algorithm.hpp:36</div></div>
<div class="ttc" id="astructboost_1_1gil_1_1_step_iterator_concept_html"><div class="ttname"><a href="structboost_1_1gil_1_1_step_iterator_concept.html">boost::gil::StepIteratorConcept</a></div><div class="ttdoc">Step iterator concept.</div><div class="ttdef"><b>Definition</b> concepts/pixel_iterator.hpp:258</div></div>
<div class="ttc" id="astructboost_1_1gil_1_1iterator__adaptor__get__base_html"><div class="ttname"><a href="structboost_1_1gil_1_1iterator__adaptor__get__base.html">boost::gil::iterator_adaptor_get_base</a></div><div class="ttdoc">returns the base iterator for a given iterator adaptor. Provide an specialization when introducing ne...</div><div class="ttdef"><b>Definition</b> metafunctions.hpp:36</div></div>
<div class="ttc" id="astructboost_1_1gil_1_1iterator__add__deref_html"><div class="ttname"><a href="structboost_1_1gil_1_1iterator__add__deref.html">boost::gil::iterator_add_deref</a></div><div class="ttdoc">Returns the type (and creates an instance) of an iterator that invokes the given dereference adaptor ...</div><div class="ttdef"><b>Definition</b> pixel_iterator_adaptor.hpp:176</div></div>
<div class="ttc" id="astructboost_1_1gil_1_1transposed__type_html"><div class="ttname"><a href="structboost_1_1gil_1_1transposed__type.html">boost::gil::transposed_type</a></div><div class="ttdef"><b>Definition</b> locator.hpp:44</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- HTML footer for doxygen 1.8.13-->
<!-- start footer part -->
<hr class="footer"/>
<address class="footer">
<small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">doxygen</a> 1.9.8
</small>
</address>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink