.\" @(#)PEXLoadFont.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXLoadFont 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXLoadFont - Load PEX Font
.SH SYNTAX
.HP
PEXFont PEXLoadFont\^(\^Display *\fIdisplay\fP\^, char *\fIfont_name\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIfont_name\fP 1i
The font name (null-terminated string).
.SH RETURNS
.LP
The resource identifier of the loaded PEX font.
.SH DESCRIPTION
.\" indexing
.IX PEXLoadFont
.IX "Fonts" "PEXLoadFont"
.LP
This function loads the specified PEX font, if necessary.  The font
name should use the ISO Latin-1 encoding and case is not significant
in matching names.  PEX fonts are not associated with a particular
screen, and can be used with any renderer or PHIGS workstation resource.
An error will be generated if the specified font is not "PEX usable",
that is, it is not capable of supporting the full range of PEX text
attributes.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXFont;
.fi
.sp
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate the resource.
.TP
.SB BadPEXFont
The specified font name does not name a usable PEX font.
.SH SEE ALSO
.LP
.nf
.BR PEXUnloadFont (3)
.fi