Name

PEXSetLightSourceState - Set Light Source State

Synopsis

void PEXSetLightSourceState(Display ∗display, XID resource_id, PEXOCRequestType req_type, unsigned int enable_count, PEXTableIndex ∗enable, unsigned int disable_count, PEXTableIndex ∗disable)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

resource_idThe resource identifier of the renderer or structure. 

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

enable_countThe number of lights to enable. 

enableAn array of lights to enable. 

disable_count
The number of lights to disable.

disableAn array of lights to disable. 

Returns

None

Description

This function creates an output primitive attribute which sets the light source state attribute.  Each element in the enable list activates the light represented by the corresponding light table entry and each element in the disable list deactivates the light represented by the corresponding light table entry. 

A light listed in both the enable list and the disable list, or a light index of 0 will produce a BadPEXOutputCommand error. Otherwise, if any light in the enable or disable list references an undefined light table entry, the light is ignored.

Data Structures

typedef unsigned short  PEXTableIndex;

Errors

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXCreateLookupTable