fmwhole(3W)

NAME
     fmgetwholemetrics - return information about each of the characters in a
     font

SYNOPSIS
     #include <fmclient.h>

     int fmgetwholemetrics(fh, fi)
     fmfonthandle fh;
     fmglyphinfo *fi;

DESCRIPTION
     fmgetwholemetrics gets the glyph (character) information associated the
     font handle fh and writes it to the fmglyphinfo structures pointed to by
     the elements of the fi array.  You should allocate enough space to
     contain nglyphs*sizeof(fmglyphinfo).  fmgetwholemetrics fills only those
     structures of the fi array that have corresponding glyphs in the font
     file. Therefore, you should initialize all the fmglyphinfo structures
     before calling fmgetwhometrics.  (For example, you could use calloc to
     allocate the space.  See the malloc(3c) man page.)

     The returned function value of fmgetwholemetrics is 0 if it executed
     successfully.  But if fmgetwholemetrics cannot find the font referenced
     by fh, the returned value of fmgetwholemetrics is -1.

     As with fmgetfontinfo, the fmglyphinfo structure is defined so as to be
     usable by FORTRAN clients.  Refer to /usr/include/fmclient.h

SEE ALSO
     fminit(3W), fmfindfont(3W), fmscalefont(3W), fmgetfontinfo(3W).

NOTE
     This routine is available only in immediate mode.