LIGHT_MODEL(3G)

NAME

light_model − modify aspects of POSITIONAL light sources

SYNOPSIS

C Syntax:

void light_model(fildes,index,attr,spot,atten,ang,x,y,z);
int fildes,index,attr,spot;
float atten,ang,x,y,z;

FORTRAN77 Syntax:

subroutine light_model(fildes,index,attr,spot,atten,ang,x,y,z)
integer*4 fildes,index,attr,spot
real atten,ang,x,y,z

Pascal Syntax:

procedure light_model(fildes,index,attr,spot:integer;
atten,ang,x,y,z:real);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

index Number of the POSITIONAL light source to be modified.

attr Sets the attributes of the POSITIONAL light source. Can be any of ATTEN_LIGHT, SPOT_LIGHT, or CONE_LIGHT ORed together.

spot Specifies the spotlight power of the POSITIONAL light source in the range 1 to 16383 if SPOT_LIGHT is set in attr.

atten Specifies the attenuation factor if ATTEN_LIGHT is set in attr. Must be greater than 0.0.

ang Specifies the angle of the cone in degrees, where the light is cut off if CONE_LIGHT is set in attr.

x,y,z Specifies the direction the POSITIONAL light source is pointing. Note that this vector does not need to be normalized to unit length.

Discussion

Light_model modifies certain aspects of POSITIONAL light sources as defined by light_source. If the ATTEN_LIGHT bit is set, the POSITIONAL light source intensity falls off as $ atten over R $ where R is the distance from the light source to the vertex. Note that atten can be any positive floating point value, including values greater than 1.0. Vertices at a distance of atten from the light source or closer are fully illuminated while more distant vertices are more dimly illuminated, according to the factor given above.

When the SPOT_LIGHT bit is set, the intensity of the light falls off as the $ (cos(A)) sup {spot} $ where A is the angle between the direction the light source is pointing and the vector from the vertex to the light source. The spot parameter specifies how focused the spot light is: the higher the number, the more focused the light.

The CONE_LIGHT function is comparable to placing an opaque circular lamp shade around the light source. The light abruptly stops when the angle between the direction the light source is pointing and the vector from the vertex to the light source is greater than ang.

Any of these functions can be defined separately or combined together to form a realistic light source.

DEFAULTS

Simple light source as specified by light_source with no modifications.

Museum

Related Articles