ufmSetFontPath(3w)

NAME
     ufmSetFontPath - set the Universal Font Manager (UFM) font path

C SYNOPSIS
     #include <ufm.h>

     int ufmSetFontPath(char *fontPath)

DESCRIPTION
     ufmSetFontPath specifies a new value for the Universal Font Manager (UFM)
     font path in the form of a null-terminated string of characters.  If you
     specify a character string of length zero or a null pointer,
     ufmSetFontPath will set the UFM font path to its default value.

     Specify either a null-terminated string of characters or a null pointer
     for the argument fontPath.  You must specify full-path names of font
     directories.  On platforms with the X Window System, each specified
     directory must exist, and it must contain a fonts.dir file (a directory
     of font files).  If there is more than one full-path directory name, put
     a comma (,) after each directory name, except the last one.

     There is a default UFM font path.  You can change the UFM default font
     path value by using the environment variable UFM_FONTPATH.  That will
     change the starting value of the UFM font path.  If your program then
     calls the function ufmSetFontPath, the UFM font path will be changed to
     the value specified in that function call.

     You can use the function ufmGetFontPath to get the current value of the
     UFM font path.

SEE ALSO
     ufmGetFontPath(3w)

DIAGNOSTICS
     If you specify an invalid font directory name, or the name of a font
     directory that does not contain a fonts.dir file, the function
     ufmSetFontPath will return the value UFM_INVALID_VALUE, and it will not
     change the UFM font path.  The function ufmSetFontPath will return the
     value UFM_OUT_OF_MEMORY if it is not able to allocate the memory it
     needs.  Else, it will return the value UFM_NO_ERROR.  UFM_INVALID_VALUE,
     UFM_OUT_OF_MEMORY, and UFM_NO_ERROR are defined in the header file
     <ufm.h>.