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>GetMpRegionsToBuildJpegData</title>
8  </head>
9  <body>
10    <h1><CODE>nn::jpeg::CTR::JpegMpDecoder::GetMpRegionsToBuildJpegData</CODE> Member Function</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">#include &lt;nn/jpeg.h&gt;
14
15bool GetMpRegionsToBuildJpegData(
16     <a href="../../../../nn/jpeg/CTR/MpRegionsToBuildJpegData/Overview.html">MpRegionsToBuildJpegData</a> * pBuffer,
17     const u8 * src,
18     size_t srcSize
19);
20</pre>
21    </div>
22    <h2>Arguments</h2>
23    <div class="section">
24      <table class="arguments">
25        <thead>
26          <tr>
27            <td width="15" />
28            <th>Name</th>
29            <td>Description</td>
30          </tr>
31        </thead>
32        <tr>
33          <td>out</td>
34          <th>pBuffer</th>
35          <td>Specifies the buffer storing the region information.</td>
36        </tr>
37        <tr>
38          <td>in</td>
39          <th>src</th>
40          <td>Specifies the start of the individual image data.</td>
41        </tr>
42        <tr>
43          <td>in</td>
44          <th>srcSize</th>
45          <td>Specifies the size of <SPAN class="argument">src</SPAN> in bytes.</td>
46        </tr> </table>
47    </div>
48    <h2>Return Values</h2>
49    <div class="section">When the function succeeds it returns <CODE>true</CODE>. Returns <CODE>false</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>
50    <h2>Description</h2>
51    <div class="section">
52      <p>This function gets regional information used for rebuilding the JPEG data from the individual image data stored in MP format. </p><p>Simply put, individual image data in MP format has this structure: [(JPEG header) + (APP2) + (JPEG data)], where APP2 includes the MP format attribute information.  Leave out APP2 and you get [(JPEG header) + (JPEG data)], which is JPEG data not in the MP format.  This function gets pointers and byte sizes for the (JPEG header) and (JPEG data) memory regions.</p><p>Generally, [pointer to starting image + return value of <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetMpImageOffset.html">GetMpImageOffset</a></CODE>] is returned in the <SPAN class="argument">src</SPAN> argument, and the return value of <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetMpImageSize.html">GetMpImageSize</a></CODE> is returned in the <SPAN class="argument">srcSize</SPAN> argument. Confirm beforehand that the region specified by <SPAN class="argument">src</SPAN> and <SPAN class="argument">srcSize</SPAN> is a valid region.</p><p>This function will fail if the MP type of the individual image is <span>MP_TYPE_CODE_LARGE_THUMBNAIL_IMAGE_CLASS_1</span> or <span>MP_TYPE_CODE_LARGE_THUMBNAIL_IMAGE_CLASS_2</span> because these types of images are for display on monitors and do not include MP format attribute information. The Exif information can be omitted from images for display on  monitors, so such data are not used for the rebuilding of JPEG data. </p><p>This function only partially performs decoding and shared processing. Consequently, there are some functions you cannot call immediately after calling this function: the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastWidth.html">GetLastWidth</a></CODE>, <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastHeight.html">GetLastHeight</a></CODE>, <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastOutputBufferWidth.html">GetLastOutputBufferWidth</a></CODE>, and <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastOutputBufferHeight.html">GetLastOutputBufferHeight</a></CODE> functions, and all functions that get EXIF information, such as the <CODE><a href="../../../../nn/jpeg/CTR/JpegMpDecoder/GetLastDateTime.html">GetLastDateTime</a></CODE> function. Calls to these functions will have undefined return values.</p></div>
53  <hr><p>CONFIDENTIAL</p></body>
54</html>