PEXPolyline2D - 2D Polyline Primitive (5.0)


Note: This function has been superseded by the PEXOCCPolyline function, but is maintained here for backwards compatibility with PEXlib 5.1.

Synopsis

 
     void PEXPolyline2D(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          unsigned int count,
          PEXCoord2D *points
     )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id
The resource identifier of the renderer or structure.

req_type
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

count
The number of vertices.

points
An array of vertices defining the polyline

Returns

None.

Description

Invoke PEXPolyline2D to create a two-dimensional polyline output primitive.

This primitive is similar to the PEXPolyline primitive, except that you need only to specify x- and y-components. The z-component is always assumed to be zero. This primitive is two-dimensional only in that the z-components are implied. PEXlib still carries out the geometry transformations in three dimensions.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview, see Output Command Functions.