GDInitGDLObj

C Specification

#include <revolution/gd.h>

void GDInitGDLObj(
GDLObj* dl,
void*   start,
u32     length );

Arguments

`dl`	Pointer to a graphics display list object.
`start`	Pointer to a memory buffer that will contain the actual display list commands. Must have 32-byte alignment.
`length`	Length of the memory buffer in bytes. Must be a multiple of 32.

Return Values

None.

Description

This function initializes a GDLObj--an object that manages display lists. Nearly all GD library functions operate based on GDLObj (usually current GDLObj.) Specify a pointer to GDLObj you want to initialize in the dl argument. A memory buffer that GDLObj uses must be allocated in advance (for storing the actual display list). This memory buffer must have a 32-byte alignment. The arguments start and length are used to define this buffer. This function does not affect the buffer itself.

The top in the GDLObj is initialized to (start + length). The ptr in the GDLObj is initialized to (start).

Revision History