<!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.8.12"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>Engauge Digitizer: Callback/CallbackPointOrdinal.h 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="search/search.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="search/searchdata.js"></script> <script type="text/javascript" src="search/search.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">Engauge Digitizer  <span id="projectnumber">2</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.12 --> <script type="text/javascript"> var searchBox = new SearchBox("searchBox", "search",false,'Search'); </script> <script type="text/javascript" src="menudata.js"></script> <script type="text/javascript" src="menu.js"></script> <script type="text/javascript"> $(function() { initMenu('',true,false,'search.php','Search'); $(document).ready(function() { init_search(); }); }); </script> <div id="main-nav"></div> <!-- window showing the filter options --> <div id="MSearchSelectWindow" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()" onkeydown="return searchBox.OnSearchSelectKey(event)"> </div> <!-- iframe showing the search results (closed by default) --> <div id="MSearchResultsWindow"> <iframe src="javascript:void(0)" frameborder="0" name="MSearchResults" id="MSearchResults"> </iframe> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_de0589a7ad5ee15bd5e387f14ab84b21.html">Callback</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">CallbackPointOrdinal.h</div> </div> </div><!--header--> <div class="contents"> <div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/******************************************************************************************************</span></div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> * (C) 2014 markummitchell@github.com. This file is part of Engauge Digitizer, which is released *</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> * under GNU General Public License version 2 (GPLv2) or (at your option) any later version. See file *</span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> * LICENSE or go to gnu.org/licenses for details. Distribution requires prior written permission. *</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> ******************************************************************************************************/</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="preprocessor">#ifndef CALLBACK_POINT_ORDINAL_H</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="preprocessor">#define CALLBACK_POINT_ORDINAL_H</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="preprocessor">#include "<a class="code" href="CallbackSearchReturn_8h.html">CallbackSearchReturn.h</a>"</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="preprocessor">#include "LineStyle.h"</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="preprocessor">#include <QPointF></span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="preprocessor">#include <QString></span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="preprocessor">#include "Transformation.h"</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> </div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="keyword">class </span><a class="code" href="classPoint.html">Point</a>;</div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> </div><div class="line"><a name="l00019"></a><span class="lineno"><a class="line" href="classCallbackPointOrdinal.html"> 19</a></span> <span class="keyword">class </span><a class="code" href="classCallbackPointOrdinal.html">CallbackPointOrdinal</a></div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> {</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="keyword">public</span>:</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  <a class="code" href="classCallbackPointOrdinal.html">CallbackPointOrdinal</a>(<span class="keyword">const</span> <a class="code" href="classLineStyle.html">LineStyle</a> &lineStyle,</div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  <span class="keyword">const</span> <a class="code" href="classTransformation.html">Transformation</a> &transformation,</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  <span class="keyword">const</span> QPointF &posScreen);</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> </div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  <a class="code" href="CallbackSearchReturn_8h.html#af7c2479573f6f5c2c4617463accf56f0">CallbackSearchReturn</a> <a class="code" href="classCallbackPointOrdinal.html#a23d4db4481254e8201e26f1527de6566">callback</a> (<span class="keyword">const</span> <a class="code" href="classPoint.html">Point</a> &pointStart,</div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  <span class="keyword">const</span> <a class="code" href="classPoint.html">Point</a> &pointStop);</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="keywordtype">double</span> <a class="code" href="classCallbackPointOrdinal.html#a030a19938aa891402b16f3880d241445">ordinal</a> () <span class="keyword">const</span>;</div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="keyword">private</span>:</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  <a class="code" href="classCallbackPointOrdinal.html">CallbackPointOrdinal</a>();</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keyword">const</span> <a class="code" href="classLineStyle.html">LineStyle</a> m_lineStyle;</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  <span class="keyword">const</span> <a class="code" href="classTransformation.html">Transformation</a> m_transformation;</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <span class="keyword">const</span> QPointF m_posScreen;</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <span class="comment">// Find the line segment using one or two steps:</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="comment">// 1) If the closest point to m_posScreen is between the endpoints of a line segment, then finding the minimum point-to-line distance</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <span class="comment">// is sufficient to determine the closest line segment. There is no ambiguity, since only one line segment will have the</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <span class="comment">// minimum point-to-line distance</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="comment">// 2) If case 1 does not apply, then there are two cases:</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  <span class="comment">// 2a) The point is just past one terminating line segment. There is no ambiguity, since only one line segment will have the</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  <span class="comment">// minimum point-to-line distance</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <span class="comment">// 2b) The point is near a vertex between two line segments. There is ambiguity with the two line segments which is resolved</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span>  <span class="comment">// by comparing the minimum projected-distance-outside-line (minimum value wins)</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <span class="keywordtype">bool</span> m_haveMinimumDistanceToLine;</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  <span class="keywordtype">double</span> m_minimumDistanceToLine;</div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <span class="keywordtype">double</span> m_minimumProjectedDistanceOutsideLine;</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <span class="keywordtype">double</span> m_ordinal; <span class="comment">// Valid when m_haveMinimumDistanceToLine is true</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> };</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> </div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="preprocessor">#endif // CALLBACK_POINT_ORDINAL_H</span></div><div class="ttc" id="classCallbackPointOrdinal_html_a23d4db4481254e8201e26f1527de6566"><div class="ttname"><a href="classCallbackPointOrdinal.html#a23d4db4481254e8201e26f1527de6566">CallbackPointOrdinal::callback</a></div><div class="ttdeci">CallbackSearchReturn callback(const Point &pointStart, const Point &pointStop)</div><div class="ttdoc">Callback method. </div><div class="ttdef"><b>Definition:</b> <a href="CallbackPointOrdinal_8cpp_source.html#l00028">CallbackPointOrdinal.cpp:28</a></div></div> <div class="ttc" id="classCallbackPointOrdinal_html"><div class="ttname"><a href="classCallbackPointOrdinal.html">CallbackPointOrdinal</a></div><div class="ttdoc">Callback for computing the ordinal for a specified point, as a function of the LineStyle and curve ge...</div><div class="ttdef"><b>Definition:</b> <a href="CallbackPointOrdinal_8h_source.html#l00019">CallbackPointOrdinal.h:19</a></div></div> <div class="ttc" id="classPoint_html"><div class="ttname"><a href="classPoint.html">Point</a></div><div class="ttdoc">Class that represents one digitized point. The screen-to-graph coordinate transformation is always ex...</div><div class="ttdef"><b>Definition:</b> <a href="Point_8h_source.html#l00023">Point.h:23</a></div></div> <div class="ttc" id="CallbackSearchReturn_8h_html_af7c2479573f6f5c2c4617463accf56f0"><div class="ttname"><a href="CallbackSearchReturn_8h.html#af7c2479573f6f5c2c4617463accf56f0">CallbackSearchReturn</a></div><div class="ttdeci">CallbackSearchReturn</div><div class="ttdoc">Return values for search callback methods. </div><div class="ttdef"><b>Definition:</b> <a href="CallbackSearchReturn_8h_source.html#l00024">CallbackSearchReturn.h:24</a></div></div> <div class="ttc" id="classTransformation_html"><div class="ttname"><a href="classTransformation.html">Transformation</a></div><div class="ttdoc">Affine transformation between screen and graph coordinates, based on digitized axis points...</div><div class="ttdef"><b>Definition:</b> <a href="Transformation_8h_source.html#l00031">Transformation.h:31</a></div></div> <div class="ttc" id="classLineStyle_html"><div class="ttname"><a href="classLineStyle.html">LineStyle</a></div><div class="ttdoc">Details for a specific Line. </div><div class="ttdef"><b>Definition:</b> <a href="LineStyle_8h_source.html#l00019">LineStyle.h:19</a></div></div> <div class="ttc" id="CallbackSearchReturn_8h_html"><div class="ttname"><a href="CallbackSearchReturn_8h.html">CallbackSearchReturn.h</a></div></div> <div class="ttc" id="classCallbackPointOrdinal_html_a030a19938aa891402b16f3880d241445"><div class="ttname"><a href="classCallbackPointOrdinal.html#a030a19938aa891402b16f3880d241445">CallbackPointOrdinal::ordinal</a></div><div class="ttdeci">double ordinal() const</div><div class="ttdoc">Computed ordinal. </div><div class="ttdef"><b>Definition:</b> <a href="CallbackPointOrdinal_8cpp_source.html#l00083">CallbackPointOrdinal.cpp:83</a></div></div> </div><!-- fragment --></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Sun Dec 25 2016 20:54:08 for Engauge Digitizer by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.12 </small></address> </body> </html>