NAME

XSetFontPath − set the font search path. 

Synopsis

XSetFontPath(display, directories, ndirs)
Display *display;
char **directories;
int ndirs;

Arguments

displaySpecifies 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.

ndirsSpecifies 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 preventing 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 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 guaranteed 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(), XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFonts(), XListFontsWithInfo(), XLoadFont(), XLoadQueryFont(), XQueryFont(), XSetFont(), XUnloadFont(). 

Copyright O’Reilly & Assoc.  —