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=utf-8" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<title>SSP_StartJpegDecoder</title>
7<link rel="stylesheet" href="../../css/nitro.css" type="text/css" />
8</head>
9<body>
10
11<h1>SSP_StartJpegDecoder <img src="../../image/NTR.gif" align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13
14<pre><code>
15BOOL SSP_StartJpegDecoder(u8* data, u32 size, void* dst, s16* width, s16* height, u32 option);
16</code></pre>
17
18<h2>Arguments</h2>
19<table style="width:100%">
20<tbody>
21<tr>
22<td style="width:13%"><em><strong>data</strong></em></td>
23<td style="width:87%">JPEG file to decode.</td>
24</tr>
25<tr>
26<td style="width:13%"><em><strong>size</strong></em></td>
27<td style="width:87%">Size of the JPEG file to decode.</td>
28</tr>
29<tr>
30<td style="width:13%"><em><strong>dst</strong></em></td>
31<td style="width:87%">Buffer used to store a decoded image.<br> A buffer of the size <SPAN class="argument">width</SPAN> * <SPAN class="argument">height</SPAN> * 2 is required.</td>
32</tr>
33<tr>
34<td style="width:13%"><em><strong>width</strong></em></td>
35<td style="width:87%">Maximum width allowed (in pixels) for the image to decode.<br>When decoding has finished, the decoded image's width is stored here.</td>
36</tr>
37<tr>
38<td style="width:13%"><em><strong>height</strong></em></td>
39<td style="width:87%">Maximum height allowed (in pixels) for the image to decode. When decoding has finished, the decoded image's height is stored here.</td>
40</tr>
41<tr>
42<td style="width:13%"><em><strong>option</strong></em></td>
43<td style="width:87%">Decoding option (<CODE>SSP_JPEG_THUMBNAIL</CODE>).</td>
44</tr>
45</tbody>
46</table>
47
48
49<h2>Return Values</h2>
50<p>Returns <CODE>TRUE</CODE> if successful.</p>
51
52<h2>Description</h2>
53<p>Decodes a JPEG file into RGB555 image data. JPEG files can be decoded only from the YUV420, YUV422, and YUV444 formats.<br> If <CODE>SSP_JPEG_THUMBNAIL</CODE> is specified for <SPAN class="argument">option</SPAN>, this function decodes a thumbnail image. If nothing is specified (0 is specified), it decodes the main image.<br> <br> <font color="red">Note:</font><br> This decoder is only guaranteed to decode JPEG files created using the SSP encoder.<br> Note that some JPEG files created with other software cannot be decoded.<br> Decoding often fails due to additional EXIF information.<br> When this happens, omit the EXIF information from the image .<br>
54</p>
55
56<h2>Revision History</h2>
57<p>
582009/09/17 Added information about failed decoding of JPEG files.<br>2009/07/28 Revised the description of specifying options.<br>2009/01/09 Deleted the description of signatures.<br>2008/11/04 Added a description of when decoding fails.<br>2008/10/09 Added a description of configuring RSF files.<br>2008/09/15 Initial version.<br>
59</p>
60<hr><p>CONFIDENTIAL</p></body>
61</html>
62