PEXMarkers(3) — Subroutines

Name

PEXMarkers - 3D Markers Primitive

Synopsis

void PEXMarkers(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 specifying marker locations.

Returns

None

Description

This function creates a markers output primitive.

A marker is a geometric primitive with a position as its only geometric attribute. The position is specified in modeling coordinates.

Rendering transforms the marker’s position to a position in device coordinates. A marker has no geometric size, so geometric transformations do not affect the displayed size of the marker. The marker’s color is affected only by depth-cueing and mapped to a device color. The clipping of markers whose position is inside the clipping volume but whose rendering is outside the clipping volume is implementation-dependent.

Depending on the setting of the marker ASF attributes, the marker color, marker type, and marker scale attributes are obtained either directly from the current marker attributes or from the marker bundle.

Data Structures

See the PEXStructuresman page.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

Museum