draw_light_define_point

This function is for defining a positional light, where you can define the x, y and z position of the light, the light range and its 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_point(ind, x, y, z, range, col);

ArgumentTypeDescription
indRealThe index number of the light (arbitrary)
xRealThe x position of the light
yRealThe y position of the light
zRealThe z position of the light
rangeRealThe light range (in pixels)
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_point(1, 200, 123, 50, 2000, c_white);
draw_light_enable(1, true);

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