ufmGetTypefaceInfo(3w)					ufmGetTypefaceInfo(3w)

NAME    [Toc]    [Back]

     ufmGetTypefaceInfo	- get typeface information

C SYNOPSIS    [Toc]    [Back]

     #include <ufm.h>

     int ufmGetTypefaceInfo(unsigned int typefaceHandle,
	  ufmTypeface **typeface)

DESCRIPTION    [Toc]    [Back]

     ufmGetTypefaceInfo	gets the information for a specified typeface or font
     family, such as Helvetica.

     typefaceHandle specifies the handle for an	open typeface.	Use the
     function ufmOpenTypeface to open a	typeface, and get a handle for that
     typeface.

     ufmGetTypefaceInfo	uses the argument typeface to return a pointer to a
     data structure of the type	ufmTypeface that it has	allocated.  If
     ufmGetTypefaceInfo	does not find a	specified typeface, it returns NULL.

     When your program is finished with	the data structure typeface, it	can
     call the function ufmFreeTypefaceInfo to free the memory allocated	for
     that data structure by ufmGetTypefaceInfo.

SEE ALSO    [Toc]    [Back]

     ufmFreeTypefaceInfo(3w), ufmOpenTypeface(3w).

DIAGNOSTICS    [Toc]    [Back]

     If	ufmGetTypefaceInfo is not able to allocate the memory it needs,	it
     will return the value UFM_OUT_OF_MEMORY.  If it does not find the
     specified typeface, it will return	the value UFM_INVALID_VALUE.
     UFM_OUT_OF_MEMORY and UFM_INVALID_VALUE are defined in the	header file
     <ufm.h>.


									PPPPaaaaggggeeee 1111