PEXAnnotationText2D(3) — Subroutines

Name

PEXAnnotationText2D - 2D Annotation Text Primitive

Synopsis

void PEXAnnotationText2D(Display ∗display, XID resource_id, PEXOCRequestType req_type, PEXCoord2D ∗origin, PEXCoord2D ∗offset, int length, char ∗string)

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

originThe origin of the text string.

offsetThe relative position of the text string from the origin.

lengthThe number of bytes in the text string.

stringA pointer to the text string.

Returns

None

Description

This function creates a 2D annotation text output primitive.

This primitive functions like PEXAnnotationText except that the origin and offset positions are specified using only x- and y-components, and the z-component is always assumed to be zero. This primitive is two-dimensional only in that the z-component is implied, since geometry transformations are still carried out in three dimensions.

Data Structures

See the PEXStructuresman page.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

Museum