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>SetImageUid</title>
8  </head>
9  <body>
10<h1><CODE>nn::jpeg::CTR::JpegMpEncoder::SetImageUid</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/jpeg.h&gt;
14
15void SetImageUid(
16     const char * pBuffer
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>in</td>
32<th>pBuffer</th>
33<td>Specifies a unique image ID.<br />The ID is a 128-bit integer value represented as a 32-character hexadecimal ASCII string. When the terminating <CODE>&quot;</CODE> character is included, this value has a byte length of <a href="../../../../nn/jpeg/CTR/IMAGE_UID_SIZE.html"><CODE>IMAGE_UID_SIZE</CODE></a> (33) bytes.<br />Specify <CODE>NULL</CODE> to clear the value.</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>Registers the unique image ID to embed in the Exif IFD of a JPEG file.</p><p>To get embedded data, first either decode the image or extract its Exif information, and then call the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastImageUid.html">JpegMpDecoder::GetLastImageUid</a></CODE> function.</p><p>When using MP format, specify to append an individual unique image ID list using the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/StartMpEncoderFirst.html">StartMpEncoderFirst</a></CODE> function, and then every time you call the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/StartMpEncoderNext.html">StartMpEncoderNext</a></CODE> function, the ID registered by this function is copied as an individual unique image ID. (Except for the starting image.)</p><p>Call this function before calling the encoding function. The values specified by this function are cleared after the encoding function completes, regardless of whether the encoding function succeeded or failed. When encoding multiple times, you must call this function before each encoding function call. The values specified by this function are also cleared if you specify <CODE>NULL</CODE> for the <SPAN class="argument">pBuffer</SPAN> argument, or if you reinitialize the encoder object using the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/Initialize.html">Initialize</a></CODE> function.</p><!-- write here --></div>
43<h2>Revision History</h2>
44    <div class="section">
45      <dl class="history">
46        <dt>2010/06/14</dt>
47<dd>Initial version.<br />
48        </dd>
49      </dl>
50    </div>
51  <hr><p>CONFIDENTIAL</p></body>
52</html>