PEXPolyline(3) — Subroutines

Name

PEXPolyline - 3D Polyline Primitive

Synopsis

void PEXPolyline(Display ∗display, XID resource_id, PEXOCRequestType req_type, unsigned int count, PEXCoord ∗points)

Arguments

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

resource_idThe resource identifier of the renderer or structure.

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

countThe number of points.

pointsAn array of points defining the polyline.

Returns

None

Description

This function creates a polyline output primitive.

The points, specified in modeling coordinates, are joined together by line segments. The first point is joined to the second, the second to the third, and so on. The last point is not joined to the first.

The polyline colors are affected only by depth-cueing and are mapped to device colors. Polylines are not displayed if they are outside the currently defined clipping volume. Polylines crossing the clipping volume are clipped and only the portions inside the clipping volume are displayed.

Depending on the ASF attributes, the line color, line type, line width, and polyline interpolation method attributes are obtained either directly from the current attributes or from the line bundle.

A polyline with fewer than two points is considered degenerate. It is stored in a structure, but when rendered, the primitive is ignored and has no visual effect.

Data Structures

See the PEXStructuresman page.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

Museum