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="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>GXEnableBreakPt</title> 10</head> 11 12<body> 13 14<h1 align="left">GXEnableBreakPt</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/gx.h> 19 20void GXEnableBreakPt( void* break_pt ); 21</pre></dd></dl> 22 23<h2>Arguments</h2> 24<TABLE class="arguments" border="1" > 25 <tr> 26<TH>break_pt</TH> 27<TD>Breakpoint address.</TD> 28 </tr> 29</TABLE> 30 31<h2>Return Values</h2> 32<P>None.</P> 33 34<H2>Description</H2> 35<P>This function sets the break point address for the FIFO currently attached to the graphics processor (GP) (see the <A href="GXSetGPFifo.html"><CODE>GXSetGPFifo</CODE></A> function). FIFO reads will stall when the GP FIFO read pointer is equal to the break point address. To re-enable reads of the GP FIFO, use the <A href="GXDisableBreakPt.html"><CODE>GXDisableBreakPoint</CODE></A> function.</P> 36<P>You can implement a callback to be invoked when a break point is encountered with the <A href="GXSetBreakPtCallback.html"><CODE>GXSetBreakPtCallback</CODE></A> function.</P> 37<P>The break point feature allows the application to have two frames of graphics in the FIFO at the same time, overlapping one frame's processing by the graphics processor with another frame's processing by the CPU. </P> 38<P>For example, suppose you finish writing the graphics commands for one frame and are ready to start on the next. First, execute a <A href="../Management/GXFlush.html"><CODE>GXFlush</CODE></A> command to make sure all the data in the CPU write gatherer is flushed into the FIFO. This will also align the FIFO write pointer to a 32-byte boundary. Next, read the value of the current write pointer using the <A href="GXGetFifoPtrs.html"><CODE>GXGetFifoPtrs</CODE></A> function. Write the value of the write pointer as the break point address, using the <A href="GXEnableBreakPt.html"><CODE>GXEnableBreakPt</CODE></A> function. When the FIFO read pointer reaches the break point address the hardware will disable reads from the FIFO. The status <SPAN class="argument">brkpt</SPAN> returned by the <a href="GXGetGPStatus.html"><code>GXGetGPStatus</code></a> function can monitor the detection when the break point is reached. The application can then decide when to disable the break point, using the <A href="GXDisableBreakPt.html"><CODE>GXDisableBreakPt</CODE></A> function, which will allow the FIFO to resume reading graphics commands.</P> 39 40<h2>See Also</h2> 41<P class="reference"> 42<A href="GXDisableBreakPt.html">GXDisableBreakPt</A>, 43<A href="GXSetBreakPtCallback.html">GXSetBreakPtCallback</A> 44</P> 45 46<H2>Revision History</H2> 47<P> 482006/03/01 Initial version.<br> 49</P> 50 51<hr><p>CONFIDENTIAL</p></body> 52</HTML>