.\" @(#)PEXSetTextPrecision.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetTextPrecision 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetTextPrecision - Set Text Precision
.SH SYNTAX
.HP
PEXSetTextPrecision\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^,
PEXOCRequestType \fIreq_type\fP\^, int \fIprecision\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 \fIprecision\fP 1i
The text precision (
.B PEXStringPrecision,
.B PEXCharPrecision,
.B PEXStrokePrecision
).
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetTextPrecision
.LP
This function creates an output primitive attribute which
sets the text
.I precision
attribute.
.LP
When text or annotation text is interpreted, the fragments in the text
string are rendered in the same text
.I precision.
If the font group selected
by the current text font index consists of both X and PEX fonts, and if some
of the string fragments in the string are rendered in X fonts, the text
.I precision
of the entire string must be dropped to at least
.B PEXCharPrecision.
.LP
If a character set value is not available in the current font group, then the
entire string is rendered using the default font group.  If a character set
value is not available in the default font group, then that portion of the
string is rendered in an implementation-dependent manner.
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.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 PEXSetIndividualASF (3)
.fi