.\" @(#)PEXSetCharExpansion.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetCharExpansion 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetCharExpansion - Set Character Expansion Factor
.SH SYNTAX
.HP
void PEXSetCharExpansion\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^,
PEXOCRequestType \fIreq_type\fP\^, double \fIexpansion\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 \fIexpansion\fP 1i
The character expansion factor.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetCharExpansion
.LP
This function creates an output primitive attribute which
sets the character expansion factor attribute.
Only the magnitude of the specified
.I expansion
is considered.
The specified character expansion factor is compared to the minimum and
maximum character
expansion factors.  These values depend on the font files that are in the
font groups in the selected font table entry, which in turn depend on the font
files opened.
For example, if all scalable and rotatable stroke fonts are open, then a
continuous number of expansions are supported.
If the expansion is smaller than the minimum character expansion factor, the
minimum value is used.
If the expansion is larger than the maximum character expansion factor, the
maximum value is used.
.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 PEXSetIndividualASF (3)
.fi