1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../../css/manpage.css" type="text/css" />
7    <style type="text/css"><!--
8      span.static_style
9      {
10        font-size			: 8pt;
11        color				: white;
12        font-weight			: bold;
13        background			: #44f;
14        border-left			: solid 1px #aaf;
15        border-top			: solid 1px #aaf;
16        border-right		: solid 1px #00c;
17        border-bottom		: solid 1px #00c;
18        padding-left		: 2px;
19        padding-right		: 2px;
20      }
21      span.virtual_style
22      {
23        font-size			 : 8pt;
24        color				 : white;
25        font-weight			: bold;
26        background			: #0a0;
27        border-left			: solid 1px #0f0;
28        border-top			: solid 1px #0f0;
29        border-right		: solid 1px #060;
30        border-bottom		: solid 1px #060;
31        padding-left		: 2px;
32        padding-right		: 2px;
33      }
34      span.protected_style
35      {
36        font-size			 : 8pt;
37        color				 : white;
38        font-weight			: bold;
39        background			: #444;
40        border-left			: solid 1px #ccc;
41        border-top			: solid 1px #ccc;
42        border-right		: solid 1px #222;
43        border-bottom		: solid 1px #222;
44        padding-left		: 2px;
45        padding-right		: 2px;
46      }
47        --></style>
48<title>nn::jpeg::CTR::GpsData</title>
49  </head>
50  <body>
51<h1><CODE><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/jpeg/Overview.html">jpeg</a>::<a href="../../../../nn/jpeg/CTR/Overview.html">CTR</a>::GpsData</CODE> Structure</h1>
52<h2>Syntax</h2>
53    <div class="section">
54<pre class="definition">struct GpsData
55{
56bool isVersionIdValid;
57bool isLatitudeValid;
58bool isLongitudeValid;
59bool isAltitudeRefValid;
60bool isAltitudeValid;
61bool isTimeStampValid;
62bool isDopValid;
63bool isSpeedValid;
64bool isTrackValid;
65bool isImgDirectionValid;
66bool isDestLatitudeValid;
67bool isDestLongitudeValid;
68bool isDestBearingValid;
69bool isDestDistanceValid;
70bool isDifferentialValid;
71<a href="../../../../nn_types/u8.html">u8</a> altitudeRef;
72<a href="../../../../nn_types/u8.html">u8</a> versionId[GPS_VERSION_ID_SIZE];
73char latitudeRef[GPS_REF_SIZE];
74char longitudeRef[GPS_REF_SIZE];
75char status[GPS_REF_SIZE];
76char measureMode[GPS_REF_SIZE];
77char speedRef[GPS_REF_SIZE];
78char trackRef[GPS_REF_SIZE];
79char imgDirectionRef[GPS_REF_SIZE];
80char destLatitudeRef[GPS_REF_SIZE];
81char destLongitudeRef[GPS_REF_SIZE];
82char destBearingRef[GPS_REF_SIZE];
83char destDistanceRef[GPS_REF_SIZE];
84<a href="../../../../nn_types/u16.html">u16</a> differential;
85<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> latitude[NUM_GPS_LATITUDE_RATIONALS];
86<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> longitude[NUM_GPS_LONGITUDE_RATIONALS];
87<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> altitude;
88<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> timeStamp[NUM_GPS_TIME_STAMP_RATIONALS];
89const char * pSatellites;
90<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> dop;
91<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> speed;
92<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> track;
93<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> imgDirection;
94const char * pMapDatum;
95<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> destLatitude[NUM_GPS_LATITUDE_RATIONALS];
96<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> destLongitude[NUM_GPS_LONGITUDE_RATIONALS];
97<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> destBearing;
98<a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a> destDistance;
99const <a href="../../../../nn_types/u8.html">u8</a> * pProcessingMethod;
100size_t processingMethodSize;
101const <a href="../../../../nn_types/u8.html">u8</a> * pAreaInformation;
102size_t areaInformationSize;
103const char * pDateStamp;
104};
105</pre>
106    </div>
107<h2>Description</h2>
108    <div class="section">
109<p>This structure maintains GPS IFD in a format easily processed by the library.</p><p>To get information after decoding (after EXIF information has been extracted), use <a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastGpsData.html">JpegMpDecoder::GetLastGpsData</a>.<br />To register information before encoding, first initialize the structure using <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/InitializeGpsData.html">JpegMpEncoder::InitializeGpsData</a> and then register data using <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsLatitude.html">JpegMpEncoder::SetGpsLatitude</a>, for example. Finally, confirm the contents of the structure using <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsData.html">JpegMpEncoder::SetGpsData</a>.</p><!-- write here --></div>
110    <a name="variable" id="variable">
111<h2>Member Variables</h2>
112      <div class="section">
113        <table class="members">
114          <tr>
115            <td width="100"> </td>
116            <th>
117<span class="argument">isVersionIdValid</span>
118            </th>
119<td width="100">bool</td>
120<td>Indicates whether the <CODE>versionID</CODE> is valid.</td>
121          </tr>
122          <tr>
123            <td width="100"> </td>
124            <th>
125<span class="argument">isLatitudeValid</span>
126            </th>
127<td width="100">bool</td>
128<td>Indicates whether <CODE>latitude</CODE> is valid.</td>
129          </tr>
130          <tr>
131            <td width="100"> </td>
132            <th>
133<span class="argument">isLongitudeValid</span>
134            </th>
135<td width="100">bool</td>
136<td>Indicates whether <CODE>longitude</CODE> is valid.</td>
137          </tr>
138          <tr>
139            <td width="100"> </td>
140            <th>
141<span class="argument">isAltitudeRefValid</span>
142            </th>
143<td width="100">bool</td>
144<td>Indicates whether <CODE>altitudeRef</CODE> is valid.</td>
145          </tr>
146          <tr>
147            <td width="100"> </td>
148            <th>
149<span class="argument">isAltitudeValid</span>
150            </th>
151<td width="100">bool</td>
152<td>Indicates whether <CODE>altitude</CODE> is valid.</td>
153          </tr>
154          <tr>
155            <td width="100"> </td>
156            <th>
157<span class="argument">isTimeStampValid</span>
158            </th>
159<td width="100">bool</td>
160<td>Indicates whether <CODE>timeStamp</CODE> is valid.</td>
161          </tr>
162          <tr>
163            <td width="100"> </td>
164            <th>
165<span class="argument">isDopValid</span>
166            </th>
167<td width="100">bool</td>
168<td>Indicates whether <CODE>DOP</CODE> is valid.</td>
169          </tr>
170          <tr>
171            <td width="100"> </td>
172            <th>
173<span class="argument">isSpeedValid</span>
174            </th>
175<td width="100">bool</td>
176<td>Indicates whether <CODE>speed</CODE> is valid.</td>
177          </tr>
178          <tr>
179            <td width="100"> </td>
180            <th>
181<span class="argument">isTrackValid</span>
182            </th>
183<td width="100">bool</td>
184<td>Indicates whether <CODE>track</CODE> is valid.</td>
185          </tr>
186          <tr>
187            <td width="100"> </td>
188            <th>
189<span class="argument">isImgDirectionValid</span>
190            </th>
191<td width="100">bool</td>
192<td>Indicates whether <CODE>imgDirection</CODE> is valid.</td>
193          </tr>
194          <tr>
195            <td width="100"> </td>
196            <th>
197<span class="argument">isDestLatitudeValid</span>
198            </th>
199<td width="100">bool</td>
200<td>Indicates whether <CODE>destLatitude</CODE> is valid.</td>
201          </tr>
202          <tr>
203            <td width="100"> </td>
204            <th>
205<span class="argument">isDestLongitudeValid</span>
206            </th>
207<td width="100">bool</td>
208<td>Indicates whether <CODE>destLongitude</CODE> is valid.</td>
209          </tr>
210          <tr>
211            <td width="100"> </td>
212            <th>
213<span class="argument">isDestBearingValid</span>
214            </th>
215<td width="100">bool</td>
216<td>Indicates whether <CODE>destBearing</CODE> is valid.</td>
217          </tr>
218          <tr>
219            <td width="100"> </td>
220            <th>
221<span class="argument">isDestDistanceValid</span>
222            </th>
223<td width="100">bool</td>
224<td>Indicates whether <CODE>destDistance</CODE> is valid.</td>
225          </tr>
226          <tr>
227            <td width="100"> </td>
228            <th>
229<span class="argument">isDifferentialValid</span>
230            </th>
231<td width="100">bool</td>
232<td>Indicates whether <CODE>differential</CODE> is valid.</td>
233          </tr>
234          <tr>
235            <td width="100"> </td>
236            <th>
237<span class="argument">altitudeRef</span>
238            </th>
239<td width="100"><a href="../../../../nn_types/u8.html">u8</a></td>
240<td>Represents the <CODE>altitude</CODE> reference.</td>
241          </tr>
242          <tr>
243            <td width="100"> </td>
244            <th>
245<span class="argument">versionId</span>
246            </th>
247<td width="100"><a href="../../../../nn_types/u8.html">u8</a></td>
248<td>Represents the GPS tag version.</td>
249          </tr>
250          <tr>
251            <td width="100"> </td>
252            <th>
253<span class="argument">latitudeRef</span>
254            </th>
255<td width="100"><CODE>char</CODE></td>
256<td>Represents North (N) or South (S). Valid if element 0 is not 0. Element [1] is always 0.</td>
257          </tr>
258          <tr>
259            <td width="100"> </td>
260            <th>
261<span class="argument">longitudeRef</span>
262            </th>
263<td width="100"><CODE>char</CODE></td>
264<td>Represents East (E) or West (W) Valid if element 0 is not 0. Element [1] is always 0.</td>
265          </tr>
266          <tr>
267            <td width="100"> </td>
268            <th>
269<span class="argument">status</span>
270            </th>
271<td width="100"><CODE>char</CODE></td>
272<td>Represents the GPS receiver status. Valid if element 0 is not 0. Element [1] is always 0.</td>
273          </tr>
274          <tr>
275            <td width="100"> </td>
276            <th>
277<span class="argument">measureMode</span>
278            </th>
279<td width="100"><CODE>char</CODE></td>
280<td>Represents the GPS measurement method. Valid if element 0 is not 0. Element [1] is always 0.</td>
281          </tr>
282          <tr>
283            <td width="100"> </td>
284            <th>
285<span class="argument">speedRef</span>
286            </th>
287<td width="100"><CODE>char</CODE></td>
288<td>Represents the velocity unit. Valid if element 0 is not 0. Element [1] is always 0.</td>
289          </tr>
290          <tr>
291            <td width="100"> </td>
292            <th>
293<span class="argument">trackRef</span>
294            </th>
295<td width="100"><CODE>char</CODE></td>
296<td>Represents the tracking direction. Valid if element 0 is not 0. Element [1] is always 0.</td>
297          </tr>
298          <tr>
299            <td width="100"> </td>
300            <th>
301<span class="argument">imgDirectionRef</span>
302            </th>
303<td width="100"><CODE>char</CODE></td>
304<td>Represents the orientation of the captured image. Valid if element 0 is not 0. Element [1] is always 0.</td>
305          </tr>
306          <tr>
307            <td width="100"> </td>
308            <th>
309<span class="argument">destLatitudeRef</span>
310            </th>
311<td width="100"><CODE>char</CODE></td>
312<td>Represents North (N) or South (S) latitude of the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
313          </tr>
314          <tr>
315            <td width="100"> </td>
316            <th>
317<span class="argument">destLongitudeRef</span>
318            </th>
319<td width="100"><CODE>char</CODE></td>
320<td>Represents East (E) or West (W) longitude of the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
321          </tr>
322          <tr>
323            <td width="100"> </td>
324            <th>
325<span class="argument">destBearingRef</span>
326            </th>
327<td width="100"><CODE>char</CODE></td>
328<td>Represents the bearing to the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
329          </tr>
330          <tr>
331            <td width="100"> </td>
332            <th>
333<span class="argument">destDistanceRef</span>
334            </th>
335<td width="100"><CODE>char</CODE></td>
336<td>Represents the distance to the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
337          </tr>
338          <tr>
339            <td width="100"> </td>
340            <th>
341<span class="argument">differential</span>
342            </th>
343<td width="100"><a href="../../../../nn_types/u16.html">u16</a></td>
344<td>Represents the GPS differential.</td>
345          </tr>
346          <tr>
347            <td width="100"> </td>
348            <th>
349<span class="argument"><CODE>latitude</CODE></span>
350            </th>
351<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
352<td>Represents the latitude (numeric value).</td>
353          </tr>
354          <tr>
355            <td width="100"> </td>
356            <th>
357<span class="argument"><CODE>longitude</CODE></span>
358            </th>
359<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
360<td>Represents the longitude (numeric value).</td>
361          </tr>
362          <tr>
363            <td width="100"> </td>
364            <th>
365<span class="argument">altitude</span>
366            </th>
367<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
368<td>Represents the altitude (numeric value).</td>
369          </tr>
370          <tr>
371            <td width="100"> </td>
372            <th>
373<span class="argument">timeStamp</span>
374            </th>
375<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
376<td>Represents the GPS time (atomic clock time)</td>
377          </tr>
378          <tr>
379            <td width="100"> </td>
380            <th>
381<span class="argument">pSatellites</span>
382            </th>
383<td width="100">const char *</td>
384<td>Represents the satellite signal used for positioning. Valid unless <CODE>NULL</CODE>.</td>
385          </tr>
386          <tr>
387            <td width="100"> </td>
388            <th>
389<span class="argument">dop</span>
390            </th>
391<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
392<td>Represents the reliability (dilution of precision) of the position.</td>
393          </tr>
394          <tr>
395            <td width="100"> </td>
396            <th>
397<span class="argument">speed</span>
398            </th>
399<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
400<td>Represents the speed (numeric value).</td>
401          </tr>
402          <tr>
403            <td width="100"> </td>
404            <th>
405<span class="argument">track</span>
406            </th>
407<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
408<td>Represents the tracking direction (numeric value).</td>
409          </tr>
410          <tr>
411            <td width="100"> </td>
412            <th>
413<span class="argument">imgDirection</span>
414            </th>
415<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
416<td>Represents the orientation of the captured image.</td>
417          </tr>
418          <tr>
419            <td width="100"> </td>
420            <th>
421<span class="argument">pMapDatum</span>
422            </th>
423<td width="100">const char *</td>
424<td>Represents map data used for positioning. Valid unless <CODE>NULL</CODE>.</td>
425          </tr>
426          <tr>
427            <td width="100"> </td>
428            <th>
429<span class="argument">destLatitude</span>
430            </th>
431<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
432<td>Represents the latitude of the destination (numeric value).</td>
433          </tr>
434          <tr>
435            <td width="100"> </td>
436            <th>
437<span class="argument">destLongitude</span>
438            </th>
439<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
440<td>Represents the longitude of the destination (numeric value).</td>
441          </tr>
442          <tr>
443            <td width="100"> </td>
444            <th>
445<span class="argument">destBearing</span>
446            </th>
447<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
448<td>Represents the destination bearing (numeric value).</td>
449          </tr>
450          <tr>
451            <td width="100"> </td>
452            <th>
453<span class="argument">destDistance</span>
454            </th>
455<td width="100"><a href="../../../../nn/jpeg/CTR/Rational/Overview.html">Rational</a></td>
456<td>Represents the distance to the destination (numeric value).</td>
457          </tr>
458          <tr>
459            <td width="100"> </td>
460            <th>
461<span class="argument">pProcessingMethod</span>
462            </th>
463<td width="100">const <a href="../../../../nn_types/u8.html">u8</a> *</td>
464<td>Represents the name of the positioning method. Valid unless <CODE>NULL</CODE>.</td>
465          </tr>
466          <tr>
467            <td width="100"> </td>
468            <th>
469<span class="argument">processingMethodSize</span>
470            </th>
471<td width="100">size_t</td>
472<td>Represents the data size in bytes of pProcessingMethod. Valid unless <CODE>0</CODE>.</td>
473          </tr>
474          <tr>
475            <td width="100"> </td>
476            <th>
477<span class="argument">pAreaInformation</span>
478            </th>
479<td width="100">const <a href="../../../../nn_types/u8.html">u8</a> *</td>
480<td>Represents the name of the identified area. Valid unless <CODE>NULL</CODE>.</td>
481          </tr>
482          <tr>
483            <td width="100"> </td>
484            <th>
485<span class="argument">areaInformationSize</span>
486            </th>
487<td width="100">size_t</td>
488<td>Represents the size in bytes of <CODE>pAreaInformation</CODE>. Valid unless <CODE>0</CODE>.</td>
489          </tr>
490          <tr>
491            <td width="100"> </td>
492            <th>
493<span class="argument">pDateStamp</span>
494            </th>
495<td width="100">const char *</td>
496<td>Represents the GPS date stamp. Valid unless <CODE>NULL</CODE>.</td>
497          </tr> </table>
498      </div>
499    </a>
500<h2>Revision History</h2>
501    <div class="section">
502      <dl class="history">
503        <dt>2010/10/21</dt>
504<dd>Initial version.<br />
505        </dd>
506      </dl>
507    </div>
508  <hr><p>CONFIDENTIAL</p></body>
509</html>
510