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>CreateTexture2DResourceCastFrom</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/Resource/Overview.html">Resource</a>::CreateTexture2DResourceCastFrom</CODE> Member Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14static <a href="../../../../nnResult/Overview.html">nnResult</a> CreateTexture2DResourceCastFrom(
15     const Texture2DResource * initialTexture2DResource,
16     <a href="../../../../nn/gd/CTR/Resource/NativeFormat.html">Resource::NativeFormat</a> format,
17     <a href="../../../../nn/gd/CTR/Memory/MemoryLayout.html">Memory::MemoryLayout</a> layout,
18     Texture2DResource ** texture2DResource
19);
20</pre>
21    </div>
22<h2>Parameters</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>in</td>
34<th>initialTexture2DResource</th>
35<td>Specifies the original Texture2DResource to cast.</td>
36        </tr>
37        <tr>
38<td>in</td>
39<th>format</th>
40<td>Specifies a new pixel format.</td>
41        </tr>
42        <tr>
43<td>in</td>
44<th>layout</th>
45<td>Specifies a new memory layout.</td>
46        </tr>
47        <tr>
48<td>out</td>
49<th>texture2DResource</th>
50<td>Specifies the address storing the pointer to the created resource.</td>
51        </tr> </table>
52    </div>
53<h2>Return Values</h2>
54<div class="section">Returns the result of the operation. <br />
55      <table class="arguments">
56        <thead>
57          <tr>
58<th>Value</th>
59<td>Description</td>
60          </tr>
61        </thead>
62        <tr>
63<th><CODE>Result::IsSuccess</CODE></th>
64<td>Process was successful.</td>
65        </tr>
66        <tr>
67<th><CODE>ResultNullParameter</CODE></th>
68<td><CODE>NULL</CODE> was specified in an argument.</td>
69        </tr>
70        <tr>
71<th><CODE>ResultInvalidTextureFormat</CODE></th>
72<td>The pixel format of <SPAN class="argument">format</SPAN> is invalid. The pixel size of the pixel format must be the same size as the pixel size for <SPAN class="argument">initialTexture2DResource</SPAN>.</td>
73        </tr>
74        <tr>
75<th><CODE>ResultOutOfMemory</CODE></th>
76<td>Memory cannot be allocated for the resource object.</td>
77        </tr>
78      </table> </div>
79<h2>Description</h2>
80    <div class="section">
81<p>Casts an existing <CODE>Texture2DResource</CODE> resource to a different format.</p><p>The new <CODE>Texture2DResource</CODE> resource utilizes the same memory region as the original resource, but it can be defined with a different pixel format and memory layout. The pixel format of the new resource must be the same size as that of the original resource. You can use this feature to utilize <CODE>Texture2DResource</CODE> resources in a number of different ways. (For example, to use a resource as 2D texture in depth, shadow, and gas formats.)</p><!-- write here --></div>
82<h2>Revision History</h2>
83    <div class="section">
84      <dl class="history">
85        <dt>2011/02/17</dt>
86<dd>Initial version.<br />
87        </dd>
88      </dl>
89    </div>
90  <hr><p>CONFIDENTIAL</p></body>
91</html>