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><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/jpeg/Overview.html">jpeg</a>::<a href="../../../../nn/jpeg/CTR/Overview.html">CTR</a>::<a href="../../../../nn/jpeg/CTR/JpegMpEncoder/Overview.html">JpegMpEncoder</a>::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>Parameters</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>0x00</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 a unique ID list for individual images 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 for an image, the ID registered for this image by this function is copied to the unique ID list for individual images (excluding the first 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>
53