Subversion Repositories AndroidProjects

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
204 chris 1 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 
<html>
3 
        <head>
4 
                <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
5 
                <title>ARToolKit API Documentation</title>
6 
                <link href="doxygen.css" rel="stylesheet" type="text/css">
7 
        </head>
8 
        <body>
9 
<!-- Generated by Doxygen 1.4.6 -->
10 
<div class="tabs">
11 
  <ul>
12 
    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
13 
    <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
14 
    <li id="current"><a href="files.html"><span>Files</span></a></li>
15 
  </ul></div>
16 
<div class="tabs">
17 
  <ul>
18 
    <li><a href="files.html"><span>File&nbsp;List</span></a></li>
19 
    <li><a href="globals.html"><span>Globals</span></a></li>
20 
  </ul></div>
21 
<h1>param.h File Reference</h1>ARToolkit global structure (parameters) subroutines. <a href="#_details">More...</a>
22 
<p>
23 
<code>#include &lt;AR/config.h&gt;</code><br>
24 
<table border="0" cellpadding="0" cellspacing="0">
25 
<tr><td></td></tr>
26 
<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
27 
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structARParam.html">ARParam</a></td></tr>
28 
 
29 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">camera intrinsic parameters.  <a href="structARParam.html#_details">More...</a><br></td></tr>
30 
<tr><td class="memItemLeft" nowrap align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><b>ARSParam</b></td></tr>
31 
 
32 
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
33 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#abc5345858e262fff89f9f0d75c7ce54">arParamGet</a> (double global[][3], double screen[][2], int data_num, double mat[3][4])</td></tr>
34 
 
35 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">XXXBK.  <a href="#abc5345858e262fff89f9f0d75c7ce54"></a><br></td></tr>
36 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#25fbda2ca487c252896d7f10f1aa1478">arParamDecomp</a> (<a class="el" href="structARParam.html">ARParam</a> *source, <a class="el" href="structARParam.html">ARParam</a> *icpara, double trans[3][4])</td></tr>
37 
 
38 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">XXXBK.  <a href="#25fbda2ca487c252896d7f10f1aa1478"></a><br></td></tr>
39 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#464e59f386f2d030925d8b070c6b35bd">arParamDecompMat</a> (double source[3][4], double cpara[3][4], double trans[3][4])</td></tr>
40 
 
41 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">XXXBK.  <a href="#464e59f386f2d030925d8b070c6b35bd"></a><br></td></tr>
42 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#3e52a8aff371f4bea95049689f89c5fa">arParamIdeal2Observ</a> (const double dist_factor[4], const double ix, const double iy, double *ox, double *oy)</td></tr>
43 
 
44 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Convert ideal screen coordinates of a vertex to observed ones.  <a href="#3e52a8aff371f4bea95049689f89c5fa"></a><br></td></tr>
45 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#e31d34be66699b8343aedaef1d627777">arParamObserv2Ideal</a> (const double dist_factor[4], const double ox, const double oy, double *ix, double *iy)</td></tr>
46 
 
47 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Convert observed screen coordinates of a vertex to ideal ones.  <a href="#e31d34be66699b8343aedaef1d627777"></a><br></td></tr>
48 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#ad3ef0e0fba8944c501a2819e1e99ad9">arParamChangeSize</a> (<a class="el" href="structARParam.html">ARParam</a> *source, int xsize, int ysize, <a class="el" href="structARParam.html">ARParam</a> *newparam)</td></tr>
49 
 
50 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">change the camera size parameters.  <a href="#ad3ef0e0fba8944c501a2819e1e99ad9"></a><br></td></tr>
51 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#acbb90cde0696e4ab8269b98b44822ca">arParamSave</a> (char *filename, int num, <a class="el" href="structARParam.html">ARParam</a> *param,...)</td></tr>
52 
 
53 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">save a camera intrinsic parameters.  <a href="#acbb90cde0696e4ab8269b98b44822ca"></a><br></td></tr>
54 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#09b936765527cf0b1cbf5636d8757ff2">arParamLoad</a> (const char *filename, int num, <a class="el" href="structARParam.html">ARParam</a> *param,...)</td></tr>
55 
 
56 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">load the camera intrinsic parameters.  <a href="#09b936765527cf0b1cbf5636d8757ff2"></a><br></td></tr>
57 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="param_8h.html#677677fbc07c60ac1b8b6576af98d045">arParamDisp</a> (<a class="el" href="structARParam.html">ARParam</a> *param)</td></tr>
58 
 
