1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>GX_LoadTexEx</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_LoadTexEx <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1>
15<H2>Syntax</H2>
16
17<dl>
18  <dd>
19<PRE><CODE>#include &lt;nitro/gx/gx_load.h&gt;
20
21void GX_LoadTexEx(
22    GXVRamTex tex,
23    const void *pSrc,
24    u32 destSlotAddr,
25    u32 szByte
26);</CODE></PRE></dd>
27</dl><h2>Arguments</h2>
28<TABLE border="1" width="100%">
29  <TBODY>
30    <TR>
31      <TD><em><strong><font face="Courier New">tex</font></strong></em></TD>
32      <TD>Texture image slot setting</TD>
33    </TR>
34    <TR>
35      <TD width="190"><em><strong><font face="Courier New">pSrc</font></strong></em></TD>
36      <TD width="512">Pointer to transfer origin</TD>
37    </TR>
38    <TR>
39      <TD width="190"><em><strong><font face="Courier New">destSlotAddr</font></strong></em></TD>
40      <TD width="512">Address in transfer destination texture image slot</TD>
41    </TR>
42    <TR>
43      <TD width="190"><em><strong><font face="Courier New">szByte</font></strong></em></TD>
44      <TD width="512">Transfer size (in bytes)</TD>
45    </TR>
46  </TBODY>
47</TABLE>
48<h2>Return Values</h2>
49<p>None.</p>
50<H2>Description</H2>
51<P>This function uses DMA to transfer texture images to VRAM banks that can be allocated to texture image slots. The transfer destination address (in the texture image slot) can be specified. The DMA channel to use here is <code>GX_DMAID</code> (defined in <code>gxcommon.h</code>). Both <em><strong><code>destSlotAddr</code></strong></em> and <em><strong><code>szByte</code></strong></em> must be 4-byte aligned.<BR> <B>Notes:</B> Because the DMA transfer is carried out internally, the transfer source data must be written to main memory in advance using a function such as <CODE><A href="../../os/cache/DC_FlushRange.html" target="_self">DC_FlushRange</A></CODE>.<BR>If the regions for transfer source and transfer destination overlap, the operation result is undefined. The VRAM bank specified by <em><strong><code>tex</code></strong></em> must be mapped in LCDC space.</P>
52
53<h2>See Also</h2>
54<P><A href="GX_LoadTex.html">GX_LoadTex</A></P>
55<H2>Revision History</H2>
56<P>2004/02/23 Initial version.</P>
57<hr><p>CONFIDENTIAL</p></body>
58</html>
59