ufmGetTypefaceMetrics(3w)			     ufmGetTypefaceMetrics(3w)

NAME    [Toc]    [Back]

     ufmGetTypefaceMetrics - get typeface metrics

C SYNOPSIS    [Toc]    [Back]

     #include <ufm.h>

     int ufmGetTypefaceMetrics(unsigned	int typefaceHandle,
	  ufmTypefaceMetrics **typefaceMetrics)

DESCRIPTION    [Toc]    [Back]

     ufmGetTypefaceMetrics gets	scalable metrics for a specified typeface from
     a font metric file.  You can get scalable metrics for only	those
     typefaces that have the flag scalableMetrics set to 1 in their typeface
     data structures, that is, for only	those typefaces	for which metric files
     were found.

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

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

     When your program is finished with	the data structure typefaceMetrics, it
     can call the function ufmFreeTypefaceMetrics to free the memory allocated
     for that data structure by	ufmGetTypefaceMetrics.

SEE ALSO    [Toc]    [Back]

     ufmFreeTypefaceMetrics(3w), ufmOpenTypeface(3w).

DIAGNOSTICS    [Toc]    [Back]

     If	ufmGetTypefaceMetrics 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.  Else, it
     will return the value UFM_NO_ERROR.  UFM_OUT_OF_MEMORY, UFM_INVALID_VALUE
     and UFM_NO_ERROR are defined in the header	file <ufm.h>.


									PPPPaaaaggggeeee 1111