#include <revolution/gx.h> void GXEnableBreakPt( void* break_pt );
| break_pt | Breakpoint address. |
|---|
None.
This function sets the break point address for the FIFO currently attached to the graphics processor (GP) (see the GXSetGPFifo 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 GXDisableBreakPoint function.
You can implement a callback to be invoked when a break point is encountered with the GXSetBreakPtCallback function.
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.
For example, suppose you finish writing the graphics commands for one frame and are ready to start on the next. First, execute a GXFlush 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 GXGetFifoPtrs function. Write the value of the write pointer as the break point address, using the GXEnableBreakPt function. When the FIFO read pointer reaches the break point address the hardware will disable reads from the FIFO. The status brkpt returned by the GXGetGPStatus function can monitor the detection when the break point is reached. The application can then decide when to disable the break point, using the GXDisableBreakPt function, which will allow the FIFO to resume reading graphics commands.
GXDisableBreakPt, GXSetBreakPtCallback
2006/03/01 Initial version.
CONFIDENTIAL