XSetFontPath(3X)                                 XSetFontPath(3X)



NAME
     XSetFontPath, XGetFontPath, XFreeFontPath -  set,  get,  and
     free the font search path

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

     char **XGetFontPath (display, npaths-return)
     Display *display;
     int *npaths-return;

     XFreeFontPath (list)
     char **list;

DESCRIPTION
     The XSetFontPath function defines the font directory search
     path.  There is only one search path per X server, not one
     per client.  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-dependent and
     are not intended to be used by client applications.  Usual-
     ly, the X server is free to cache font information internal-
     ly rather than having to read fonts from files.  In addi-
     tion, the X server is guaranteed to flush all cached infor-
     mation about fonts for which there currently are no explicit
     resource IDs allocated.  The meaning of an error from this
     request is operating-system-dependent.

     The XGetFontPath function allocates and returns an array of
     strings containing the search path.  The data in the font
     path should be freed when no longer needed.

     The XFreeFontPath function, when presented the data from
     XGetFontPath, frees the data used by the array.

   Arguments
     These functions accept the following arguments:

     directories
             Specifies the directory path followed to look for a
             font.  Setting the path to the empty list restores
             the default path defined for the X server.

     display Specifies the connection to the X server.

     list    Specifies the array of strings to be freed.

     ndirs   Specifies the number of directories in the path.



November, 1990                                                  1

XSetFontPath(3X)                                 XSetFontPath(3X)



     npaths-return
             Returns the number of strings in the font path ar-
             ray.

ERRORS
     BadValue
             A numeric value falls outside the range of values
             accepted by the request.  Unless a range is speci-
             fied for an argument, the full range defined by the
             argument's type is accepted.  Any argument defined
             as a set of alternatives can generate this error.

     The XSetFontPath function can generate a BadValue error.

SEE ALSO
     XListFonts(3X), XLoadFont(3X)

     Xlib - C Language Interface






































2                                                  November, 1990