PEXOCCSetSurfaceEdgeColor - Set Surface Edge Color (5.0)


Synopsis

 
   void PEXOCCSetSurfaceEdgeColor(
        PEXOCC context,
        PEXColor *color
   )
 

 
   void PEXSetSurfaceEdgeColor(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int color_type,
        PEXColor *color
   )
 

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).

color_type (OCC)
The type of color (PEXColorTypeIndexed, PEXColorTypeRGB, PEXColorTypeCIE, PEXColorTypeHSV, PEXColorTypeHLS, PEXColorTypeRGB8, PEXColorTypeRGB16, PEXColorTypeRGBA, PEXColorTypeRGBA8, or PEXColorTypeRGBA16).

color
A pointer to the surface edge color.

Returns

None.

Description

Invoke PEXOCCSetSurfaceEdgeColor to create an attribute output command which sets the surface edge color attribute in the renderer's pipeline state according to the value specified by color.

By setting the surface edge color attribute's ASF to PEXBundled (see PEXOCCSetIndividualASF), you can specify the color for rendering edges.

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 surface edge 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 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 output attribute functions, see Output Attribute Functions.