fmfindfont(3W)

NAME
     fmfindfont - select a font face.

SYNOPSIS
     #include <fmclient.h>

     fmfonthandle fmfindfont(face)
     char *face;

DESCRIPTION
     Before you can call fmfindfont, you must startup the Font Manager.  (Call
     fminit.)  Once you have initialized the Font Manager, you can call
     fmfindfont to get a font handle for a type face. The face argument
     expects a pointer to a character string that specifies a font family. The
     returned value of the function is the requested font handle.  This font
     handle gives you access to a one point version of the font.  Use
     fmfonthandle much as you would use the findfont operator of PostScript.

     If fmfindfont does not find the specified font, it returns a value of
     zero (0).

     Later, you can scale the one point font or (optionally) read from disk a
     specific font size (larger than one point) from the within the family.
     For example, to prepare to use Times-Roman, call fmfindfont with Times-
     Roman as the argument:

          fmfindfont("Times-Roman");


SEE ALSO
     fminit(3w), fmfontpath(3w), fmsetpath(3w), fmscalefont(3w),
     fmsetfont(3w).

NOTE
     This routine is available only in immediate mode.