PEXOCCSetSurfaceEdgeWidth - Set Surface Edge Width (5.0)


Synopsis

 
   void PEXOCCSetSurfaceEdgeWidth(
        PEXOCC context,
        double width
   )
 

 
   void PEXSetSurfaceEdgeWidth(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        double width
   )
 

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

width
The surface edge width scale factor.

Returns

None.

Description

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

By setting the surface edge width attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's surface edge width entry to define the surface edge width factor. When you set the surface edge width attribute's ASF to PEXBundled, the implementation uses the surface edge width from the edge bundle table. When you render a surface primitive, the nominal edge width is multiplied by the surface edge width factor. Use this scale factor to increase or decrease the width (in pixels) from the nominal edge width for the display device. PEXlib maps the result to the nearest supported edge width. A negative surface edge width factor results in the thinnest available edge.

Inquire the nominal edge width, the minimum edge width, the maximum edge width, and the number of supported edge widths supported by invoking the PEXGetImpDepConstants request.

This function is a member of the edge attribute set.

Errors

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.