PEXPolylineSetWithData(3) — Subroutines

Name

PEXPolylineSetWithData - 3D Set of Polylines Primitive

Synopsis

void PEXPolylineSetWithData(Display ∗display, XID resource_id, PEXOCRequestType req_type, unsigned int vertex_attributes, int color_type, unsigned int count, PEXListOfVertex ∗vertex_lists)

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

vertex_attributes
A mask indicating the vertex attributes provided (PEXGANone or PEXGAColor).

color_typeThe type of color data provided (PEXColorTypeIndexed, PEXColorTypeRGB, PEXColorTypeCIE, PEXColorTypeHSV, PEXColorTypeHLS, PEXColorTypeRGB8, PEXColorTypeRGB16).

countThe number of polylines.

vertex_listsA pointer to a list of vertex arrays defining each polyline in the set.

Returns

None

Description

This function creates a polyline set output primitive.

This function is similar to PEXPolyline except that it allows applications to specify a number of polylines as well as additional data. These polylines may contain a color value at each vertex. The vertex attributes indicate the content of the additional data. Color values passed must be of the specified color type.

If colors are passed for each vertex, they are used instead of the line color attribute. The polyline interpolation method, which depending on the ASF attribute is obtained directly from the current polyline interpolation attribute or from the line bundle, controls how the polylines are shaded.

All other aspects of this primitive are the same as PEXPolyline.

Data Structures

See the PEXStructuresman page.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

Museum