fmfontin(3W)

NAME
     fmgetfontinfo - return information about the overall font

SYNOPSIS
     #include <fmclient.h>

     long fmgetfontinfo(fh, info)
     fmfonthandle fh;
     fmfontinfo *info;

DESCRIPTION
     fmgetfontinfo writes information to the members of the fmfontinfo type
     structure pointed to by the info parameter.  The information written
     pertains to the whole fh font. If fmgetfontinfo cannot find the fh font,
     its returned function value is -1.  Otherwise the value of the function
     is 0.

     The members of fmfontinfo are declared to make it easy for FORTRAN
     programmers to access and interpret (hence the large number of long
     declarations).  For a listing of the entire fmfontinfo type structure,
     see <fmclient.h>. The members most likely to be of interest are:

     printermatched : tells whether there is a printer widths file
     corresponding to this font.

     matrix00-matrix11 : floats that provide information in points.

     fixed_width : tells whether all the characters in the font are the same
     width.

     xorig, yorig : the aggregate x-origin and y-origin of the font.  yorig is
     the positive distance between the baseline and the lowest descender.
     xorig is the distance (positive or negative) from the current point to
     the start of imaging of the glyph.

     xsize, ysize : the maximum sizes of the characters in the font, in
     pixels.

     height : often the same as ysize, but some fonts lie to get more leading.

     nglyphs : the index of the highest-numbered character.  It is not the
     total number of characters, but when allocating space for
     fmgetwholemetrics, use nglyphs as though it were the total number of
     characters.  In other words, this is the highest index of a possibly
     sparse matrix.

     The other members of the fmfontinfo type structure are self-explanatory.

SEE ALSO
     fminit(3W), fmfindfont(3W), fmscalefont(3W)
NOTE
     This routine is available only in immediate mode.