59 
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">display parameters.  <a href="#677677fbc07c60ac1b8b6576af98d045"></a><br></td></tr>
60 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dd14c6f4e2fbab1287ff6642aaec8598"></a><!-- doxytag: member="param.h::arsParamChangeSize" ref="dd14c6f4e2fbab1287ff6642aaec8598" args="(ARSParam *source, int xsize, int ysize, ARSParam *newparam)" -->
61 
int&nbsp;</td><td class="memItemRight" valign="bottom"><b>arsParamChangeSize</b> (ARSParam *source, int xsize, int ysize, ARSParam *newparam)</td></tr>
62 
 
63 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f19f2237742066d68ea8304ad4ff60bb"></a><!-- doxytag: member="param.h::arsParamSave" ref="f19f2237742066d68ea8304ad4ff60bb" args="(char *filename, ARSParam *sparam)" -->
64 
int&nbsp;</td><td class="memItemRight" valign="bottom"><b>arsParamSave</b> (char *filename, ARSParam *sparam)</td></tr>
65 
 
66 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="fe6d94517f7a3abb4c17d86583a52fc8"></a><!-- doxytag: member="param.h::arsParamLoad" ref="fe6d94517f7a3abb4c17d86583a52fc8" args="(char *filename, ARSParam *sparam)" -->
67 
int&nbsp;</td><td class="memItemRight" valign="bottom"><b>arsParamLoad</b> (char *filename, ARSParam *sparam)</td></tr>
68 
 
69 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="00fe0d77fc497e74a7e9e58c981eaef7"></a><!-- doxytag: member="param.h::arsParamDisp" ref="00fe0d77fc497e74a7e9e58c981eaef7" args="(ARSParam *sparam)" -->
70 
int&nbsp;</td><td class="memItemRight" valign="bottom"><b>arsParamDisp</b> (ARSParam *sparam)</td></tr>
71 
 
72 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8a0e280448327a32adb0f56878020f83"></a><!-- doxytag: member="param.h::arsParamGetMat" ref="8a0e280448327a32adb0f56878020f83" args="(double matL[3][4], double matR[3][4], double cparaL[3][4], double cparaR[3][4], double matL2R[3][4])" -->
73 
int&nbsp;</td><td class="memItemRight" valign="bottom"><b>arsParamGetMat</b> (double matL[3][4], double matR[3][4], double cparaL[3][4], double cparaR[3][4], double matL2R[3][4])</td></tr>
74 
 
75 
</table>
76 
<hr><a name="_details"></a><h2>Detailed Description</h2>
77 
ARToolkit global structure (parameters) subroutines.
78 
<p>
79 
This file contains principal routines for loading, saving, and modify camera parameters for of ARToolkit library. Different structures are used for modify in run-time this parameters in the library. A file structure is use for input/output. <dl compact><dt><b>Remarks:</b></dt><dd></dd></dl>
80 
History :<p>
81 
<dl compact><dt><b>Author:</b></dt><dd>Takeshi Mita <a href="mailto:tmita@inolab.sys.es.osaka-u.ac.jp">tmita@inolab.sys.es.osaka-u.ac.jp</a> <p>
82 
Shinsaku Hiura <a href="mailto:shinsaku@sys.es.osaka-u.ac.jp">shinsaku@sys.es.osaka-u.ac.jp</a> <p>
83 
Hirokazu Kato <a href="mailto:kato@sys.im.hiroshima-cu.ac.jp">kato@sys.im.hiroshima-cu.ac.jp</a></dd></dl>
84 
<dl compact><dt><b>Version:</b></dt><dd>4.1 </dd></dl>
85 
<dl compact><dt><b>Date:</b></dt><dd>01/12/07 </dd></dl>
86 
<hr><h2>Function Documentation</h2>
87 
<a class="anchor" name="ad3ef0e0fba8944c501a2819e1e99ad9"></a><!-- doxytag: member="param.h::arParamChangeSize" ref="ad3ef0e0fba8944c501a2819e1e99ad9" args="(ARParam *source, int xsize, int ysize, ARParam *newparam)" --><p>
88 
<table class="mdTable" cellpadding="2" cellspacing="0">
89 
  <tr>
90 
    <td class="mdRow">
91 
      <table cellpadding="0" cellspacing="0" border="0">
92 
        <tr>
