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<title>InitializeGpsData</title>
8  </head>
9  <body>
10<h1>nn::jpeg::CTR::JpegMpEncoder::InitializeGpsData Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/jpeg.h&gt;
14
15static void InitializeGpsData(
16     <a href="../../../../nn/jpeg/CTR/GpsData/Overview.html">GpsData</a> * pGps
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>out</td>
32<th>pGps</th>
33<td>Specifies the GPS IFD (structure used for storing GPS data). The stored data format is easy for the library to process and is different from the binary format that results from encoding.  </td>
34        </tr> </table>
35    </div>
36<h2>Return Values</h2>
37    <div class="section">
38None.
39               </div>
40<h2>Description</h2>
41    <div class="section">
42<p>Initializes the structure used for registering GPS IFD data.</p><p>The procedure for storing GPS information in the image and storing it is given below.</p><p><OL> <LI> The application should maintain the GPS IFD structure for storing information and initialize it with this function.<LI> Call the <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsLatitude.html">SetGpsLatitude</a> and <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsLongitude.html">SetGpsLongitude</a> functions to store GPS information in the structure. Depending on the function, some structure members, such as <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsSatellites.html">SetGpsSatellites</a>, only maintain a pointer to the data to store. In this case, you must maintain the data to store until encoding ends. <LI> Once all data has been stored in the structure, be sure to confirm the data by calling the <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsData.html">SetGpsData</a> function.<br />The encoder object only maintains a pointer to this structure. This structure must therefore be maintained until encoding ends.<LI> Call the encoding function and encode the image. <LI> Whether it succeeds or fails, once the encoding function exits, the structure and data to be stored can be released. To reuse this structure, be sure to re-initialize it with this function. </LI></OL></p><p>After initialization, the the structure only stores the GPS tag version (2.2 is the default for this library). The version can be changed by calling the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsVersionId.html">SetGpsVersionId</a></CODE> function. The system can be instructed not to save the version by calling the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/ClearGpsVersionId.html">ClearGpsVersionId</a></CODE> function.</p><!-- write here --></div>
43<h2>Revision History</h2>
44    <div class="section">
45      <dl class="history">
46        <dt>2010/10/22</dt>
47<dd>Initial version.<br />
48        </dd>
49      </dl>
50    </div>
51  <hr><p>CONFIDENTIAL</p></body>
52</html>