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>GetTexture</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/tpl/Overview.html">tpl</a>::<a href="../../../nn/tpl/CTR/Overview.html">CTR</a>::GetTexture</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void * GetTexture(
15     <a href="../../../nn_types/s32.html">s32</a> * mipLevel,
16     <a href="../../../nn_types/u32.html">u32</a> * mipmapSize,
17     const void * pTexPackage,
18     const <a href="../../../nn_types/s16.html">s16</a> texIndex
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>mipLevel</th>
35<td>Number of mipmap levels.</td>
36        </tr>
37        <tr>
38<td>out</td>
39<th>mipmapSize</th>
40<td>Data size (in bytes) of each mipmap (specify an array).</td>
41        </tr>
42        <tr>
43<td>in</td>
44<th>pTexPackage</th>
45<td>Pointer to the header of a texture package file that has been loaded.</td>
46        </tr>
47        <tr>
48<td>in</td>
49<th>texIndex</th>
50<td>Texture index.</td>
51        </tr> </table>
52    </div>
53<h2>Return Values</h2>
54<div class="section">Pointer to the start of the texture. The function returns 0 if the index value could not be found. </div>
55<h2>Description</h2>
56    <div class="section">
57<p>Gets the texture.</p><p>Returns a pointer to the corresponding texture within the package. The main image is also considered to have the maximum size of all the mipmap levels, so if the texture in question is found, the <SPAN class="argument">miplevel</SPAN> argument will always have a value of <CODE>1</CODE> or greater.</p><p>
58Specify valid pointers for <SPAN class="argument">mipLevel</SPAN> and <SPAN class="argument">mipmapSize</SPAN>. If a <CODE>NULL</CODE> pointer is specified, the process stops on an assertion in the Development build.
59            </p></div>
60<h2>Revision History</h2>
61    <div class="section">
62      <dl class="history">
63        <dt>2012/02/01</dt>
64<dd>Added a description of behavior when a <CODE>NULL</CODE> pointer is specified for the <CODE>mipLevel</CODE> and <SPAN class="argument">mipmapSize</SPAN> arguments.<br />
65        </dd>
66        <dt>2010/08/16</dt>
67<dd>Initial version.<br />
68        </dd>
69      </dl>
70    </div>
71  <hr><p>CONFIDENTIAL</p></body>
72</html>