93 
          <td class="md" nowrap valign="top">int arParamChangeSize           </td>
94 
          <td class="md" valign="top">(&nbsp;</td>
95 
          <td class="md" nowrap valign="top"><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
96 
          <td class="mdname" nowrap> <em>source</em>, </td>
97 
        </tr>
98 
        <tr>
99 
          <td class="md" nowrap align="right"></td>
100 
          <td class="md"></td>
101 
          <td class="md" nowrap>int&nbsp;</td>
102 
          <td class="mdname" nowrap> <em>xsize</em>, </td>
103 
        </tr>
104 
        <tr>
105 
          <td class="md" nowrap align="right"></td>
106 
          <td class="md"></td>
107 
          <td class="md" nowrap>int&nbsp;</td>
108 
          <td class="mdname" nowrap> <em>ysize</em>, </td>
109 
        </tr>
110 
        <tr>
111 
          <td class="md" nowrap align="right"></td>
112 
          <td class="md"></td>
113 
          <td class="md" nowrap><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
114 
          <td class="mdname" nowrap> <em>newparam</em></td>
115 
        </tr>
116 
        <tr>
117 
          <td class="md"></td>
118 
          <td class="md">)&nbsp;</td>
119 
          <td class="md" colspan="2"></td>
120 
        </tr>
121 
      </table>
122 
    </td>
123 
  </tr>
124 
</table>
125 
<table cellspacing="5" cellpadding="0" border="0">
126 
  <tr>
127 
    <td>
128 
      &nbsp;
129 
    </td>
130 
    <td>
131 
 
132 
<p>
133 
change the camera size parameters.
134 
<p>
135 
Change the size variable in camera intrinsic parameters. <dl compact><dt><b>Parameters:</b></dt><dd>
136 
  <table border="0" cellspacing="2" cellpadding="0">
137 
    <tr><td valign="top"></td><td valign="top"><em>source</em>&nbsp;</td><td>name of the source parameters structure </td></tr>
138 
    <tr><td valign="top"></td><td valign="top"><em>xsize</em>&nbsp;</td><td>new length size </td></tr>
139 
    <tr><td valign="top"></td><td valign="top"><em>ysize</em>&nbsp;</td><td>new height size </td></tr>
140 
    <tr><td valign="top"></td><td valign="top"><em>newparam</em>&nbsp;</td><td>name of the destination parameters structure. </td></tr>
141 
  </table>
142 
</dl>
143 
<dl compact><dt><b>Returns:</b></dt><dd>0 </dd></dl>
144 
    </td>
145 
  </tr>
146 
</table>
147 
<a class="anchor" name="25fbda2ca487c252896d7f10f1aa1478"></a><!-- doxytag: member="param.h::arParamDecomp" ref="25fbda2ca487c252896d7f10f1aa1478" args="(ARParam *source, ARParam *icpara, double trans[3][4])" --><p>
148 
<table class="mdTable" cellpadding="2" cellspacing="0">
149 
  <tr>
150 
    <td class="mdRow">
151 
      <table cellpadding="0" cellspacing="0" border="0">
152 
        <tr>
153 
          <td class="md" nowrap valign="top">int arParamDecomp           </td>
154 
          <td class="md" valign="top">(&nbsp;</td>
155 
          <td class="md" nowrap valign="top"><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
156 
          <td class="mdname" nowrap> <em>source</em>, </td>
157 
        </tr>
158 
        <tr>
159 
          <td class="md" nowrap align="right"></td>
160 
          <td class="md"></td>
161 
          <td class="md" nowrap><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
162 
          <td class="mdname" nowrap> <em>icpara</em>, </td>
163 
        </tr>
164 
        <tr>
165 
          <td class="md" nowrap align="right"></td>
166 
          <td class="md"></td>
167 
          <td class="md" nowrap>double&nbsp;</td>
168 
          <td class="mdname" nowrap> <em>trans</em>[3][4]</td>
169 
        </tr>
170 
        <tr>
171 
          <td class="md"></td>
172 
          <td class="md">)&nbsp;</td>
173 
          <td class="md" colspan="2"></td>
174 
        </tr>
175 
      </table>
176 
    </td>
177 
  </tr>
178 
</table>
179 
<table cellspacing="5" cellpadding="0" border="0">
180 
  <tr>
181 
    <td>
182 
      &nbsp;
183 
    </td>
184 
    <td>
185 
 
