PEXOCCSetSurfaceEdgeType - Set Surface Edge Type (5.0)


Synopsis

 
   void PEXOCCSetSurfaceEdgeType(
        PEXOCC context,
        int edge_type
   )
 

 
   void PEXSetSurfaceEdgeType(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int edge_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).

edge_type
The surface edge type (PEXSurfaceEdgeSolid, PEXSurfaceEdgeDashed, PEXSurfaceEdgeDotted or PEXSurfaceEdgeDashDot).

Returns

None.

Description

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

By setting the surface edge type attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's surface edge type entry to describe the style used when rendering the edges of surface primitives. When you set the surface edge type attribute's ASF to PEXBundled, the implementation uses the surface edge type from the edge bundle table.

PEXlib defines the following edge types (edge_type):

PEXSurfaceEdgeSolid -
draws the surface edge with a solid, unbroken line. (5.0)

PEXSurfaceEdgeDashed -
draws the surface edge with a line that is broken into even segments. (5.0)

PEXSurfaceEdgeDotted -
draws the surface edge with a line that is broken into dots. (5.0)

PEXSurfaceEdgeDashDot -
draws the surface edge with a line that contains alternating dotted and dashed line segments. (5.0)

Whether edge types, except PEXSurfaceEdgeSolid, are restarted or continued at the start of the edge, at the start of a clipped segment of an edge, or at each vertex of a surface edge is implementation-dependent.

If the implementation does not support the specified edge type (edge_type), then the edge type defaults to PEXSurfaceEdgeSolid. Inquire the supported values for the surface edge type by invoking the PEXGetEnumTypeInfo function.

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