.\" @(#)PEXQueryFont.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXQueryFont 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXQueryFont - Query PEX Font Information
.SH SYNTAX
.HP
PEXFontInfo *PEXQueryFont\^(\^Display *\fIdisplay\fP\^, PEXFont \fIfont\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIfont\fP 1i
The resource identifier of the font.
.SH RETURNS
.LP
A pointer to the font info structure; a null pointer if unsuccessful.
.SH DESCRIPTION
.\" indexing
.IX PEXQueryFont
.IX "Fonts" "PEXQueryFont"
.LP
This function returns information about the specified PEX font.
The information returned is identical to what
.BR PEXListFontsWithInfo (3)
would return.
.LP
PEXlib allocates memory for the returned list of font information.
.BR PEXFreeFontInfo (3)
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXFont;
.sp
typedef struct {
	unsigned long		first_glyph;
	unsigned long		last_glyph;
	unsigned long		default_glyph;
	Bool			all_exist;
	Bool			stroke;
	unsigned short		count;		/* number of properties */
	PEXFontProp		*props;
.br
} PEXFontInfo;
.sp
typedef struct {
	Atom			name;
	unsigned long		value;
.br
} PEXFontProp;
.fi
.SH ERRORS
.TP
.SB BadPEXFont
The specified font resource identifier is invalid.