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 8.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>GX_BeginLoadClearImage</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">GX_BeginLoadClearImage <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>
20<CODE>#include &lt;nitro/gx/gx_load.h&gt;</CODE><BR>
21<CODE>void GX_BeginLoadClearImage(void);</CODE></PRE></dd>
22</dl><h2>Arguments</h2>
23<P>None.</P>
24<h2>Return Values</h2>
25<p>None.</p>
26<H2>Description</H2>
27<P>This function should be called before transferring the clear image to the clear image slot. Internally, it allocates to LCDC the banks that are allocated to the clear image slot and prepares to DMA transfer the clear images using the <CODE><A href="GX_LoadClearImageColor.html">GX_LoadClearImageColor</A></CODE> and <CODE><A href="GX_LoadClearImageDepth.html">GX_LoadClearImageDepth</A></CODE> functions.</P>
28<P><B>Note:</B> You must use the <CODE><A href="GX_SetBankForClearImage.html">GX_SetBankForClearImage</A></CODE> function to allocate the VRAM banks to the clear image slot in advance.</P>
29
30<h2>See Also</h2>
31<P><A href="GX_LoadClearImageColor.html"><code>GX_LoadClearImageColor</code></A>, <A href="GX_LoadClearImageDepth.html"><code>GX_LoadClearImageDepth</code></A>, <A href="GX_EndLoadClearImage.html"><code>GX_EndLoadClearImage</code></A></P>
32<H2>Revision History</H2>
33<P>2004/02/09</P>
34<UL>
35  <LI>Revised and expanded the description.
36</UL>
37<P>2004/01/19 Initial version.</P>
38<hr><p>CONFIDENTIAL</p></body>
39</html>
40