PEXOCCSetLineWidth - Set Line Width (5.0)

Synopsis 

 
   void PEXOCCSetLineWidth(
        PEXOCC context,
        double width
   )
 

 
   void PEXSetLineWidth(
        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 line width scale factor.

Returns

None.

Description

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

By setting the line width attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's line width entry to set the width size used when rendering lines. When you set the line width attribute's ASF to PEXBundled, the implementation uses the line width from the line bundle table.

Use width as a scale factor to increase or decrease the width (in pixels) from the nominal line width for the display device. PEXlib maps the results to the nearest supported line width. Specifying a negative line width results in the thinnest line supported.

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

The line width is a member of the line 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.