G3_BeginMakeDL

Syntax

#include <nitro/gx/g3.h>
void G3_BeginMakeDL(GXDLInfo* info, void* ptr, u32 length);

Arguments

info Pointer to GXDLInfo structure
ptr Pointer to buffer where display list is stored
length Size of buffer where display list is stored (in bytes)

Return Values

None.

Description

This function is called before creating the display list (command list) and sets up the GXDLInfo structure. Data from ptr is stored in order. The buffer must be 4-byte aligned. The display list is created by calling either a G3B_xxxxx (commands are not packed) or G3C_xxxxx (commands are packed) function.

When linked to the DEBUG version of the library, each display list creation function verifies whether the size of the display list exceeds the size specified by length. If the size is exceeded, a debug message is output. In both the RELEASE and FINALROM versions of the library, this verification is not performed and the length setting is ignored.

See Also

G3_EndMakeDL, MI_SendGXCommand

Revision History

2004/01/19 Initial version.


CONFIDENTIAL