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>nn::jpeg::CTR::GpsData Structure</h1>
52<h2>Syntax</h2>
53    <div class="section">
54      <pre class="definition">struct GpsData
55{
56   bool isVersionIdValid;
57   bool isLatitudeValid;
58   bool isLongitudeValid;
59   bool isAltitudeRefValid;
60   bool isAltitudeValid;
61   bool isTimeStampValid;
62   bool isDopValid;
63   bool isSpeedValid;
64   bool isTrackValid;
65   bool isImgDirectionValid;
66   bool isDestLatitudeValid;
67   bool isDestLongitudeValid;
68   bool isDestBearingValid;
69   bool isDestDistanceValid;
70   bool isDifferentialValid;
71   u8 altitudeRef;
72   u8 versionId[GPS_VERSION_ID_SIZE];
73   char latitudeRef[GPS_REF_SIZE];
74   char longitudeRef[GPS_REF_SIZE];
75   char status[GPS_REF_SIZE];
76   char measureMode[GPS_REF_SIZE];
77   char speedRef[GPS_REF_SIZE];
78   char trackRef[GPS_REF_SIZE];
79   char imgDirectionRef[GPS_REF_SIZE];
80   char destLatitudeRef[GPS_REF_SIZE];
81   char destLongitudeRef[GPS_REF_SIZE];
82   char destBearingRef[GPS_REF_SIZE];
83   char destDistanceRef[GPS_REF_SIZE];
84   u16 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];
89   const 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;
94   const 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;
99   const u8 * pProcessingMethod;
100   size_t processingMethodSize;
101   const u8 * pAreaInformation;
102   size_t areaInformationSize;
103   const 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>Indicates whether the <CODE>versionID</CODE> is valid.</td>
120          </tr>
121          <tr>
122            <td width="100"> </td>
123            <th>
124<span class="argument">isLatitudeValid</span>
125            </th>
126<td>Indicates whether <CODE>latitude</CODE> is valid.</td>
127          </tr>
128          <tr>
129            <td width="100"> </td>
130            <th>
131<span class="argument">isLongitudeValid</span>
132            </th>
133<td>Indicates whether <CODE>longitude</CODE> is valid.</td>
134          </tr>
135          <tr>
136            <td width="100"> </td>
137            <th>
138<span class="argument">isAltitudeRefValid</span>
139            </th>
140<td>Indicates whether <CODE>altitudeRef</CODE> is valid.</td>
141          </tr>
142          <tr>
143            <td width="100"> </td>
144            <th>
145<span class="argument">isAltitudeValid</span>
146            </th>
147<td>Indicates whether <CODE>altitude</CODE> is valid.</td>
148          </tr>
149          <tr>
150            <td width="100"> </td>
151            <th>
152<span class="argument">isTimeStampValid</span>
153            </th>
154<td>Indicates whether <CODE>timeStamp</CODE> is valid.</td>
155          </tr>
156          <tr>
157            <td width="100"> </td>
158            <th>
159<span class="argument">isDopValid</span>
160            </th>
161<td>Indicates whether <CODE>DOP</CODE> is valid.</td>
162          </tr>
163          <tr>
164            <td width="100"> </td>
165            <th>
166<span class="argument">isSpeedValid</span>
167            </th>
168<td>Indicates whether <CODE>speed</CODE> is valid.</td>
169          </tr>
170          <tr>
171            <td width="100"> </td>
172            <th>
173<span class="argument">isTrackValid</span>
174            </th>
175<td>Indicates whether <CODE>track</CODE> is valid.</td>
176          </tr>
177          <tr>
178            <td width="100"> </td>
179            <th>
180<span class="argument">isImgDirectionValid</span>
181            </th>
182<td>Indicates whether <CODE>imgDirection</CODE> is valid.</td>
183          </tr>
184          <tr>
185            <td width="100"> </td>
186            <th>
187<span class="argument">isDestLatitudeValid</span>
188            </th>
189<td>Indicates whether <CODE>destLatitude</CODE> is valid.</td>
190          </tr>
191          <tr>
192            <td width="100"> </td>
193            <th>
194<span class="argument">isDestLongitudeValid</span>
195            </th>
196<td>Indicates whether <CODE>destLongitude</CODE> is valid.</td>
197          </tr>
198          <tr>
199            <td width="100"> </td>
200            <th>
201<span class="argument">isDestBearingValid</span>
202            </th>
203<td>Indicates whether <CODE>destBearing</CODE> is valid.</td>
204          </tr>
205          <tr>
206            <td width="100"> </td>
207            <th>
208<span class="argument">isDestDistanceValid</span>
209            </th>
210<td>Indicates whether <CODE>destDistance</CODE> is valid.</td>
211          </tr>
212          <tr>
213            <td width="100"> </td>
214            <th>
215<span class="argument">isDifferentialValid</span>
216            </th>
217<td>Indicates whether <CODE>differential</CODE> is valid.</td>
218          </tr>
219          <tr>
220            <td width="100"> </td>
221            <th>
222<span class="argument">altitudeRef</span>
223            </th>
224<td>Represents the <CODE>altitude</CODE> reference.</td>
225          </tr>
226          <tr>
227            <td width="100"> </td>
228            <th>
229<span class="argument">versionId</span>
230            </th>
231<td>Represents the GPS tag version.</td>
232          </tr>
233          <tr>
234            <td width="100"> </td>
235            <th>
236<span class="argument">latitudeRef</span>
237            </th>
238<td>Represents North (N) or South (S). Valid if element 0 is not 0. Element [1] is always 0.</td>
239          </tr>
240          <tr>
241            <td width="100"> </td>
242            <th>
243<span class="argument">longitudeRef</span>
244            </th>
245<td>Represents East (E) or West (W) Valid if element 0 is not 0. Element [1] is always 0.</td>
246          </tr>
247          <tr>
248            <td width="100"> </td>
249            <th>
250<span class="argument">status</span>
251            </th>
252<td>Represents the GPS receiver status. Valid if element 0 is not 0. Element [1] is always 0.</td>
253          </tr>
254          <tr>
255            <td width="100"> </td>
256            <th>
257<span class="argument">measureMode</span>
258            </th>
259<td>Represents the GPS measurement method. Valid if element 0 is not 0. Element [1] is always 0.</td>
260          </tr>
261          <tr>
262            <td width="100"> </td>
263            <th>
264<span class="argument">speedRef</span>
265            </th>
266<td>Represents the velocity unit. Valid if element 0 is not 0. Element [1] is always 0.</td>
267          </tr>
268          <tr>
269            <td width="100"> </td>
270            <th>
271<span class="argument">trackRef</span>
272            </th>
273<td>Represents the tracking direction. Valid if element 0 is not 0. Element [1] is always 0.</td>
274          </tr>
275          <tr>
276            <td width="100"> </td>
277            <th>
278<span class="argument">imgDirectionRef</span>
279            </th>
280<td>Represents the orientation of the captured image. 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">destLatitudeRef</span>
286            </th>
287<td>Represents North (N) or South (S) latitude of the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
288          </tr>
289          <tr>
290            <td width="100"> </td>
291            <th>
292<span class="argument">destLongitudeRef</span>
293            </th>
294<td>Represents East (E) or West (W) longitude of the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
295          </tr>
296          <tr>
297            <td width="100"> </td>
298            <th>
299<span class="argument">destBearingRef</span>
300            </th>
301<td>Represents the bearing to the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
302          </tr>
303          <tr>
304            <td width="100"> </td>
305            <th>
306<span class="argument">destDistanceRef</span>
307            </th>
308<td>Represents the distance to the destination. Valid if element 0 is not 0. Element [1] is always 0.</td>
309          </tr>
310          <tr>
311            <td width="100"> </td>
312            <th>
313<span class="argument">differential</span>
314            </th>
315<td>Represents the GPS differential.</td>
316          </tr>
317          <tr>
318            <td width="100"> </td>
319            <th>
320<span class="argument"><CODE>latitude</CODE></span>
321            </th>
322<td>Represents the latitude (numeric value).</td>
323          </tr>
324          <tr>
325            <td width="100"> </td>
326            <th>
327<span class="argument"><CODE>longitude</CODE></span>
328            </th>
329<td>Represents the longitude (numeric value).</td>
330          </tr>
331          <tr>
332            <td width="100"> </td>
333            <th>
334<span class="argument">altitude</span>
335            </th>
336<td>Represents the altitude (numeric value).</td>
337          </tr>
338          <tr>
339            <td width="100"> </td>
340            <th>
341<span class="argument">timeStamp</span>
342            </th>
343<td>Represents the GPS time (atomic clock time)</td>
344          </tr>
345          <tr>
346            <td width="100"> </td>
347            <th>
348<span class="argument">pSatellites</span>
349            </th>
350<td>Represents the satellite signal used for positioning. Valid unless <CODE>NULL</CODE>.</td>
351          </tr>
352          <tr>
353            <td width="100"> </td>
354            <th>
355<span class="argument">dop</span>
356            </th>
357<td>Represents the reliability (dilution of precision) of the position.</td>
358          </tr>
359          <tr>
360            <td width="100"> </td>
361            <th>
362<span class="argument">speed</span>
363            </th>
364<td>Represents the speed (numeric value).</td>
365          </tr>
366          <tr>
367            <td width="100"> </td>
368            <th>
369<span class="argument">track</span>
370            </th>
371<td>Represents the tracking direction (numeric value).</td>
372          </tr>
373          <tr>
374            <td width="100"> </td>
375            <th>
376<span class="argument">imgDirection</span>
377            </th>
378<td>Represents the orientation of the captured image.</td>
379          </tr>
380          <tr>
381            <td width="100"> </td>
382            <th>
383<span class="argument">pMapDatum</span>
384            </th>
385<td>Represents map data used for positioning. Valid unless <CODE>NULL</CODE>.</td>
386          </tr>
387          <tr>
388            <td width="100"> </td>
389            <th>
390<span class="argument">destLatitude</span>
391            </th>
392<td>Represents the latitude of the destination (numeric value).</td>
393          </tr>
394          <tr>
395            <td width="100"> </td>
396            <th>
397<span class="argument">destLongitude</span>
398            </th>
399<td>Represents the longitude of the destination (numeric value).</td>
400          </tr>
401          <tr>
402            <td width="100"> </td>
403            <th>
404<span class="argument">destBearing</span>
405            </th>
406<td>Represents the destination bearing (numeric value).</td>
407          </tr>
408          <tr>
409            <td width="100"> </td>
410            <th>
411<span class="argument">destDistance</span>
412            </th>
413<td>Represents the distance to the destination (numeric value).</td>
414          </tr>
415          <tr>
416            <td width="100"> </td>
417            <th>
418<span class="argument">pProcessingMethod</span>
419            </th>
420<td>Represents the name of the positioning method. Valid unless <CODE>NULL</CODE>.</td>
421          </tr>
422          <tr>
423            <td width="100"> </td>
424            <th>
425<span class="argument">processingMethodSize</span>
426            </th>
427<td>Represents the data size in bytes of pProcessingMethod. Valid unless <CODE>0</CODE>.</td>
428          </tr>
429          <tr>
430            <td width="100"> </td>
431            <th>
432<span class="argument">pAreaInformation</span>
433            </th>
434<td>Represents the name of the identified area. Valid unless <CODE>NULL</CODE>.</td>
435          </tr>
436          <tr>
437            <td width="100"> </td>
438            <th>
439<span class="argument">areaInformationSize</span>
440            </th>
441<td>Represents the size in bytes of <CODE>pAreaInformation</CODE>. Valid unless <CODE>0</CODE>.</td>
442          </tr>
443          <tr>
444            <td width="100"> </td>
445            <th>
446<span class="argument">pDateStamp</span>
447            </th>
448<td>Represents the GPS date stamp. Valid unless <CODE>NULL</CODE>.</td>
449          </tr> </table>
450      </div>
451    </a>
452<h2>Revision History</h2>
453    <div class="section">
454      <dl class="history">
455        <dt>2010/10/21</dt>
456<dd>Initial version.<br />
457        </dd>
458      </dl>
459    </div>
460  <hr><p>CONFIDENTIAL</p></body>
461</html>
462