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>StartMpDecoderLR</title> 8 </head> 9 <body> 10<h1><CODE>nn::jpeg::CTR::JpegMpDecoder::StartMpDecoderLR</CODE> Member Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition">#include <nn/jpeg.h> 14 15size_t StartMpDecoderLR( 16 void * dstL, 17 void * dstR, 18 size_t dstSize, 19 const u8 * src, 20 size_t srcSize, 21 u32 maxWidth, 22 u32 maxHeight, 23 <a href="../../../../nn/jpeg/CTR/PixelFormat.html">PixelFormat</a> dstPixelFormat 24); 25</pre> 26 </div> 27<h2>Arguments</h2> 28 <div class="section"> 29 <table class="arguments"> 30 <thead> 31 <tr> 32 <td width="15" /> 33<th>Name</th> 34<td>Description</td> 35 </tr> 36 </thead> 37 <tr> 38<td>out</td> 39<th>dstL</th> 40<td>Specifies the buffer for storing the decoded result of the starting image.<br />The alignment of this buffer must match the output pixel format (in other words, the <SPAN class="argument">dstPixelFormat</SPAN> argument).</td> 41 </tr> 42 <tr> 43<td>out</td> 44<th>dstR</th> 45<td>Specifies the buffer for storing the decoded result of the next individual image.<br />The alignment of this buffer must match the output pixel format (in other words, the <SPAN class="argument">dstPixelFormat</SPAN> argument).</td> 46 </tr> 47 <tr> 48<td>in</td> 49<th>dstSize</th> 50<td>Specifies the size of <SPAN class="argument">dstL</SPAN> and <SPAN class="argument">dstR</SPAN> in bytes.<br /> This is the size of a single image, not the sum of two images.<br />Specify the return value of <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetDstBufferSize.html">GetDstBufferSize</a></CODE>.</td> 51 </tr> 52 <tr> 53<td>in</td> 54<th>src</th> 55<td>Specifies the MP-format data to decode.</td> 56 </tr> 57 <tr> 58<td>in</td> 59<th>srcSize</th> 60<td>Specifies the size of <SPAN class="argument">src</SPAN> in bytes.</td> 61 </tr> 62 <tr> 63<td>in</td> 64<th>maxWidth</th> 65<td>Specifies the maximum width (in pixels) of an image that can be decoded. (Up to 65536) <br />After decoding successfully completes, you can use the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastWidth.html">GetLastWidth</a></CODE> function to get the wifth of the actual image and the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastOutputBufferWidth.html">GetLastOutputBufferWidth</a></CODE> function to get the width in the buffer (for one image).</td> 66 </tr> 67 <tr> 68<td>in</td> 69<th>maxHeight</th> 70<td>Specifies the maximum height (in pixels) of an image that can be decoded. (Up to 65536) <br />After decoding successfully completes, you can use the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastHeight.html">GetLastHeight</a></CODE> function to get the height of the actual image and the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastOutputBufferHeight.html">GetLastOutputBufferHeight</a></CODE> function to get the height in the buffer (for one image).</td> 71 </tr> 72 <tr> 73<td>in</td> 74<th>dstPixelFormat</th> 75<td>Specifies the output pixel format.</td> 76 </tr> </table> 77 </div> 78<h2>Return Values</h2> 79<div class="section">When the function succeeds, the resulting buffer size (in bytes) is returned.<br />This is the size of a single image, not the sum of two images.<br />If the function fails it returns <CODE>0</CODE>.<br />Use the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastError.html">GetLastError</a></CODE> function to get the reason for failure. </div> 80<h2>Description</h2> 81 <div class="section"> 82<p>Runs the JPEG decoder on a pair of images stored in the MP Format.</p><p>Much as for the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/StartJpegDecoder.html">StartJpegDecoder</a></CODE> function, processing takes longer if the image size is not a multiple of 8 or 16 pixels. The same is true of the alignment of the <SPAN class="argument">dst</SPAN> argument.</p><p>The MP type of the image data stored in MP format is looked up in MP entry storage order, and only two stereoscopic images are decoded. The lookup does not check if the first stereoscopic image found is for the left eye, however, nor if the next image is for the right eye.</p><p>This function requires that both primary images are the same size. After this function completes successfully, call the <a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastWidth.html"><CODE>GetLastWidth</CODE></a> and <a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastHeight.html"><CODE>GetLastHeight</CODE></a> functions to get the original image's dimensions. If the sizes do not match, decoding fails. The function also fails if fewer than 2 original images could be decoded. Thumbnails are not decoded.</p><p>After successful decoding, this function decodes the Exif information for two stereoscopic images in the order that the MP entries are stored.<br />When the following functions are used to obtain Exif information, what they obtain is the Exif information for the last image decoded (stored as the second MP entry).<br />・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastDateTime.html">GetLastDateTime</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastSoftwarePointer.html">GetLastSoftwarePointer</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastSoftwareLength.html">GetLastSoftwareLength</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastUserMakerNotePointer.html">GetLastUserMakerNotePointer</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastUserMakerNoteSize.html">GetLastUserMakerNoteSize</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastImageUid.html">GetLastImageUid</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastOrientation.html">GetLastOrientation</a><br /> ・GetLastGpsData<br /></p><p>The following functions also work, but we do not recommend using them.<br />・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastTwlPhotoMakerNote.html">GetLastTwlPhotoMakerNote</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastTwlUserMakerNotePointer.html">GetLastTwlUserMakerNotePointer</a><br /> ・<a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastTwlUserMakerNoteSize.html">GetLastTwlUserMakerNoteSize</a><br /></p><p>To get the Exif information for each image, decode each individually without using this function, or use the <a href="../../../../nn/jpeg/CTR/JpegMpDecoder/ExtractExif.html"><CODE>ExtractExif</CODE></a> function.</p><!-- write here --></div> 83<h2>Revision History</h2> 84 <div class="section"> 85 <dl class="history"> 86 <dt>2010/04/14</dt> 87<dd>Initial version.<br /> 88 </dd> 89 </dl> 90 </div> 91 <hr><p>CONFIDENTIAL</p></body> 92</html>