GXLoadLightObjIndx

Syntax

#include <revolution/gx.h>

void GXLoadLightObjIndx(
    u32         lt_obj_indx,
    GXLightID   light );

Arguments

lt_obj_indx	Index of a light object.
light	Light ID. Accepted values are: `GX_LIGHT0`, `GX_LIGHT1`, `GX_LIGHT2`, ... , `GX_LIGHT7`.

Return Values

None.

Description

This function instructs the graphics processor to fetch the light object at lt_obj_indx from the array specified below.

GXSetArray(GX_LIGHT_ARRAY, ...);

Then it loads the object into the hardware register associated with the light ID.

Note: The data flows directly from the array in DRAM to the graphics processor; therefore, the light object data may not be coherent with the CPU cache. Use caution. The application is responsible for storing the light object data from the CPU cache (using the DCStoreRange function) before calling the GXLoadLightObjIndx function.

Revision History

2006/08/10 Corrected mistake with enum type.
2006/03/01 Initial version.