PEXOCCSetSurfaceEdgeColorIndex - Set Surface Edge Color Index (5.0)

Synopsis 

 
   void PEXOCCSetSurfaceEdgeColorIndex(
        PEXOCC context,
        unsigned int index
   )
 


 
   void PEXSetSurfaceEdgeColorIndex(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        unsigned int index
   )

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

index
The color table index for surface edges.

Returns

None.

Description

Invoke PEXOCCSetSurfaceEdgeColorIndex to set the surface edge color entry to an indexed color in the renderer's pipeline state according to the value specified by index. The index selects an entry of the renderer's color table. You can alternately use PEXOCCSetSurfaceEdgeColor which allows you to specify a color of any type.

By setting the edge color index attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's surface edge color entry to determine the color of surface edge attributes. When you set the surface edge attribute's ASF to PEXBundled, the implementation uses the surface edge color from the edge bundle table.

If you specify an undefined color index, then the index defaults to color index one. If color index one is not defined, then color defaults to white. If you specify a color index which is greater than 65534, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the edge attribute set.

Errors

BadPEXOutputCommand
The type is PEXColorTypeIndexed and the color index value exceeds 65534.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of all output attribute functions, see Output Attribute Functions.