1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<title>SSP_SetJpegEncoderMakerNoteEx</title>
7<link rel="stylesheet" href="../../css/nitro.css" type="text/css" />
8</head>
9<body>
10
11<h1>SSP_SetJpegEncoderMakerNoteEx <img src="../../image/NTR.gif" align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13
14<pre><code>
15void SSP_SetJpegEncoderMakerNoteEx(SSPJpegMakernote tag, u8 *buffer, u16 size);
16</code></pre>
17
18<h2>Arguments</h2>
19<table style="width:100%">
20<tbody>
21<tr>
22<td style="width:13%"><SPAN class="argument">tag</SPAN></td>
23<td style="width:87%">Specifies the type of data items to embed.<BR><CODE>SSP_MAKERNOTE_PHOTO</CODE> indicates data for the DSi camera, and <CODE>SSP_MAKERNOTE_USER</CODE> indicates data for applications.</td>
24</tr>
25<tr>
26<td style="width:13%"><SPAN class="argument">buffer</SPAN></td>
27<td style="width:87%">Data to embed.</td>
28</tr>
29<tr>
30<td style="width:13%"><SPAN class="argument">size</SPAN></td>
31<td style="width:87%">Size of data to embed.</td>
32</tr>
33</tbody>
34</table>
35
36
37<h2>Return Values</h2>
38<p>None.</p>
39
40<h2>Description</h2>
41<p>Registers each type of data to embed in the MakerNote part of a JPEG file.<BR>There are two types of data that can be embedded: <CODE>SSP_MAKERNOTE_PHOTO</CODE>, which represents data for the DSi camera, and <CODE>SSP_MAKERNOTE_USER</CODE>, for the application embedding any data.<BR>The data to embed should have an even number of bytes.<BR><BR> <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 use a size no greater than the total <CODE>0xE000</CODE>.<br> <br> <font color="red"><B>Note:</B></font><br> After the <a href="SSP_StartJpegEncoder.html"><CODE>SSP_StartJpegEncoder</CODE></a> function completes, data set by this function is cleared, regardless of whether encoding succeeds or fails.<br>If multiple images are to be encoded, note that the data must be registered before each encoding.
42</p>
43
44<h2>See Also</h2>
45<p><a href="SSP_StartJpegEncoder.html"><code>SSP_StartJpegEncoder</code></a></p>
46
47<h2>Revision History</h2>
48<p>
492008/09/15 Initial version.
50</p>
51<hr><p>CONFIDENTIAL</p></body>
52</html>
53