PEXOCCSetLineMiterLimit - Set Line Miter Limit (5.2)


Synopsis

 
   void PEXOCCSetLineMiterLimit(
        PEXOCC context,
        double miter_limit
   )
 

Arguments

context
An OC context returned by a successful PEXCreateOCCcall.

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

miter_limit
The desired miter limit.

Returns

None.

Description

Invoke PEXOCCSetLineMiterLimit to set the line miter limit entry of the renderer's pipeline state according to the value specified by miter_limit.

The line miter_limit determines the treatment of wide line segments joined by line join style PEXLineJoinMiter (see PEXOCCSetLineJoinStyle). If the ratio of the miter length (the distance between the inside and outside intersections of the two segments joined) to the line width exceeds the line miter limit, then the implementation interprets the line join style as PEXLineJoinBevel.

If you specify a miter limit that is less than 1.0, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the line attribute set.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

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.