.\" @(#)PEXSetATextHeight.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetATextHeight 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetATextHeight - Set Annotation Text Height
.SH SYNTAX
.HP
void PEXSetATextHeight\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, double \fIheight\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 \fIheight\fP 1i
The annotation text character height.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetATextHeight
.IX "Annotation Text" PEXSetATextHeight
.LP
This function creates an output primitive attribute which
sets the annotation text
.I height
attribute.
If the specified
.I height
or the
computed width is not supported, the height or width is mapped to the nearest
supported annotation character height or width.
These values depend on the
font files that are in the font groups in the selected font table entry, which
in turn depend on which X or PEX font files have been opened.
If all scalable and rotatable stroke fonts are open, then a continuous range of
character sizes are supported.
The height is expressed in normalized projection coordinates.
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.