.\" @(#)PEXText2D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXText2D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXText2D - 2D Text Primitive
.SH SYNTAX
.HP
void PEXText2D\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, PEXCoord2D *\fIorigin\fP\^, int \fIlength\fP\^, char *\fIstring\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIorigin\fP 1i
The origin of the text string.
.IP \fIlength\fP 1i
The number of bytes in the text string.
.IP \fIstring\fP 1i
A pointer to the text string.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXText2D
.LP
This function creates a 2D text output primitive.
.LP
This function is like
.BR PEXText (3) ,
except that the
.I origin
position consists of only x- and y-components.  The
z-component is assumed to be zero.  This primitive is two-dimensional
only in that the z-component is implied.  Geometry
transformations are still carried out in three dimensions.
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp
.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 PEXSetCharHeight (3)
.BR PEXSetCharUpVector (3)
.BR PEXSetTextPath (3)
.BR PEXSetTextAlignment (3)
.BR PEXSetTextBundleIndex (3)
.fi