XLoadFont

Syntax

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

Arguments

display Specifies the connection to the X server.
name Specifies the name of the font, which is a null-terminated string.

Description

The XLoadFont() function loads the specified font and returns its associated font ID. If the font name is not in the Host Portable Character Encoding, the result is implementation dependent. Use of uppercase or lowercase does not matter. When the characters ``?'' and ``*'' are used in a font name, a pattern match is performed and any matching font is used. In the pattern, the ``?'' character will match any single character, and the ``*'' character will match any number of characters. A structured format for font names is specified in the X Consortium standard X Logical Font Description Conventions. If XLoadFont() was unsuccessful at loading the specified font, a BadName error results. Fonts are not associated with a particular screen and can be stored as a component of any GC. When the font is no longer needed, call XUnloadFont().

XLoadFont() can generate BadAlloc and BadName errors.

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadName A font or color of the specified name does not exist.

See also

XCreateGC(), XFreeFont(), XGetFontProperty(), XListFonts(), XLoadQueryFont(), XQueryFont(), XSetFontPath(), XUnloadFont(), "Loading and Freeing Fonts".
Christophe Tronche, ch@tronche.com