ufmSetFontPath(3w)					    ufmSetFontPath(3w)

NAME    [Toc]    [Back]

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

C SYNOPSIS    [Toc]    [Back]

     #include <ufm.h>

     int ufmSetFontPath(char *fontPath)

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     ufmGetFontPath(3w)

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111