186 
<p>
187 
XXXBK.
188 
<p>
189 
XXXBK <dl compact><dt><b>Parameters:</b></dt><dd>
190 
  <table border="0" cellspacing="2" cellpadding="0">
191 
    <tr><td valign="top"></td><td valign="top"><em>source</em>&nbsp;</td><td>XXXBK </td></tr>
192 
    <tr><td valign="top"></td><td valign="top"><em>icpara</em>&nbsp;</td><td>XXXBK </td></tr>
193 
    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>XXXBK </td></tr>
194 
  </table>
195 
</dl>
196 
<dl compact><dt><b>Returns:</b></dt><dd>XXXBK </dd></dl>
197 
    </td>
198 
  </tr>
199 
</table>
200 
<a class="anchor" name="464e59f386f2d030925d8b070c6b35bd"></a><!-- doxytag: member="param.h::arParamDecompMat" ref="464e59f386f2d030925d8b070c6b35bd" args="(double source[3][4], double cpara[3][4], double trans[3][4])" --><p>
201 
<table class="mdTable" cellpadding="2" cellspacing="0">
202 
  <tr>
203 
    <td class="mdRow">
204 
      <table cellpadding="0" cellspacing="0" border="0">
205 
        <tr>
206 
          <td class="md" nowrap valign="top">int arParamDecompMat           </td>
207 
          <td class="md" valign="top">(&nbsp;</td>
208 
          <td class="md" nowrap valign="top">double&nbsp;</td>
209 
          <td class="mdname" nowrap> <em>source</em>[3][4], </td>
210 
        </tr>
211 
        <tr>
212 
          <td class="md" nowrap align="right"></td>
213 
          <td class="md"></td>
214 
          <td class="md" nowrap>double&nbsp;</td>
215 
          <td class="mdname" nowrap> <em>cpara</em>[3][4], </td>
216 
        </tr>
217 
        <tr>
218 
          <td class="md" nowrap align="right"></td>
219 
          <td class="md"></td>
220 
          <td class="md" nowrap>double&nbsp;</td>
221 
          <td class="mdname" nowrap> <em>trans</em>[3][4]</td>
222 
        </tr>
223 
        <tr>
224 
          <td class="md"></td>
225 
          <td class="md">)&nbsp;</td>
226 
          <td class="md" colspan="2"></td>
227 
        </tr>
228 
      </table>
229 
    </td>
230 
  </tr>
231 
</table>
232 
<table cellspacing="5" cellpadding="0" border="0">
233 
  <tr>
234 
    <td>
235 
      &nbsp;
236 
    </td>
237 
    <td>
238 
 
239 
<p>
240 
XXXBK.
241 
<p>
242 
XXXBK <dl compact><dt><b>Parameters:</b></dt><dd>
243 
  <table border="0" cellspacing="2" cellpadding="0">
244 
    <tr><td valign="top"></td><td valign="top"><em>source</em>&nbsp;</td><td>input camera matrix </td></tr>
245 
    <tr><td valign="top"></td><td valign="top"><em>cpara</em>&nbsp;</td><td>camera parameter to be set </td></tr>
246 
    <tr><td valign="top"></td><td valign="top"><em>trans</em>&nbsp;</td><td>XXXBK </td></tr>
247 
  </table>
248 
</dl>
249 
<dl compact><dt><b>Returns:</b></dt><dd>XXXBK </dd></dl>
250 
    </td>
251 
  </tr>
252 
</table>
253 
<a class="anchor" name="677677fbc07c60ac1b8b6576af98d045"></a><!-- doxytag: member="param.h::arParamDisp" ref="677677fbc07c60ac1b8b6576af98d045" args="(ARParam *param)" --><p>
254 
<table class="mdTable" cellpadding="2" cellspacing="0">
255 
  <tr>
256 
    <td class="mdRow">
257 
      <table cellpadding="0" cellspacing="0" border="0">
258 
        <tr>
259 
          <td class="md" nowrap valign="top">int arParamDisp           </td>
