fmscalefont(3W)

NAME
     fmscalefont - scale a font face.

SYNOPSIS
     #include <fmclient.h>

     fmfonthandle fmscalefont(fh, scale)
     fmfonthandle fh;
     double scale;

DESCRIPTION
     fmfindfont returns a handle to a 1-point-high font in the face specified.
     fmscalefont applies the provided scale factor to the matrix associated
     with this instance of the font, returning a new handle. Later, when the
     font is imaged, this value is used to determine the size of characters to
     use.  Its default coordinate system is in points, so passing a scale of
     "12" creates a specification of a 12-point font.  This is display-
     resolution independent.  Its functionality parallels the scalefont
     operator of PostScript.

     If fmscalefont is not able to scale a specified font, it returns a value
     of zero (0).

SEE ALSO
     fminit(3W), fmfontpath(3W), fmsetpath(3W), fmfindfont(3W), fmsetfont(3W),
     fmconcatpagematrix(3W), fmgetpagematrix(3W), fminitpagematrix(3W),
     fmrotatepagematrix(3W), fmscalepagematrix(3W), fmsetpagematrix(3W).

NOTES
     Subsequent use of any of the routines discussed on the fmmatrix man page
     can cause a different transformation of the font to be either described
     (by fmgetfontinfo or fmprstr) or imaged.  The page matrix is always
     concatenated with the font matrix before imaging a string or giving out
     information about a font.

NOTE
     This routine is available only in immediate mode.