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_LoadTexPlttEx</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_LoadTexPlttEx <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_LoadTexPlttEx(
22    GXVRamTexPltt texPltt,
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">texPltt</font></strong></em></TD>
32      <TD>Texture palette 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 palette 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 palette data to VRAM banks that can be allocated to texture palettes. The transfer destination address (in the texture palette) 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>texPltt</code></strong></em> must be mapped in LCDC space.</P>
52
53<h2>See Also</h2>
54<P><A href="GX_LoadTexPltt.html">GX_LoadTexPltt</A></P>
55<H2>Revision History</H2>
56<P>2004/02/23 Initial version.</P>
57
58<hr><p>CONFIDENTIAL</p></body>
59</html>
60