# G3_BeginMakeDL

## C Specification

      #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

01/19/2004 Initial version