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>SetUserMakerNote</title>
8  </head>
9  <body>
10<h1><CODE>nn::jpeg::CTR::JpegMpEncoder::SetUserMakerNote</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/jpeg.h&gt;
14void SetUserMakerNote(
15     const u8 * pBuffer,
16     size_t size
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 the data to embed. Specify <CODE>NULL</CODE> to clear the value.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>size</th>
38<td>Specifies the size in bytes of the data to embed. Specify <CODE>0</CODE> to clear this value.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42    <div class="section">
43None.
44               </div>
45<h2>Description</h2>
46    <div class="section">
47<p>Registers various pieces of data to embed in the MakerNote part of a JPEG file.</p><p>To get embedded data, first decode the image or extract its Exif information, and then call the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastUserMakerNotePointer.html">JpegMpDecoder::GetLastUserMakerNotePointer</a></CODE> and <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastUserMakerNoteSize.html">JpegMpDecoder::GetLastUserMakerNoteSize</a></CODE> functions.</p><p><UL> <LI> <font color="#800000">Maximum Size That Can Be Registered</font><BR> The size of data that can be registered in the MakerNote depends on the overall size of the APP1 segment. The MakerNote is included in the Exif data and thus only represents a part of the APP1 segment, and this APP1 segment can only handle sizes up to <CODE>0xFFFF</CODE>. As a result, the size of data that can be embedded in the MakerNote will vary with the size of the thumbnail and other data in the APP1 region. (As a guideline, we recommend that when you encode 640x480 images to have attached thumbnails, YUV422 format, and quality 90, you keep the MakerNote to a size leading to a total no greater than bytes.） </LI></UL></p><p>Call this function before calling the encoding function. Do not destroy the data to embed until after the encoding function completes. 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, if you specify <CODE>0</CODE> for the <SPAN class="argument">size</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>
48<h2>Revision History</h2>
49    <div class="section">
50      <dl class="history">
51        <dt>2010/06/14</dt>
52<dd>Initial version.<br />
53        </dd>
54      </dl>
55    </div>
56  <hr><p>CONFIDENTIAL</p></body>
57</html>
58