XSetFontPath() XSetFontPath()
Name
XSetFontPath - set the font search path.
Synopsis
XSetFontPath(display, directories, ndirs)
Display *display;
char **directories;
int ndirs;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
directories
Specifies the directory path used to look for the font. Setting the path to the empty list restores the default path defined for
the X server.
ndirs Specifies the number of directories in the path.
Description
XSetFontPath() defines the directory search path for font lookup for all clients. Therefore the user should construct a new directory
search path carefully by adding to the old directory search path obtained by XGetFontPath(). Passing an invalid path can result in pre-
venting the server from accessing any fonts. Also avoid restoring the default path, since some other client may have changed the path on
purpose.
The interpretation of the strings is operating-system-dependent, but they are intended to specify directories to be searched in the order
listed. Also, the contents of these strings are operating system specific and are not intended to be used by client applications.
An X server is permitted to cache font information internally, for example, it might cache an entire font from a file and not check on sub-
sequent opens of that font to see if the underlying font file has changed. However, when the font path is changed the X server is guaran-
teed to flush all cached information about fonts for which there currently are no explicit resource IDs allocated.
The meaning of errors from this request is implementation-dependent.
Errors
BadValue
See Also
XCreateFontCursor(), XFreeFont(), XFreeFontInfo(), XFreeFontNames(), XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFonts(),
XListFontsWithInfo(), XLoadFont(), XLoadQueryFont(), XQueryFont(), XSetFont(), XUnloadFont().
Xlib - Fonts XSetFontPath()