ufmGetFontPath(3w)					    ufmGetFontPath(3w)

NAME    [Toc]    [Back]

     ufmGetFontPath - get the current UFM font path

C SYNOPSIS    [Toc]    [Back]

     #include <ufm.h>

     int ufmGetFontPath(char **fontPath)

DESCRIPTION    [Toc]    [Back]

     ufmGetFontPath gets the current Universal Font Manager (UFM) font path.

     ufmGetFontPath uses the argument fontPath to return a pointer to a	nullterminated
	character string that represents the current UFM font path.
     That path is used by UFM to find font files.  If an error is detected,
     ufmGetFontPath sets that pointer to NULL.

     The UFM font path contains	one or more 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.  UFM searches
     font directories in the order in which they are specified in the font
     path.

     There is a	default	UFM font path.	The default UFM	font path can be
     changed by	calling	the function ufmSetFontPath.  When your	program	is
     finished with the UFM font	path, it can call the function ufmFree with
     the pointer fontPath.  ufmFree will free the memory which was allocated
     for a copy	of the UFM font	path.

SEE ALSO    [Toc]    [Back]

     ufmFree(3w), ufmSetFontPath(3w).

DIAGNOSTICS    [Toc]    [Back]

     If	ufmGetFontPath is not able to allocate the memory it needs, it will
     return the	value UFM_OUT_OF_MEMORY.  Else,	it returns the value
     UFM_NO_ERROR.  UFM_OUT_OF_MEMORY and UFM_NO_ERROR are defined in the
     header file <ufm.h>.


									PPPPaaaaggggeeee 1111