PEXOCCSetLineType - Set Line Type (5.0)

Synopsis 

 
   void PEXOCCSetLineType(
        PEXOCC context,
        int line_type
   )
 


 
   void PEXSetLineType(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type
        int line_type
   )

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

line_type
The line type (PEXLineTypeSolid, PEXLineTypeDashed, PEXLineTypeDotted, PEXLineTypeDashDot, PEXLineTypeCenterLine or PEXLineTypePhantom).

Returns

None.

Description

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

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

PEXlib defines the following line types (line_type):

PEXLineTypeSolid -
draws the polyline or curve with a solid, unbroken line. (5.0)

PEXLineTypeDashed -
draws the polyline or curve with a line that is broken into even segments. (5.0)

PEXLineTypeDotted -
draws the polyline or curve with a line that is broken into dots. (5.0)

PEXLineTypeDashDot -
draws the polyline or curve with a line that contains alternating dotted and dashed line segments. (5.0)

PEXLineTypeCenterLine -
draws the polyline or curve with a line that contains alternating short line segments (dashes) and long dashes. (5.2)

PEXLineTypePhantom -
draws the polyline or curve with a line that contains a sequence of a long line segment (dash) followed by two short dashes. (5.2)

Whether line types, except PEXLineTypeSolid, are restarted or continued at the start of the polyline, at the start of a clipped segment of a polyline, or at each vertex of a polyline is implementation-dependent.

If the implementation does not support the specified line type (line_type), then the line type defaults to PEXLineTypeSolid. Inquire the supported values for the line type by invoking the PEXGetEnumTypeInfo function.

The line type function 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 all output attribute functions, see Output Attribute Functions.