FMGETWHOLEMETRICS(3W)FMGETWHOLEMETRICS(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 ALSOfminit(3W), fmfindfont(3W), fmscalefont(3W), fmgetfontinfo(3W).
NOTE
This routine is available only in immediate mode.
Page 1
