draw_light_define_direction

This function is for defining a directional light, where the direction and intensity are set by the values input for the x, y and z unit vector (meaning that they must be between -1 and 1, where 1 or -1 is full intensity, and 0 is no intensity). The lights can also be given a colour, which will also affect the perceived intensity of the light as certain colours appear "darker" than others. You must also give the light an index number which what will be used in other functions to reference it.

NOTE: There are only 8 hardware lights available, so only 8 defined lights can be enabled at any one time (although more can be defined).

 

Syntax:

draw_light_define_direction(ind, x, y, z, col);

ArgumentTypeDescription
indRealThe index number of the light (arbitrary)
xRealThe x component of the light vector
yRealThe y component of the light vector
zRealThe z component of the light vector
colColourThe colour to use for the light (either a constant, a real or a hex value).

 

Returns:

N/A

 

Example:

draw_set_lighting(true);
draw_light_define_direction(1, 0, 1, 0, c_white);
draw_light_enable(1, true);

The above code will enable lighting for the whole scene, then define a white directional light in the room space, and then finally turn that light on.