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>GenerateMipMaps</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../../nn/Overview.html">nn</a>::<a href="../../../../nn/gd/Overview.html">gd</a>::<a href="../../../../nn/gd/CTR/Overview.html">CTR</a>::<a href="../../../../nn/gd/CTR/Memory/Overview.html">Memory</a>::GenerateMipMaps</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14static <a href="../../../../nnResult/Overview.html">nnResult</a> GenerateMipMaps(
15     const Texture2DResource * tex2DResource,
16     <a href="../../../../nn_types/u32.html">u32</a> mipLevelSourceIndex,
17     <a href="../../../../nn_types/s32.html">s32</a> mipLevelLastDestinationIndex
18);
19</pre>
20    </div>
21<h2>Arguments</h2>
22    <div class="section">
23      <table class="arguments">
24        <thead>
25          <tr>
26            <td width="15" />
27<th>Name</th>
28<td>Description</td>
29          </tr>
30        </thead>
31        <tr>
32<td>in</td>
33<th>tex2DResource</th>
34<td>Specifies the source <SPAN class="Argument">Texture2DResource</SPAN> resource. </td>
35        </tr>
36        <tr>
37<td>in</td>
38<th>mipLevelSourceIndex</th>
39<td>Specifies the index of the mipmap level of the source. </td>
40        </tr>
41        <tr>
42<td>in</td>
43<th>mipLevelLastDestinationIndex</th>
44<td>Specifies the index of the last mipmap level of the destination.  If <CODE>-1</CODE> is specified, the last mipmap level index is used. </td>
45        </tr> </table>
46    </div>
47<h2>Return Values</h2>
48<div class="section">Returns the result of the operation. <br />
49      <table class="arguments">
50        <thead>
51          <tr>
52<th>Value</th>
53<td>Description</td>
54          </tr>
55        </thead>
56        <tr>
57<th><CODE>Result::IsSuccess</CODE></th>
58<td>Process was successful.</td>
59        </tr>
60        <tr>
61<th>ResultNullParameter</th>
62<td>NULL was specified for the specified <SPAN class="Argument">Texture2DResource</SPAN> resource. </td>
63        </tr>
64        <tr>
65<th>ResultInvalidTextureMipLevelIndex</th>
66<td>The mipmap index is invalid. </td>
67        </tr>
68        <tr>
69<th>ResultInvalidTextureFormat</th>
70<td>The specified resource pixel format size is invalid. Specify a pixel format size of 32, 24, or 16. </td>
71        </tr>
72        <tr>
73<th>ResultInvalidTextureResolution</th>
74<td>The resolution of the smallest mipmap level is 32 bytes when the pixel format size of the specified format is 32 bits or 24 bits, but is 64 bytes when the pixel format size is 16 bits.</td>
75        </tr>
76        <tr>
77<th>ResultInvalidTextureMipLevelIndexForMipmapAutoGeneration</th>
78<td>The last mipmap level generated must have a resolution of 32 bits or better if the pixel format is 32 or 24, or a  resolution of 64 bits or better if the pixel format is 16.</td>
79        </tr>
80      </table> </div>
81<h2>Description</h2>
82    <div class="section">
83<p>Creates a <SPAN class="Argument">Texture2DResource</SPAN> resource mipmap. </p><p>Pixel formats that can be specified: <br /><itemizedlist><listitem><para>NATIVE_FORMAT_RGBA_8888 <br /></para></listitem><listitem><para>NATIVE_FORMAT_RGB_888 <br /></para></listitem><listitem><para>NATIVE_FORMAT_RGBA_4444 <br /></para></listitem><listitem><para>NATIVE_FORMAT_RGBA_5551 <br /></para></listitem><listitem><para>NATIVE_FORMAT_RGB_565 <br /></para></listitem></itemizedlist> If the pixel format of the <CODE>Texture2DResource</CODE> resource is 24 or 32 bits, the data size for the mipmap level to be created is either larger than that or 32x32. If the pixel format of the <SPAN class="Argument">Texture2DResource</SPAN> resource is 16 bits, the data size for the mipmap level to be created is either larger than that or 64x64. A function with the same functionality as <CODE>nngxFilterBlockImage</CODE> is called internally. <br /> This function is added to the command list. Refer to the Programming Manual for details.</p><!-- write here --></div>
84<h2>Revision History</h2>
85    <div class="section">
86      <dl class="history">
87        <dt>2011/02/17</dt>
88<dd>Initial version.<br />
89        </dd>
90      </dl>
91    </div>
92  <hr><p>CONFIDENTIAL</p></body>
93</html>