NAME

XLoadFont — load a font if not already loaded; get font ID. 

SYNOPSIS

Font XLoadFont(display, name) Display ∗display; char ∗name;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

nameSpecifies the name of the font in a null-terminated string.  As of Release 4, the ∗ and ? wildcards are allowed and may be supported by the server.  Upper or lower case is not important.  If the font name is not in the Host Portable Character Encoding, the result is implementation-dependent. 

RETURNS

The Font ID. 

DESCRIPTION

XLoadFont() loads a font into the server if it has not already been loaded by another client.  XLoadFont() returns the font ID or, if it was unsuccessful, generates a BadName error.  When the font is no longer needed, the client should call XUnloadFont().  Fonts are not associated with a particular screen.  Once the font ID is available, it can be set in the font member of any GC, and thereby used in subsequent drawing requests. 

Font information is usually necessary for locating the text.  Call XLoadFontWithInfo() to get the info at the time you load the font, or call XQueryFont() if you used XLoadFont() to load the font. 

For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 

ERRORS

BadAllocServer has insufficient memory to store font. 

BadNamename specifies an unavailable font. 

SEE ALSO

XCreateFontCursor(), XFreeFont(), XFreeFontInfo(), XFreeFontNames(), XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFonts(), XListFontsWithInfo(), XLoadQueryFont(), XQueryFont(), XSetFont(), XSetFontPath(), XUnloadFont(). 

Xlib Reference Manual