ufmGetTypefaceMetrics(3w)

NAME
     ufmGetTypefaceMetrics - get typeface metrics

C SYNOPSIS
     #include <ufm.h>

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

DESCRIPTION
     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
     ufmFreeTypefaceMetrics(3w), ufmOpenTypeface(3w).

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