260 
          <td class="md" valign="top">(&nbsp;</td>
261 
          <td class="md" nowrap valign="top"><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
262 
          <td class="mdname1" valign="top" nowrap> <em>param</em>          </td>
263 
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
264 
          <td class="md" nowrap></td>
265 
        </tr>
266 
      </table>
267 
    </td>
268 
  </tr>
269 
</table>
270 
<table cellspacing="5" cellpadding="0" border="0">
271 
  <tr>
272 
    <td>
273 
      &nbsp;
274 
    </td>
275 
    <td>
276 
 
277 
<p>
278 
display parameters.
279 
<p>
280 
Display the structure of the camera instrinsic parameters argument. <dl compact><dt><b>Parameters:</b></dt><dd>
281 
  <table border="0" cellspacing="2" cellpadding="0">
282 
    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>structure to display </td></tr>
283 
  </table>
284 
</dl>
285 
<dl compact><dt><b>Returns:</b></dt><dd>0 </dd></dl>
286 
    </td>
287 
  </tr>
288 
</table>
289 
<a class="anchor" name="abc5345858e262fff89f9f0d75c7ce54"></a><!-- doxytag: member="param.h::arParamGet" ref="abc5345858e262fff89f9f0d75c7ce54" args="(double global[][3], double screen[][2], int data_num, double mat[3][4])" --><p>
290 
<table class="mdTable" cellpadding="2" cellspacing="0">
291 
  <tr>
292 
    <td class="mdRow">
293 
      <table cellpadding="0" cellspacing="0" border="0">
294 
        <tr>
295 
          <td class="md" nowrap valign="top">int arParamGet           </td>
296 
          <td class="md" valign="top">(&nbsp;</td>
297 
          <td class="md" nowrap valign="top">double&nbsp;</td>
298 
          <td class="mdname" nowrap> <em>global</em>[][3], </td>
299 
        </tr>
300 
        <tr>
301 
          <td class="md" nowrap align="right"></td>
302 
          <td class="md"></td>
303 
          <td class="md" nowrap>double&nbsp;</td>
304 
          <td class="mdname" nowrap> <em>screen</em>[][2], </td>
305 
        </tr>
306 
        <tr>
307 
          <td class="md" nowrap align="right"></td>
308 
          <td class="md"></td>
309 
          <td class="md" nowrap>int&nbsp;</td>
310 
          <td class="mdname" nowrap> <em>data_num</em>, </td>
311 
        </tr>
312 
        <tr>
313 
          <td class="md" nowrap align="right"></td>
314 
          <td class="md"></td>
315 
          <td class="md" nowrap>double&nbsp;</td>
316 
          <td class="mdname" nowrap> <em>mat</em>[3][4]</td>
317 
        </tr>
318 
        <tr>
319 
          <td class="md"></td>
320 
          <td class="md">)&nbsp;</td>
321 
          <td class="md" colspan="2"></td>
322 
        </tr>
323 
      </table>
324 
    </td>
325 
  </tr>
326 
</table>
327 
<table cellspacing="5" cellpadding="0" border="0">
328 
  <tr>
329 
    <td>
330 
      &nbsp;
331 
    </td>
332 
    <td>
333 
 
334 
<p>
335 
XXXBK.
336 
<p>
337 
XXXBK <dl compact><dt><b>Parameters:</b></dt><dd>
338 
  <table border="0" cellspacing="2" cellpadding="0">
339 
    <tr><td valign="top"></td><td valign="top"><em>global</em>&nbsp;</td><td>XXXBK </td></tr>
340 
    <tr><td valign="top"></td><td valign="top"><em>screen</em>&nbsp;</td><td>XXXBK </td></tr>
341 
    <tr><td valign="top"></td><td valign="top"><em>data_num</em>&nbsp;</td><td>XXXBK </td></tr>
342 
    <tr><td valign="top"></td><td valign="top"><em>mat</em>&nbsp;</td><td>XXXBK </td></tr>
343 
  </table>
344 
</dl>
345 
<dl compact><dt><b>Returns:</b></dt><dd>XXXBK </dd></dl>
346 
    </td>
347 
  </tr>
348 
</table>
349 
<a class="anchor" name="3e52a8aff371f4bea95049689f89c5fa"></a><!-- doxytag: member="param.h::arParamIdeal2Observ" ref="3e52a8aff371f4bea95049689f89c5fa" args="(const double dist_factor[4], const double ix, const double iy, double *ox, double *oy)" --><p>
350 
<table class="mdTable" cellpadding="2" cellspacing="0">
351 
  <tr>
352 
    <td class="mdRow">
353 
      <table cellpadding="0" cellspacing="0" border="0">
354 
        <tr>
355 
          <td class="md" nowrap valign="top">int int arParamIdeal2Observ           </td>
356 
          <td class="md" valign="top">(&nbsp;</td>
357 
          <td class="md" nowrap valign="top">const double&nbsp;</td>
358 
          <td class="mdname" nowrap> <em>dist_factor</em>[4], </td>
359 
        </tr>
360 
        <tr>
361 
          <td class="md" nowrap align="right"></td>
362 
          <td class="md"></td>
363 
          <td class="md" nowrap>const double&nbsp;</td>
364 
          <td class="mdname" nowrap> <em>ix</em>, </td>
365 
        </tr>
366 
        <tr>
367 
          <td class="md" nowrap align="right"></td>
368 
          <td class="md"></td>
369 
          <td class="md" nowrap>const double&nbsp;</td>
370 
          <td class="mdname" nowrap> <em>iy</em>, </td>
371 
        </tr>
372 
        <tr>
373 
          <td class="md" nowrap align="right"></td>
374 
          <td class="md"></td>
375 
          <td class="md" nowrap>double *&nbsp;</td>
376 
          <td class="mdname" nowrap> <em>ox</em>, </td>
377 
        </tr>
378 
        <tr>
379 
          <td class="md" nowrap align="right"></td>
380 
          <td class="md"></td>
381 
          <td class="md" nowrap>double *&nbsp;</td>
382 
          <td class="mdname" nowrap> <em>oy</em></td>
383 
        </tr>
384 
        <tr>
385 
          <td class="md"></td>
386 
          <td class="md">)&nbsp;</td>
387 
          <td class="md" colspan="2"></td>
388 
        </tr>
389 
      </table>
390 
    </td>
391 
  </tr>
392 
</table>
393 
<table cellspacing="5" cellpadding="0" border="0">
394 
  <tr>
395 
    <td>
396 
      &nbsp;
397 
    </td>
398 
    <td>
399 
 
400 
<p>
401 
Convert ideal screen coordinates of a vertex to observed ones.
402 
<p>
403 
Ideal coordinates mean that the distortion of the camera is compensated (so a straight line looks straight). In observed coordinates the camera-distortion is not compensated and thus a straight line is not shown really straight. <dl compact><dt><b>Parameters:</b></dt><dd>
404 
  <table border="0" cellspacing="2" cellpadding="0">
405 
    <tr><td valign="top"></td><td valign="top"><em>dist_factor</em>&nbsp;</td><td>distorsion factors of used camera </td></tr>
406 
    <tr><td valign="top"></td><td valign="top"><em>ix</em>&nbsp;</td><td>x in ideal screen coordinates </td></tr>
407 
    <tr><td valign="top"></td><td valign="top"><em>iy</em>&nbsp;</td><td>y in ideal screen coordinates </td></tr>
408 
    <tr><td valign="top"></td><td valign="top"><em>ox</em>&nbsp;</td><td>resulted x in observed screen coordinates </td></tr>
409 
    <tr><td valign="top"></td><td valign="top"><em>oy</em>&nbsp;</td><td>resulted y in observed screen coordinates </td></tr>
410 
  </table>
411 
</dl>
412 
<dl compact><dt><b>Returns:</b></dt><dd>0 if success, -1 otherwise </dd></dl>
413 
    </td>
414 
  </tr>
415 
</table>
416 
<a class="anchor" name="09b936765527cf0b1cbf5636d8757ff2"></a><!-- doxytag: member="param.h::arParamLoad" ref="09b936765527cf0b1cbf5636d8757ff2" args="(const char *filename, int num, ARParam *param,...)" --><p>
417 
<table class="mdTable" cellpadding="2" cellspacing="0">
418 
  <tr>
419 
    <td class="mdRow">
420 
      <table cellpadding="0" cellspacing="0" border="0">
421 
        <tr>
422 
          <td class="md" nowrap valign="top">int arParamLoad           </td>
423 
          <td class="md" valign="top">(&nbsp;</td>
424 
          <td class="md" nowrap valign="top">const char *&nbsp;</td>
425 
          <td class="mdname" nowrap> <em>filename</em>, </td>
426 
        </tr>
427 
        <tr>
428 
          <td class="md" nowrap align="right"></td>
429 
          <td class="md"></td>
430 
          <td class="md" nowrap>int&nbsp;</td>
431 
          <td class="mdname" nowrap> <em>num</em>, </td>
432 
        </tr>
433 
        <tr>
434 
          <td class="md" nowrap align="right"></td>
435 
          <td class="md"></td>
436 
          <td class="md" nowrap><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
437 
          <td class="mdname" nowrap> <em>param</em>, </td>
438 
        </tr>
439 
        <tr>
440 
          <td class="md" nowrap align="right"></td>
441 
          <td class="md"></td>
442 
          <td class="md" nowrap>&nbsp;</td>
443 
          <td class="mdname" nowrap> <em>...</em></td>
444 
        </tr>
445 
        <tr>
446 
          <td class="md"></td>
447 
          <td class="md">)&nbsp;</td>
448 
          <td class="md" colspan="2"></td>
449 
        </tr>
450 
      </table>
451 
    </td>
452 
  </tr>
453 
</table>
454 
<table cellspacing="5" cellpadding="0" border="0">
455 
  <tr>
456 
    <td>
457 
      &nbsp;
458 
    </td>
459 
    <td>
460 
 
461 
<p>
462 
load the camera intrinsic parameters.
463 
<p>
464 
Load camera intrinsic parameters in the ARToolkit Library from a file (itself, an output of the calibration step). <dl compact><dt><b>Parameters:</b></dt><dd>
465 
  <table border="0" cellspacing="2" cellpadding="0">
466 
    <tr><td valign="top"></td><td valign="top"><em>filename</em>&nbsp;</td><td>name of the parameters file. </td></tr>
467 
    <tr><td valign="top"></td><td valign="top"><em>num</em>&nbsp;</td><td>number of variable arguments </td></tr>
468 
    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>result of the loaded parameters </td></tr>
469 
  </table>
470 
</dl>
471 
<dl compact><dt><b>Returns:</b></dt><dd>0 if success, -1 if Error (file not found, file structure problem) </dd></dl>
472 
    </td>
473 
  </tr>
474 
</table>
475 
<a class="anchor" name="e31d34be66699b8343aedaef1d627777"></a><!-- doxytag: member="param.h::arParamObserv2Ideal" ref="e31d34be66699b8343aedaef1d627777" args="(const double dist_factor[4], const double ox, const double oy, double *ix, double *iy)" --><p>
476 
<table class="mdTable" cellpadding="2" cellspacing="0">
477 
  <tr>
478 
    <td class="mdRow">
479 
      <table cellpadding="0" cellspacing="0" border="0">
480 
        <tr>
481 
          <td class="md" nowrap valign="top">int arParamObserv2Ideal           </td>
482 
          <td class="md" valign="top">(&nbsp;</td>
483 
          <td class="md" nowrap valign="top">const double&nbsp;</td>
484 
          <td class="mdname" nowrap> <em>dist_factor</em>[4], </td>
485 
        </tr>
486 
        <tr>
487 
          <td class="md" nowrap align="right"></td>
488 
          <td class="md"></td>
489 
          <td class="md" nowrap>const double&nbsp;</td>
490 
          <td class="mdname" nowrap> <em>ox</em>, </td>
491 
        </tr>
492 
        <tr>
493 
          <td class="md" nowrap align="right"></td>
494 
          <td class="md"></td>
495 
          <td class="md" nowrap>const double&nbsp;</td>
496 
          <td class="mdname" nowrap> <em>oy</em>, </td>
497 
        </tr>
498 
        <tr>
499 
          <td class="md" nowrap align="right"></td>
500 
          <td class="md"></td>
501 
          <td class="md" nowrap>double *&nbsp;</td>
502 
          <td class="mdname" nowrap> <em>ix</em>, </td>
503 
        </tr>
504 
        <tr>
505 
          <td class="md" nowrap align="right"></td>
506 
          <td class="md"></td>
507 
          <td class="md" nowrap>double *&nbsp;</td>
508 
          <td class="mdname" nowrap> <em>iy</em></td>
509 
        </tr>
510 
        <tr>
511 
          <td class="md"></td>
512 
          <td class="md">)&nbsp;</td>
513 
          <td class="md" colspan="2"></td>
514 
        </tr>
515 
      </table>
516 
    </td>
517 
  </tr>
518 
</table>
519 
<table cellspacing="5" cellpadding="0" border="0">
520 
  <tr>
521 
    <td>
522 
      &nbsp;
523 
    </td>
524 
    <td>
525 
 
526 
<p>
527 
Convert observed screen coordinates of a vertex to ideal ones.
528 
<p>
529 
Ideal coordinates mean that the distortion of the camera is compensated (so a straight line looks straight). In observed coordinates the camera-distortion is not compensated and thus a straight line is not shown really straight. <dl compact><dt><b>Parameters:</b></dt><dd>
530 
  <table border="0" cellspacing="2" cellpadding="0">
531 
    <tr><td valign="top"></td><td valign="top"><em>dist_factor</em>&nbsp;</td><td>distorsion factors of used camera </td></tr>
532 
    <tr><td valign="top"></td><td valign="top"><em>ox</em>&nbsp;</td><td>x in observed screen coordinates </td></tr>
533 
    <tr><td valign="top"></td><td valign="top"><em>oy</em>&nbsp;</td><td>y in observed screen coordinates </td></tr>
534 
    <tr><td valign="top"></td><td valign="top"><em>ix</em>&nbsp;</td><td>resulted x in ideal screen coordinates </td></tr>
535 
    <tr><td valign="top"></td><td valign="top"><em>iy</em>&nbsp;</td><td>resulted y in ideal screen coordinates </td></tr>
536 
  </table>
537 
</dl>
538 
<dl compact><dt><b>Returns:</b></dt><dd>0 if success, -1 otherwise </dd></dl>
539 
    </td>
540 
  </tr>
541 
</table>
542 
<a class="anchor" name="acbb90cde0696e4ab8269b98b44822ca"></a><!-- doxytag: member="param.h::arParamSave" ref="acbb90cde0696e4ab8269b98b44822ca" args="(char *filename, int num, ARParam *param,...)" --><p>
543 
<table class="mdTable" cellpadding="2" cellspacing="0">
544 
  <tr>
545 
    <td class="mdRow">
546 
      <table cellpadding="0" cellspacing="0" border="0">
547 
        <tr>
548 
          <td class="md" nowrap valign="top">int arParamSave           </td>
549 
          <td class="md" valign="top">(&nbsp;</td>
550 
          <td class="md" nowrap valign="top">char *&nbsp;</td>
551 
          <td class="mdname" nowrap> <em>filename</em>, </td>
552 
        </tr>
553 
        <tr>
554 
          <td class="md" nowrap align="right"></td>
555 
          <td class="md"></td>
556 
          <td class="md" nowrap>int&nbsp;</td>
557 
          <td class="mdname" nowrap> <em>num</em>, </td>
558 
        </tr>
559 
        <tr>
560 
          <td class="md" nowrap align="right"></td>
561 
          <td class="md"></td>
562 
          <td class="md" nowrap><a class="el" href="structARParam.html">ARParam</a> *&nbsp;</td>
563 
          <td class="mdname" nowrap> <em>param</em>, </td>
564 
        </tr>
565 
        <tr>
566 
          <td class="md" nowrap align="right"></td>
567 
          <td class="md"></td>
568 
          <td class="md" nowrap>&nbsp;</td>
569 
          <td class="mdname" nowrap> <em>...</em></td>
570 
        </tr>
571 
        <tr>
572 
          <td class="md"></td>
573 
          <td class="md">)&nbsp;</td>
574 
          <td class="md" colspan="2"></td>
575 
        </tr>
576 
      </table>
577 
    </td>
578 
  </tr>
579 
</table>
580 
<table cellspacing="5" cellpadding="0" border="0">
581 
  <tr>
582 
    <td>
583 
      &nbsp;
584 
    </td>
585 
    <td>
586 
 
587 
<p>
588 
save a camera intrinsic parameters.
589 
<p>
590 
Save manipulated camera intrinsic parameters in a file. <dl compact><dt><b>Parameters:</b></dt><dd>
591 
  <table border="0" cellspacing="2" cellpadding="0">
592 
    <tr><td valign="top"></td><td valign="top"><em>filename</em>&nbsp;</td><td>name of the parameters file. </td></tr>
593 
    <tr><td valign="top"></td><td valign="top"><em>num</em>&nbsp;</td><td>number of variable arguments </td></tr>
594 
    <tr><td valign="top"></td><td valign="top"><em>param</em>&nbsp;</td><td>parameters to save </td></tr>
595 
  </table>
596 
</dl>
597 
<dl compact><dt><b>Returns:</b></dt><dd>0 if success, -1 if Error (file not found, file structure problem) </dd></dl>
598 
    </td>
599 
  </tr>
600 
</table>
601 
 
602 
        <small>Generated with <a href="http://www.doxygen.org/index.html">Doxygen</a><br>
603 
        Copyright © 2004-2006. HIT Lab NZ. All Rights Reserved.</small>
604 
        </body>
605 
</html>