N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

gSPSetLights

Format
#include "gbi.h"

typedef struct {
   Ambient a;
   Light     l[M];
} LightsM;

gSPSetLightsM(Gfx *gdl,
   LightsM lites)
gsSPSetLightsM(LightsM lites)
Arguments
  • gdl is the pointer to the graphics display list
  • lites is the LightsM structure to load into the RSP
What This Macro Does
It loads light structures for ambient and diffuse lights into the light buffer. The last character in the macro, indicated by M above, represents the number of diffuse lights in the scene. In the macro and in the LightsM structure, M must be an actual integer in the range of 0 to 7. For example, with three diffuse lights, the macro is gSPSetLights3 and the corresponding structure is Lights3.

Once the lights are activated, they remain on until the next call to gSPSetLightsM. Whenever a new structure of lights is activated, the old structure of lights is overwritten.

In the LightsM structure, Ambient a is the ambient light structure, and Light l[M] is an array of M diffuse light structures. The LightsM structure can be set up by calling gdSPDefLights with the parameters defining the lights as inputs. The individual light structures combine the color of the light with the color of the material.

Note
To change the color of some or all of the lights after the light has been used one or more times, you should use the more efficient gSPLight macro instead of the less efficient gSPSetLightsM macro. See gSPLight for more information about this.

See Also
gdSPDefLights
gSPLight
gSPLightColor



Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.


Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998