.\" @(#)PEXAnnotationText2D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXAnnotationText2D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXAnnotationText2D \- 2D Annotation Text Primitive
.SH SYNTAX
.HP
void PEXAnnotationText2D\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^,
PEXOCRequestType \fIreq_type\fP\^, PEXCoord2D *\fIorigin\fP\^, PEXCoord2D *\fIoffset\fP\^, int \fIlength\fP\^, char *\fIstring\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIresource_id\fP
The resource identifier of the renderer or structure.
.TP
\fIreq_type\fP
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.TP
\fIorigin\fP
The origin of the text string.
.TP
\fIoffset\fP
The relative position of the text string from the origin.
.TP
\fIlength\fP
The number of bytes in the text string.
.TP
\fIstring\fP
A pointer to the text string.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXAnnotationText2D
.IX "Annotation Text" PEXAnnotationText2D
.LP
This function creates a 2D annotation text output primitive.
.LP
This primitive functions like
.BR PEXAnnotationText (3)
except that the
.I origin
and
.I 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.
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp .5
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetTextFontIndex (3)
.BR PEXSetTextPrecision (3)
.BR PEXSetCharExpansion (3)
.BR PEXSetCharSpacing (3)
.BR PEXSetTextColorIndex (3)
.BR PEXSetTextColor (3)
.BR PEXSetATextHeight (3)
.BR PEXSetATextUpVector (3)
.BR PEXSetATextPath (3)
.BR PEXSetATextAlignment (3)
.BR PEXSetATextStyle (3)
.BR PEXSetTextBundleIndex (3)
.fi