GXCallDisplayList

C Specification

#include <revolution/gx.h>

void GXCallDisplayList( const void* list, u32 nbytes );

Arguments

`list`	Pointer to the display list. Must be 32-byte aligned.
`nbytes`	Number of bytes in the display list. Must be a multiple of 32.

Return Values

None.

Description

This function will cause the Graphics Processor (GP) to execute graphics commands from the display list instead of from the GP FIFO. When the value of nbytes (a multiple of 32) has been read, the graphics processor will resume executing commands from the graphics FIFO.

Graphics commands from a display list are prefetched into a separate 4KB FIFO. This prevents any data prefetched for the main graphics command stream from being lost during the display list call.

Note: A display list cannot call another display list.

The display list must be padded to a length of 32 bytes. All the data in the display list is interpreted by the graphics processor, so any unused memory at the end of a display list should be set to GX_NOP(0x00). If you create the display list using GXBeginDisplayList/GXEndDisplayList, this padding will be done automatically.

Revision History