NAME

light_switch − enable/disable light sources

SYNOPSIS

C Syntax:

void light_switch(fildes,on);
int fildes,on;

FORTRAN77 Syntax:

subroutine light_switch(fildes,on)
integer*4 fildes,on

Pascal Syntax:

procedure light_switch(fildes,on:integer);

DESCRIPTION

Input Parameters

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

on Mask specifying which light sources are on (value range: 0 through 511). 

Discussion

light_switch allows the 8 point light sources and the ambient light source to be turned on and off independently. The bits in the on mask determine the state of each light source.  The least significant bit (bit 0) specifies the ambient light, while bits 1 through 8 determine the state of point light sources 1 through 8 respectively.  If a bit is set (1), the corresponding light source is ON. 

DEFAULTS

on = 1:ambient light source is on if shading active.

SEE ALSO

light_ambient(3G), light_source(3G), shade_mode(3G), surface_model, vertex_format,
Starbase Graphics Techniques.

Hewlett-Packard Company  —  May 11, 2021