~ubuntu-branches/ubuntu/vivid/tesseract/vivid

« back to all changes in this revision

Viewing changes to doc/html/a00800_source.html

  • Committer: Package Import Robot
  • Author(s): Jeff Breidenbach
  • Date: 2014-02-03 11:10:20 UTC
  • mfrom: (1.3.1) (19.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20140203111020-igquodd7pjlp3uri
Tags: 3.03.01-1
* New upstream release, includes critical fix to PDF rendering
* Complete leptonlib transition (see bug #735509)
* Promote from experimental to unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
2
<html xmlns="http://www.w3.org/1999/xhtml">
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
 
5
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
 
6
<title>tesseract: /usr/local/google/home/jbreiden/tesseract-ocr-read-only/ccstruct/stepblob.h Source File</title>
 
7
 
 
8
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 
9
<link href="doxygen.css" rel="stylesheet" type="text/css" />
 
10
<link href="navtree.css" rel="stylesheet" type="text/css"/>
 
11
<script type="text/javascript" src="jquery.js"></script>
 
12
<script type="text/javascript" src="resize.js"></script>
 
13
<script type="text/javascript" src="navtree.js"></script>
 
14
<script type="text/javascript">
 
15
  $(document).ready(initResizable);
 
16
</script>
 
17
<link href="search/search.css" rel="stylesheet" type="text/css"/>
 
18
<script type="text/javascript" src="search/search.js"></script>
 
19
<script type="text/javascript">
 
20
  $(document).ready(function() { searchBox.OnSelectItem(0); });
 
21
</script>
 
22
 
 
23
</head>
 
24
<body>
 
25
<div id="top"><!-- do not remove this div! -->
 
26
 
 
27
 
 
28
<div id="titlearea">
 
29
<table cellspacing="0" cellpadding="0">
 
30
 <tbody>
 
31
 <tr style="height: 56px;">
 
32
  
 
33
  
 
34
  <td style="padding-left: 0.5em;">
 
35
   <div id="projectname">tesseract
 
36
   &#160;<span id="projectnumber">3.03</span>
 
37
   </div>
 
38
   
 
39
  </td>
 
40
  
 
41
  
 
42
  
 
43
 </tr>
 
44
 </tbody>
 
45
</table>
 
46
</div>
 
47
 
 
48
<!-- Generated by Doxygen 1.7.6.1 -->
 
49
<script type="text/javascript">
 
50
var searchBox = new SearchBox("searchBox", "search",false,'Search');
 
51
</script>
 
52
  <div id="navrow1" class="tabs">
 
53
    <ul class="tablist">
 
54
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
 
55
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
 
56
      <li><a href="modules.html"><span>Modules</span></a></li>
 
57
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
 
58
      <li><a href="annotated.html"><span>Classes</span></a></li>
 
59
      <li class="current"><a href="files.html"><span>Files</span></a></li>
 
60
      <li>
 
61
        <div id="MSearchBox" class="MSearchBoxInactive">
 
62
        <span class="left">
 
63
          <img id="MSearchSelect" src="search/mag_sel.png"
 
64
               onmouseover="return searchBox.OnSearchSelectShow()"
 
65
               onmouseout="return searchBox.OnSearchSelectHide()"
 
66
               alt=""/>
 
67
          <input type="text" id="MSearchField" value="Search" accesskey="S"
 
68
               onfocus="searchBox.OnSearchFieldFocus(true)" 
 
69
               onblur="searchBox.OnSearchFieldFocus(false)" 
 
70
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
 
71
          </span><span class="right">
 
72
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
 
73
          </span>
 
74
        </div>
 
75
      </li>
 
76
    </ul>
 
77
  </div>
 
78
  <div id="navrow2" class="tabs2">
 
79
    <ul class="tablist">
 
80
      <li><a href="files.html"><span>File&#160;List</span></a></li>
 
81
      <li><a href="globals.html"><span>File&#160;Members</span></a></li>
 
82
    </ul>
 
83
  </div>
 
84
</div>
 
85
<div id="side-nav" class="ui-resizable side-nav-resizable">
 
86
  <div id="nav-tree">
 
87
    <div id="nav-tree-contents">
 
88
    </div>
 
89
  </div>
 
90
  <div id="splitbar" style="-moz-user-select:none;" 
 
91
       class="ui-resizable-handle">
 
92
  </div>
 
93
</div>
 
94
<script type="text/javascript">
 
95
  initNavTree('a00800.html','');
 
96
</script>
 
97
<div id="doc-content">
 
98
<div class="header">
 
99
  <div class="headertitle">
 
100
<div class="title">/usr/local/google/home/jbreiden/tesseract-ocr-read-only/ccstruct/stepblob.h</div>  </div>
 
101
</div><!--header-->
 
102
<div class="contents">
 
103
<a href="a00800.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/**********************************************************************</span>
 
104
<a name="l00002"></a>00002 <span class="comment"> * File:        stepblob.h  (Formerly cblob.h)</span>
 
105
<a name="l00003"></a>00003 <span class="comment"> * Description: Code for C_BLOB class.</span>
 
106
<a name="l00004"></a>00004 <span class="comment"> * Author:              Ray Smith</span>
 
107
<a name="l00005"></a>00005 <span class="comment"> * Created:             Tue Oct 08 10:41:13 BST 1991</span>
 
108
<a name="l00006"></a>00006 <span class="comment"> *</span>
 
109
<a name="l00007"></a>00007 <span class="comment"> * (C) Copyright 1991, Hewlett-Packard Ltd.</span>
 
110
<a name="l00008"></a>00008 <span class="comment"> ** Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
111
<a name="l00009"></a>00009 <span class="comment"> ** you may not use this file except in compliance with the License.</span>
 
112
<a name="l00010"></a>00010 <span class="comment"> ** You may obtain a copy of the License at</span>
 
113
<a name="l00011"></a>00011 <span class="comment"> ** http://www.apache.org/licenses/LICENSE-2.0</span>
 
114
<a name="l00012"></a>00012 <span class="comment"> ** Unless required by applicable law or agreed to in writing, software</span>
 
115
<a name="l00013"></a>00013 <span class="comment"> ** distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
116
<a name="l00014"></a>00014 <span class="comment"> ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
117
<a name="l00015"></a>00015 <span class="comment"> ** See the License for the specific language governing permissions and</span>
 
118
<a name="l00016"></a>00016 <span class="comment"> ** limitations under the License.</span>
 
119
<a name="l00017"></a>00017 <span class="comment"> *</span>
 
120
<a name="l00018"></a>00018 <span class="comment"> **********************************************************************/</span>
 
121
<a name="l00019"></a>00019 
 
122
<a name="l00020"></a>00020 <span class="preprocessor">#ifndef           STEPBLOB_H</span>
 
123
<a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define           STEPBLOB_H</span>
 
124
<a name="l00022"></a>00022 <span class="preprocessor"></span>
 
125
<a name="l00023"></a>00023 <span class="preprocessor">#include          &quot;<a class="code" href="a00740.html">coutln.h</a>&quot;</span>
 
126
<a name="l00024"></a>00024 <span class="preprocessor">#include          &quot;<a class="code" href="a00790.html">rect.h</a>&quot;</span>
 
127
<a name="l00025"></a>00025 
 
128
<a name="l00026"></a>00026 <span class="keyword">class </span><a class="code" href="a00289.html">C_BLOB</a>;
 
129
<a name="l00027"></a>00027 <span class="keyword">struct </span>Pix;
 
130
<a name="l00028"></a>00028 <a class="code" href="a00819.html#a6cf5144252ef24ea7bb5e0da1e698a0b">ELISTIZEH</a>(<a class="code" href="a00289.html">C_BLOB</a>)
 
131
<a name="l00029"></a>00029 
 
132
<a name="l00030"></a><a class="code" href="a00289.html">00030</a> class <a class="code" href="a00289.html">C_BLOB</a>:public <a class="code" href="a00369.html">ELIST_LINK</a>
 
133
<a name="l00031"></a>00031 {
 
134
<a name="l00032"></a>00032   <span class="keyword">public</span>:
 
135
<a name="l00033"></a><a class="code" href="a00289.html#ab832423937669379b1f9df7acf95e0fb">00033</a>     <a class="code" href="a00289.html#ab832423937669379b1f9df7acf95e0fb">C_BLOB</a>() {
 
136
<a name="l00034"></a>00034     }
 
137
<a name="l00035"></a>00035     <span class="keyword">explicit</span> <a class="code" href="a00289.html">C_BLOB</a>(C_OUTLINE_LIST *outline_list);
 
138
<a name="l00036"></a>00036     <span class="comment">// Simpler constructor to build a blob from a single outline that has</span>
 
139
<a name="l00037"></a>00037     <span class="comment">// already been fully initialized.</span>
 
140
<a name="l00038"></a>00038     <span class="keyword">explicit</span> <a class="code" href="a00289.html">C_BLOB</a>(<a class="code" href="a00290.html">C_OUTLINE</a>* outline);
 
141
<a name="l00039"></a>00039 
 
142
<a name="l00040"></a>00040     <span class="comment">// Builds a set of one or more blobs from a list of outlines.</span>
 
143
<a name="l00041"></a>00041     <span class="comment">// Input: one outline on outline_list contains all the others, but the</span>
 
144
<a name="l00042"></a>00042     <span class="comment">// nesting and order are undefined.</span>
 
145
<a name="l00043"></a>00043     <span class="comment">// If good_blob is true, the blob is added to good_blobs_it, unless</span>
 
146
<a name="l00044"></a>00044     <span class="comment">// an illegal (generation-skipping) parent-child relationship is found.</span>
 
147
<a name="l00045"></a>00045     <span class="comment">// If so, the parent blob goes to bad_blobs_it, and the immediate children</span>
 
148
<a name="l00046"></a>00046     <span class="comment">// are promoted to the top level, recursively being sent to good_blobs_it.</span>
 
149
<a name="l00047"></a>00047     <span class="comment">// If good_blob is false, all created blobs will go to the bad_blobs_it.</span>
 
150
<a name="l00048"></a>00048     <span class="comment">// Output: outline_list is empty. One or more blobs are added to</span>
 
151
<a name="l00049"></a>00049     <span class="comment">// good_blobs_it and/or bad_blobs_it.</span>
 
152
<a name="l00050"></a>00050     <span class="keyword">static</span> <span class="keywordtype">void</span> ConstructBlobsFromOutlines(<span class="keywordtype">bool</span> good_blob,
 
153
<a name="l00051"></a>00051                                            C_OUTLINE_LIST* outline_list,
 
154
<a name="l00052"></a>00052                                            C_BLOB_IT* good_blobs_it,
 
155
<a name="l00053"></a>00053                                            C_BLOB_IT* bad_blobs_it);
 
156
<a name="l00054"></a>00054 
 
157
<a name="l00055"></a>00055     <span class="comment">// Sets the COUT_INVERSE flag appropriately on the outlines and their</span>
 
158
<a name="l00056"></a>00056     <span class="comment">// children recursively, reversing the outlines if needed so that</span>
 
159
<a name="l00057"></a>00057     <span class="comment">// everything has an anticlockwise top-level.</span>
 
160
<a name="l00058"></a>00058     <span class="keywordtype">void</span> CheckInverseFlagAndDirection();
 
161
<a name="l00059"></a>00059 
 
162
<a name="l00060"></a>00060     <span class="comment">// Build and return a fake blob containing a single fake outline with no</span>
 
163
<a name="l00061"></a>00061     <span class="comment">// steps.</span>
 
164
<a name="l00062"></a>00062     <span class="keyword">static</span> <a class="code" href="a00289.html">C_BLOB</a>* FakeBlob(<span class="keyword">const</span> <a class="code" href="a00592.html">TBOX</a>&amp; box);
 
165
<a name="l00063"></a>00063 
 
166
<a name="l00064"></a><a class="code" href="a00289.html#ae510f3d0e7398fbb46608082429eac89">00064</a>     C_OUTLINE_LIST *<a class="code" href="a00289.html#ae510f3d0e7398fbb46608082429eac89">out_list</a>() {  <span class="comment">//get outline list</span>
 
167
<a name="l00065"></a>00065       <span class="keywordflow">return</span> &amp;outlines;
 
168
<a name="l00066"></a>00066     }
 
169
<a name="l00067"></a>00067 
 
170
<a name="l00068"></a>00068     <a class="code" href="a00592.html">TBOX</a> bounding_box();  <span class="comment">//compute bounding box</span>
 
171
<a name="l00069"></a>00069     <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> area();  <span class="comment">//compute area</span>
 
172
<a name="l00070"></a>00070     <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> perimeter();  <span class="comment">// Total perimeter of outlines and 1st level children.</span>
 
173
<a name="l00071"></a>00071     <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> outer_area();  <span class="comment">//compute area</span>
 
174
<a name="l00072"></a>00072     <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> count_transitions(                   <span class="comment">//count maxima</span>
 
175
<a name="l00073"></a>00073                             <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> threshold);  <span class="comment">//size threshold</span>
 
176
<a name="l00074"></a>00074 
 
177
<a name="l00075"></a>00075     <span class="keywordtype">void</span> move(<span class="keyword">const</span> <a class="code" href="a00409.html" title="integer coordinate">ICOORD</a> vec);  <span class="comment">// repostion blob by vector</span>
 
178
<a name="l00076"></a>00076     <span class="keywordtype">void</span> rotate(<span class="keyword">const</span> <a class="code" href="a00375.html">FCOORD</a>&amp; rotation);  <span class="comment">// Rotate by given vector.</span>
 
179
<a name="l00077"></a>00077 
 
180
<a name="l00078"></a>00078     <span class="comment">// Adds sub-pixel resolution EdgeOffsets for the outlines using greyscale</span>
 
181
<a name="l00079"></a>00079     <span class="comment">// if the supplied pix is 8-bit or the binary edges if NULL.</span>
 
182
<a name="l00080"></a>00080     <span class="keywordtype">void</span> ComputeEdgeOffsets(<span class="keywordtype">int</span> threshold, Pix* pix);
 
183
<a name="l00081"></a>00081 
 
184
<a name="l00082"></a>00082     <span class="comment">// Estimates and returns the baseline position based on the shape of the</span>
 
185
<a name="l00083"></a>00083     <span class="comment">// outlines.</span>
 
186
<a name="l00084"></a>00084     <a class="code" href="a00831.html#a8d41499d38c24d39b221ab0c158fe5a8">inT16</a> EstimateBaselinePosition();
 
187
<a name="l00085"></a>00085 
 
188
<a name="l00086"></a>00086     <span class="comment">// Returns a Pix rendering of the blob. pixDestroy after use.</span>
 
189
<a name="l00087"></a>00087     Pix* render();
 
190
<a name="l00088"></a>00088     <span class="comment">// Returns a Pix rendering of the outline of the blob. (no fill).</span>
 
191
<a name="l00089"></a>00089     <span class="comment">// pixDestroy after use.</span>
 
192
<a name="l00090"></a>00090     Pix* <a class="code" href="a01251.html#a7ee7085b157e15b1651947b1e121f9b5">render_outline</a>();
 
193
<a name="l00091"></a>00091 
 
194
<a name="l00092"></a>00092 <span class="preprocessor">    #ifndef GRAPHICS_DISABLED</span>
 
195
<a name="l00093"></a>00093 <span class="preprocessor"></span>    <span class="keywordtype">void</span> plot(                       <span class="comment">//draw one</span>
 
196
<a name="l00094"></a>00094               <a class="code" href="a00532.html">ScrollView</a>* window,         <span class="comment">//window to draw in</span>
 
197
<a name="l00095"></a>00095               <a class="code" href="a00532.html#a100504544a5423a94222149ee9ed0fe8">ScrollView::Color</a> blob_colour,    <span class="comment">//for outer bits</span>
 
198
<a name="l00096"></a>00096               <a class="code" href="a00532.html#a100504544a5423a94222149ee9ed0fe8">ScrollView::Color</a> child_colour);  <span class="comment">//for holes</span>
 
199
<a name="l00097"></a>00097     <span class="comment">// Draws the blob in the given colour, and child_colour, normalized</span>
 
200
<a name="l00098"></a>00098     <span class="comment">// using the given denorm, making use of sub-pixel accurate information</span>
 
201
<a name="l00099"></a>00099     <span class="comment">// if available.</span>
 
202
<a name="l00100"></a>00100     <span class="keywordtype">void</span> plot_normed(<span class="keyword">const</span> <a class="code" href="a00352.html">DENORM</a>&amp; denorm,
 
203
<a name="l00101"></a>00101                      <a class="code" href="a00532.html#a100504544a5423a94222149ee9ed0fe8">ScrollView::Color</a> blob_colour,
 
204
<a name="l00102"></a>00102                      <a class="code" href="a00532.html#a100504544a5423a94222149ee9ed0fe8">ScrollView::Color</a> child_colour,
 
205
<a name="l00103"></a>00103                      <a class="code" href="a00532.html">ScrollView</a>* window);
 
206
<a name="l00104"></a>00104 <span class="preprocessor">    #endif  // GRAPHICS_DISABLED</span>
 
207
<a name="l00105"></a>00105 <span class="preprocessor"></span>
 
208
<a name="l00106"></a><a class="code" href="a00289.html#aa8c06a443917a9504d29caa75c756361">00106</a>     <a class="code" href="a00289.html">C_BLOB</a>&amp; operator= (<span class="keyword">const</span> <a class="code" href="a00289.html">C_BLOB</a> &amp; source) {
 
209
<a name="l00107"></a>00107       <span class="keywordflow">if</span> (!outlines.empty ())
 
210
<a name="l00108"></a>00108         outlines.clear();
 
211
<a name="l00109"></a>00109       outlines.<a class="code" href="a00289.html#abe4a0174938ec7e4d968382e8274c237">deep_copy</a>(&amp;source.outlines, &amp;<a class="code" href="a00290.html#aae5feeba94ae0da9e9ce1068d5e53a56">C_OUTLINE::deep_copy</a>);
 
212
<a name="l00110"></a>00110       <span class="keywordflow">return</span> *<span class="keyword">this</span>;
 
213
<a name="l00111"></a>00111     }
 
214
<a name="l00112"></a>00112 
 
215
<a name="l00113"></a><a class="code" href="a00289.html#abe4a0174938ec7e4d968382e8274c237">00113</a>     <span class="keyword">static</span> <a class="code" href="a00289.html">C_BLOB</a>* <a class="code" href="a00289.html#abe4a0174938ec7e4d968382e8274c237">deep_copy</a>(<span class="keyword">const</span> <a class="code" href="a00289.html">C_BLOB</a>* src) {
 
216
<a name="l00114"></a>00114       <a class="code" href="a00289.html">C_BLOB</a>* blob = <span class="keyword">new</span> <a class="code" href="a00289.html">C_BLOB</a>;
 
217
<a name="l00115"></a>00115       *blob = *src;
 
218
<a name="l00116"></a>00116       <span class="keywordflow">return</span> blob;
 
219
<a name="l00117"></a>00117     }
 
220
<a name="l00118"></a>00118 
 
221
<a name="l00119"></a>00119   <span class="keyword">private</span>:
 
222
<a name="l00120"></a>00120     C_OUTLINE_LIST outlines;     <span class="comment">//master elements</span>
 
223
<a name="l00121"></a>00121 };
 
224
<a name="l00122"></a>00122 
 
225
<a name="l00123"></a>00123 <span class="preprocessor">#endif</span>
 
226
</pre></div></div><!-- contents -->
 
227
</div>
 
228
<!-- window showing the filter options -->
 
229
<div id="MSearchSelectWindow"
 
230
     onmouseover="return searchBox.OnSearchSelectShow()"
 
231
     onmouseout="return searchBox.OnSearchSelectHide()"
 
232
     onkeydown="return searchBox.OnSearchSelectKey(event)">
 
233
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark">&#160;</span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark">&#160;</span>Defines</a></div>
 
234
 
 
235
<!-- iframe showing the search results (closed by default) -->
 
236
<div id="MSearchResultsWindow">
 
237
<iframe src="javascript:void(0)" frameborder="0" 
 
238
        name="MSearchResults" id="MSearchResults">
 
239
</iframe>
 
240
</div>
 
241
 
 
242
  <div id="nav-path" class="navpath">
 
243
    <ul>
 
244
      <li class="navelem"><a class="el" href="a00800.html">stepblob.h</a>      </li>
 
245
 
 
246
    <li class="footer">Generated on Mon Feb 3 2014 10:59:07 for tesseract by
 
247
    <a href="http://www.doxygen.org/index.html">
 
248
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.6.1 </li>
 
249
   </ul>
 
250
 </div>
 
251
 
 
252
 
 
253
</body>
 
254
</html>