XSetFontPath()XSetFontPath()NameXSetFontPath – 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. Set‐
ting the path to the empty list restores the default path
defined for the X server.
ndirs Specifies the number of directories in the path.
DescriptionXSetFontPath() 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 pur‐
pose.
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 spe‐
cific 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
subsequent opens of that font to see if the underlying font file has
changed. However, when the font path is changed the X server is guar‐
anteed to flush all cached information about fonts for which there cur‐
rently are no explicit resource IDs allocated.
The meaning of errors from this request is implementation-dependent.
Errors
BadValue
See AlsoXCreateFontCursor(), XFreeFont(), XFreeFontInfo(), XFreeFontNames(),
XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFonts(),
XListFontsWithInfo(), XLoadFont(), XLoadQueryFont(), XQueryFont(),
XSetFont(), XUnloadFont().
Xlib - Fonts XSetFontPath()