#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 GXSetGPFifo). 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 GXDisableBreakPoint.
You can install a callback to be invoked when the break point is encountered with the GXSetBreakPtCallback API.
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 GXGetFifoPtrs. Write the value of the write pointer as the break point address using GXEnableBreakPt. 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 GXDisableBreakPt, which will allow the FIFO to resume reading graphics commands.
GXDisableBreakPt
GXSetBreakPtCallback
03/01/2006 Initial version.