.\" @(#)PEXSetLightSourceState.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetLightSourceState 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetLightSourceState - Set Light Source State
.SH SYNTAX
.HP
void PEXSetLightSourceState\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, unsigned int \fIenable_count\fP\^, PEXTableIndex *\fIenable\fP\^, unsigned int \fIdisable_count\fP\^, PEXTableIndex *\fIdisable\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIenable_count\fP 1i
The number of lights to enable.
.IP \fIenable\fP 1i
An array of lights to enable.
.IP \fIdisable_count\fP 1i
The number of lights to disable.
.IP \fIdisable\fP 1i
An array of lights to disable.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetLightSourceState
.LP
This function creates an output primitive attribute which
sets the light source state attribute.
Each element in the
.I enable
list activates the light represented by
the corresponding light table entry and each element in the
.I disable
list deactivates the light represented by the corresponding light
table entry.
.LP
A light listed in both the
.I enable
list and the
.I disable
list, or a light index of 0 will produce a
.SB BadPEXOutputCommand
error.
Otherwise, if any light in the
.I enable
or
.I disable
list references an undefined
light table entry, the light is ignored.
.SH DATA STRUCTURES
.LP
.nf
typedef  unsigned short	PEXTableIndex;
.fi
.sp .5
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateLookupTable (3)
.fi