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>StartMpEncoderLR</title> 8 </head> 9 <body> 10<h1><CODE>nn::jpeg::CTR::JpegMpEncoder::StartMpEncoderLR</CODE> Member Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition">#include <nn/jpeg.h> 14 15size_t StartMpEncoderLR( 16 u8 * dst, 17 size_t limit, 18 const void * srcL, 19 const void * srcR, 20 u32 width, 21 u32 height, 22 u32 quality, 23 <a href="../../../../nn/jpeg/CTR/PixelSampling.html">PixelSampling</a> dstPixelSampling, 24 <a href="../../../../nn/jpeg/CTR/PixelFormat.html">PixelFormat</a> srcPixelFormat, 25 bool addThumbnailL, 26 bool addThumbnailR 27); 28</pre> 29 </div> 30<h2>Arguments</h2> 31 <div class="section"> 32 <table class="arguments"> 33 <thead> 34 <tr> 35 <td width="15" /> 36<th>Name</th> 37<td>Description</td> 38 </tr> 39 </thead> 40 <tr> 41<td>out</td> 42<th>dst</th> 43<td>Specifies the buffer that stores the encoded result.</td> 44 </tr> 45 <tr> 46<td>in</td> 47<th>limit</th> 48<td>Specifies the size of <SPAN class="argument">dst</SPAN> in bytes. Encoding fails if this size is exceeded.</td> 49 </tr> 50 <tr> 51<td>in</td> 52<th>srcL</th> 53<td>Specifies the image data buffer to encode for the left eye. Must be 4-byte aligned.</td> 54 </tr> 55 <tr> 56<td>in</td> 57<th>srcR</th> 58<td>Specifies the image data buffer to encode for the right eye. Must be 4-byte aligned.</td> 59 </tr> 60 <tr> 61<td>in</td> 62<th>width</th> 63<td>Specifies the image width in pixels (equal to or less than 65536). Shared between the left and right images, except for thumbnails.</td> 64 </tr> 65 <tr> 66<td>in</td> 67<th>height</th> 68<td>Specifies the image height in pixels (equal to or less than 65536). Shared between the left and right images, except for thumbnails.</td> 69 </tr> 70 <tr> 71<td>in</td> 72<th>quality</th> 73<td>Specifies the encoding quality.<br />Values can be set from <CODE>1</CODE> to <CODE>100</CODE>, with <CODE>100</CODE> being the highest quality and the largest size.<br />Shared between the left and right images, except for thumbnails.</td> 74 </tr> 75 <tr> 76<td>in</td> 77<th>dstPixelSampling</th> 78<td>Specifies the image's output format (its pixel sampling). Shared between the left and right images, except for thumbnails.</td> 79 </tr> 80 <tr> 81<td>in</td> 82<th>srcPixelFormat</th> 83<td>Specifies the input pixel format of the image to encode. This value applies to all images.</td> 84 </tr> 85 <tr> 86<td>in</td> 87<th>addThumbnailL</th> 88<td>Specifies whether to add a thumbnail to the image for the left eye.</td> 89 </tr> 90 <tr> 91<td>in</td> 92<th>addThumbnailR</th> 93<td>Specifies whether to add a thumbnail to the image for the right eye.</td> 94 </tr> </table> 95 </div> 96<h2>Return Values</h2> 97<div class="section">If successful, returns the number of bytes of MP-format data that were generated. Returns <CODE>0</CODE> on failure.<br />Use the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpEncoder/GetLastError.html">GetLastError</a></CODE> function to get the reason for failure. </div> 98<h2>Description</h2> 99 <div class="section"> 100<p>Runs the JPEG encoder on two images and stores the results in Extended MP format (for stereoscopic display).</p><p>First, the encoder is run on the image for the left eye, and the result is stored in the MP format as the first (and representative) image. If this is successful, the image for the right eye is then encoded and stored. With this function, the viewpoint number of the left-eye image is considered to be 1, which is also the base viewpoint number. Images for the right eye have viewpoint number 2.</p><p>The widths and heights of images that this function can encode depend on the output format of the image (in other words, the <SPAN class="argument">dstPixelSampling</SPAN> argument). The same is true of the <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/StartJpegEncoder.html"><CODE>StartJpegEncoder</CODE></a> function.</p><p>The convergence angle and baseline length take the default values <CODE>{0xFFFFFFFF, 0xFFFFFFFF}</CODE>.</p><p>Calling the following functions to register data has no effect.<BR></p><p><UL> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetUserMakerNote.html"><CODE>SetUserMakerNote</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetImageUid.html"><CODE>SetImageUid</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpTypeFlags.html"><CODE>SetMpTypeFlags</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpIndividualNum.html"><CODE>SetMpIndividualNum</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpPanOrientation.html"><CODE>SetMpPanOrientation</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpPanOverlapH.html"><CODE>SetMpPanOverlapH</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpPanOverlapV.html"><CODE>SetMpPanOverlapV</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpBaseViewpointNum.html"><CODE>SetMpBaseViewpointNum</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpConvergenceAngle.html"><CODE>SetMpConvergenceAngle</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpBaselineLength.html"><CODE>SetMpBaselineLength</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpVerticalDivergence.html"><CODE>SetMpVerticalDivergence</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpAxisDistanceX.html"><CODE>SetMpAxisDistanceX</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpAxisDistanceY.html"><CODE>SetMpAxisDistanceY</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpAxisDistanceZ.html"><CODE>SetMpAxisDistanceZ</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpYawAngle.html"><CODE>SetMpYawAngle</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpPitchAngle.html"><CODE>SetMpPitchAngle</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetMpRollAngle.html"><CODE>SetMpRollAngle</CODE></a> </LI></UL></p><p>Any values specified in calls to the following functions are valid for both images, with the same value registered.</p><p><UL> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetThumbnailSize.html"><CODE>SetThumbnailSize</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetInputBufferWidth.html"><CODE>SetInputBufferWidth</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetDateTime.html">SetDateTime</a> (*)<LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetSoftware.html"><CODE>SetSoftware</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetOrientation.html"><CODE>SetOrientation</CODE></a> <LI> <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetGpsData.html">SetGpsData</a> </LI></UL></p><p>(*) When <a href="../../../../nn/jpeg/CTR/JpegMpEncoder/SetDateTime.html"><CODE>SetDateTime</CODE></a> has not been called, the function gets the current date and time when encoding the first image, and uses that for both images.</p><!-- write here --></div> 101<h2>Revision History</h2> 102 <div class="section"> 103 <dl class="history"> 104 <dt>2010/10/22</dt> 105<dd>Made revisions to make descriptions easier to understand. 106 </dd> 107 <dt>2010/04/14</dt> 108<dd>Initial version.<br /> 109 </dd> 110 </dl> 111 </div> 112 <hr><p>CONFIDENTIAL</p></body> 113</html>