void PEXOCCSetBFSurfaceColor( PEXOCC context, PEXColor *color )
void PEXSetBFSurfaceColor( Display *display, XID resource_id, PEXOCRequestType req_type, int color_type, PEXColor *color )
None.
Invoke PEXOCCSetBFSurfaceColor to create an attribute output command which sets the back-facing surface color attribute in the renderer's pipeline state according to the value specified by color.
By setting the back-facing surface color attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's back-facing surface color entry to select the color for back-facing surfaces. When you set the back-facing surface color attribute's ASF to PEXBundled, the implementation uses the back-facing surface color from the interior bundle table.
To apply the back-facing surface color to the back-facing surfaces of output primitives, you must set the facet distinguish flag to True (see PEXOCCSetFacetDistinguishFlag). If you set the flag to False, then the implementation uses the surface color when applying color to back-facing surfaces (see PEXOCCSetSurfaceColor).
Depending on the color type you specify, this function sets the attribute to either an indexed color or a direct color value. If you specify a color type of PEXColorTypeIndexed, but you specified an undefined index, then the index defaults to color index one. If color index one is not defined, then the back-facing surface color defaults to white. If you specified a color index greater than 65534, then the implementation issues a BadPEXOutputCommand error. If the color type is one of the supported direct color types and you specify an out of range component, then the result is implementation-dependent. If the color type is not supported, then indexed color one is used. Inquire the supported values for color type by invoking the PEXGetEnumTypeInfo function.
This function is a member of the styled and shaded surface attribute set.
For an overview and for a list of output attribute functions, see Output Attribute Functions.