1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<title>GX_LoadOBJExtPltt</title> 8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 9</head> 10<body> 11<h1 align="left">GX_LoadOBJExtPltt <img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<dl> 14 <dd> 15<PRE> 16<CODE>#include <nitro/gx/gx_load.h></CODE><BR> 17<CODE>void GX_LoadOBJExtPltt(const void *pSrc, u32 destSlotAddr, u32 szByte);</CODE></PRE></dd> 18</dl><h2>Arguments</h2> 19<TABLE border="1" width="100%"> 20 <TBODY> 21 <TR> 22 <TD width="190"><em><strong><font face="Courier New">pSrc</font></strong></em></TD> 23 <TD width="512">Pointer to transfer origin</TD> 24 </TR> 25 <TR> 26 <TD width="190"><em><strong><font face="Courier New">destSlotAddr</font></strong></em></TD> 27 <TD width="512">Address to inside of the transfer source OBJ expanded palette slot</TD> 28 </TR> 29 <TR> 30 <TD width="190"><em><strong><font face="Courier New">szByte</font></strong></em></TD> 31 <TD width="512">Transfer size (in bytes)</TD> 32 </TR> 33 </TBODY> 34</TABLE> 35<h2>Return Values</h2> 36<p>None.</p> 37<H2>Description</H2> 38<P>This function uses DMA to transfer OBJ palette data to the Main 2D Engine's OBJ Extended palette. The transfer destination address (in the OBJ Extended palette) can be specified. Use the <code>GX_DMAID</code> DMA channel (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. Call this function between the <CODE><A href="GX_BeginLoadOBJExtPltt.html">GX_BeginLoadOBJExtPltt</A></CODE> and <CODE><A href="GX_EndLoadOBJExtPltt.html">GX_EndLoadOBJExtPltt</A></CODE> functions.<BR><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. Do not call <A href="GX_SetBankForOBJExtPltt.html"><CODE>GX_SetBankForOBJExtPltt</CODE></A>, <A href="GX_ResetBankForOBJExtPltt.html"><CODE>GX_ResetBankForOBJExtPltt</CODE></A>, or <A href="GX_DisableBankForOBJExtPltt.html"><CODE>GX_DisableBankForOBJExtPltt</CODE></A> between <CODE><A href="GX_BeginLoadOBJExtPltt.html">GX_BeginLoadOBJExtPltt</A></CODE> and <CODE><A href="GX_EndLoadOBJExtPltt.html">GX_EndLoadOBJExtPltt</A></CODE>.</P> 39<h2>See Also</h2> 40<P><code><A href="GX_BeginLoadOBJExtPltt.html">GX_BeginLoadOBJExtPltt</A></code><BR> <code><A href="GX_EndLoadOBJExtPltt.html">GX_EndLoadOBJExtPltt</A></code></P> 41<H2>Revision History</H2> 42<P>2004/02/09</P> 43<UL> 44 <LI>Revised and expanded the description. 45</UL> 46<P>2004/01/19 Initial version.</P> 47<hr><p>CONFIDENTIAL</p></body> 48</html> 49
