void PEXOCCSetLineJoinStyle(
PEXOCC context,
unsigned long join_style
)
- 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).
- join_style
- The desired join style (see Description).
None.
Invoke PEXOCCSetLineJoinStyle to create an output
primitive which sets the line join style attribute in the
renderer's pipeline state according to the value specified
by join_style.
By setting the line join style index attribute's ASF to
PEXIndividual
(see PEXOCCSetIndividualASF),
you use the pipeline state's join style entry to control the
rendering of the intersection between adjacent segments of a
wide line.
When you set the line join style attribute's ASF to
PEXBundled, the implementation uses the join style
from the
line bundle table.
PEXlib defines the following
line join styles (join_style):
- PEXLineJoinImpDep -
- joins the wide line segments in an implementation-dependent
way. (5.2)
- PEXLineJoinRound -
- joins two wide line segments by rendering a circular arc
with a diameter equal to the linewidth and with a
centerpoint that is the vertex between the two segments. (5.2)
- PEXLineJoinMiter -
- extends the outside edges of the wide line segments until
they meet at an angle.
However if the line miter limit (see
PEXOCCSetLineMiterLimit) is exceeded, style
PEXLineJoinMiter is rendered as style
PEXLineJoinBevel.
(5.2)
- PEXLineJoinBevel -
- joins the two wide line segments by applying cap style
PEXLineCapButt
(see PEXOCCSetLineCapStyle) to
each of them and rendering the triangular notch left between
them. (5.2)
If the implementation does not support the specified line
join style (join_style), then the join style defaults
to PEXLineJoinImpDep.
Inquire the supported values for line join style by
invoking the
PEXGetEnumTypeInfo function.
This function is a member of the
line attribute set.
- BadPEXRenderer
- The specified renderer resource identifier is invalid.
- BadPEXStructure
- The specified structure resource identifier is invalid.
For an overview and for a list of all output attribute functions,
see Output Attribute Functions.