FMSCALEFONT(3W)						       FMSCALEFONT(3W)

NAME    [Toc]    [Back]

     fmscalefont - scale a font	face.

SYNOPSIS    [Toc]    [Back]

     #include <fmclient.h>

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

DESCRIPTION    [Toc]    [Back]

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

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

NOTES    [Toc]    [Back]

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

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111