void PEXOCCSetSurfaceColorIndex( PEXOCC context, unsigned int index )
void PEXSetSurfaceColorIndex( Display *display, XID resource_id, PEXOCRequestType req_type, unsigned int index )
None.
Invoke PEXOCCSetSurfaceColorIndex to set the surface
color entry to an indexed color in the renderer's pipeline
state according to the value specified by
By setting the surface color index attribute's ASF to
PEXIndividual
(see PEXOCCSetIndividualASF),
you use the pipeline state's surface color entry to
determine the color of surface attributes.
When you set the surface color attribute's ASF to
PEXBundled, the implementation uses the surface color
from the
interior bundle table.
If you do not set the
facet distinguish flag to True (see
PEXOCCSetFacetDistinguishFlag),
then the implementation
applies the surface color index to back-facing as well as
front-facing surface interiors.
Otherwise the implementation uses the back-facing surface
color index
(see PEXOCCSetBFSurfaceColorIndex)
If you specify an undefined color index, then the
index defaults to color index one.
If color index one is not defined, then the color defaults
to white.
If you specify a color index which is greater than
65534, then the implementation issues a
BadPEXOutputCommand error.
The surface color index function is a member of the
styled and shaded surface attribute
set.
For an overview and for a list of all output attribute functions,
see Output Attribute Functions.
Errors
See Also