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="Microsoft FrontPage 5.0"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<TITLE>GXAbortFrame</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">GXAbortFrame</H1> 12 13<H2>Syntax</H2> 14<dl><dd><pre class="construction"> 15#include <revolution/gx.h> 16 17void GXAbortFrame( void ); 18</pre></dd></dl> 19 20<H2>Arguments</H2> 21<P>None.</P> 22 23<H2>Return Values</H2> 24<P>None.</P> 25 26<H2>Description</H2> 27<P>This function will abort the current frame. When this command is called, it will reset the entire graphics pipeline, including any commands in the graphics FIFO that are not yet processed by the graphics processor. This command is intended to be used where an application should terminate current graphics task immediately and move to next process. For example, such case is considered to happen in games where the designers would rather drop some graphics than drop frames.</P> 28<P>This command resets all states in the graphics processor, so the application cannot count on retained state from frame to frame. Since it might also raise some inconsistencies with shadowed states in the GX library, it is recommended that you set up all graphics states again after calling the <code>GXAbortFrame</code> function.</P> 29<P> Texture memory will not be reset, so currently loaded textures will still be valid. However, when loading textures with the <a href="../Texture/GXPreLoadEntireTexture.html"><code>GXPreLoadEntireTexture</code></a> function or TLUTs with the <a href="../Texture/GXLoadTlut.html"><code>GXLoadTlut</code></a> function, make sure the command completed. (Use the render synchronization mechanism to achieve this. See the <a href="GXSetDrawSync.html"><code>GXSetDrawSync</code></a> and <a href="GXReadDrawSync.html"><code>GXReadDrawSync</code></a> functions.)) The <CODE>GXAbortFrame</CODE> function calls <A href="../Management/GXFlush.html"><CODE>GXFlush</CODE></A>. Therefore, there is no need to explicitly call <A href="../Management/GXFlush.html"><CODE>GXFlush</CODE></A> after resetting with <CODE>GXAbortFrame</CODE>.</P> 30 31<H2>See Also</H2> 32<P>None.</P> 33 34<H2>Revision History</H2> 35<P> 362008/05/12 Mentioned that <CODE>GXFlush</CODE> is included with calls to other functions.<br>2006/03/01 Initial version.<br> 37</P> 38 39<hr><p>CONFIDENTIAL</p></body> 40</HTML>