DragonFly On-Line Manual Pages

Search: Section:  

EZ_DefineLight(3)               EZWGL Functions              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)

EZWGL                                                        EZ_DefineLight(3)

Search: Section: