FMGETWHOLEMETRICS(3W)					 FMGETWHOLEMETRICS(3W)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <fmclient.h>

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111