GXCallDisplayList

Syntax

#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 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 a display list using the GXBeginDisplayList / GXEndDisplayList functions, these functions automatically perform padding.

See Also

GXBeginDisplayList, GXEndDisplayList

Revision History

2006/03/01 Initial version.


CONFIDENTIAL