.\" @(#)PEXSetCharHeight.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetCharHeight 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetCharHeight - Set Character Height
.SH SYNTAX
.HP
void PEXSetCharHeight\^(\^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 text character height.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetCharHeight
.LP
This function creates an output primitive attribute which
sets the character height value attribute.
If the specified
.I height
or the computed width is not supported, the height
or width is mapped to the nearest supported 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 fonts are
open.  For example, if the client opens all scalable and rotatable stroke
fonts, a continuous number of character sizes are supported.
The
.I height
is specified in the text local coordinate system.
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.