EZ_DefineLight(3)

NAME
EZ_DefineLightSrc, EZ_BindLightSrc - define light source parameters

SYNOPSIS
#include <EZ.h>

EZ_LightSrc *EZ_DefineLightSrc(float *parameters)
void EZ_BindLightSrc(int num, EZ_LightSrc *lsrc)

ARGUMENTS

parameters Specifies light source properties.

num Specifies a light source, must be an integer between 0 and 7.

lsrc Specifies a pre-defined light source.

DESCRIPTION

EZ_DefineLightSrc defines a light source based on the specified parameters. The defined light source can later be binded to one of the 8 light sources.

parameters specifies an array of floating point symbols and values that defines the light source properties. parameters must contain a sequence of lighting symbols, each followed by the appropriate number of floating point values. The last symbol must be EZ_NULL_F, which is itself not followed by any values.

The symbols are:

EZ_POSITION_F specifies the position of the light source, must followed by 4 floating point numbers that defines the position of the light source.

EZ_AMBIENT_F specifies the ambient color of the light source, must followed by 4 floats in the range [0.0, 1.0] that specify the intensity of the RGBA components of the color.

EZ_DIFFUSE_F specifies the diffuse color of the light source, must followed by 4 floats in the range [0.0, 1.0] that specify the intensity of the RGBA components of the color.

EZ_SPECULAR_F specifies the specular color of the light source, must followed by 4 floats in the range [0.0, 1.0] that specify the intensity of the RGBA components of the color.

EZ_SPOT_DIRECTION_F specifies the spot direction of a spot light source, must followed by 4 floats that specify the spot direction.

EZ_SPOT_EXPONENT_F specifies the spot exponent, must followed by a non-negative floating point number that specifies the spot exponent.

EZ_SPOT_CUTOFF_F specifies the spot cutoff angle, must followed by an angle in degrees between 0.0 and 180.0.

EZ_CONSTANT_ATTENUATION_F specifies the constant attenuation coefficient, must followed by a floating point number that specifies the attenuation factor.

EZ_LINEAR_ATTENUATION_F specifies the linear attenuation coefficient, must followed by a floating point number that specifies the attenuation factor.

EZ_QUADRATIC_ATTENUATION_F specifies the quadratic attenuation coefficient, must followed by a floating point number that specifies the attenuation factor.

EZ_BindLightSrc binds the specified pre-defined light source property to the specified light source.

SEE ALSO
EZ_DefineMaterial(3), EZ_DefineLightModel(3), EZ_BindMaterial(3), EZ_BindLightModel(3)