cpython-withatomic / Doc / libfm.tex

The branch 'legacy-trunk' does not exist.
Full commit
\section{Built-in Module \sectcode{fm}}

This module provides access to the IRIS {\em Font Manager} library.
It is available only on Silicon Graphics machines.
See also: 4Sight User's Guide, Section 1, Chapter 5: Using the IRIS
Font Manager.

This is not yet a full interface to the IRIS Font Manager.
Among the unsupported features are: matrix operations; cache
operations; character operations (use string operations instead); some
details of font info; individual glyph metrics; and printer matching.

It supports the following operations:

\renewcommand{\indexsubitem}{(in module fm)}
Initialization function.
Calls \code{fminit()}.
It is normally not necessary to call this function, since it is called
automatically the first time the \code{fm} module is imported.

Return a font handle object.
Calls \code{fmfindfont(\var{fontname})}.

Returns a list of available font names.
This is an interface to \code{fmenumerate()}.

Render a string using the current font (see the \code{setfont()} font
handle method below).
Calls \code{fmprstr(\var{string})}.

Sets the font search path.
Calls \code{fmsetpath(string)}.
(XXX Does not work!?!)

Returns the current font search path.

Font handle objects support the following operations:

\renewcommand{\indexsubitem}{(font handle method)}
Returns a handle for a scaled version of this font.
Calls \code{fmscalefont(\var{fh}, \var{factor})}.

Makes this font the current font.
Note: the effect is undone silently when the font handle object is
Calls \code{fmsetfont(\var{fh})}.

Returns this font's name.
Calls \code{fmgetfontname(\var{fh})}.

Returns the comment string associated with this font.
Raises an exception if there is none.
Calls \code{fmgetcomment(\var{fh})}.

Returns a tuple giving some pertinent data about this font.
This is an interface to \code{fmgetfontinfo()}.
The returned tuple contains the following numbers:
{\tt(\var{printermatched}, \var{fixed_width}, \var{xorig}, \var{yorig},
\var{xsize}, \var{ysize}, \var{height}, \var{nglyphs})}.

Returns the width, in pixels, of the string when drawn in this font.
Calls \code{fmgetstrwidth(\var{fh}, \var{string})}.