Legacy Document

Inside Macintosh: Text /

Chapter 4 - Font Manager / Font Manager Reference

Routines / Favoring Outline Fonts Over Bitmapped Fonts

SetOutlinePreferred

The SetOutlinePreferred procedure sets the preference for whether to use bitmapped or outline fonts when both kinds of fonts are available.

PROCEDURE SetOutlinePreferred (outlinePreferred: Boolean);

outlinePreferred

Specifies whether the Font Manager chooses an outline font or a bitmapped font when both are available to fill a font request. A value
of TRUE indicates an outline font; a value of FALSE indicates a
bitmapped font.

DESCRIPTION

If an outline font and a bitmapped font are both available for a font request, the default behavior for the Font Manager is to choose the bitmapped font, in order to maintain compatibility with documents that were created on computer systems on which outline fonts were not available. The SetOutlinePreferred procedure sets the Font Manager's current preference for either bitmapped or outline fonts when both are available. If you want the Font Manager to choose outline fonts over any bitmapped font counterparts, set the outlinePreferred parameter to TRUE; if you want it to choose bitmapped fonts, set the outlinePreferred parameter to FALSE.

If only outline fonts are available, the Font Manager chooses them regardless of the setting of outlinePreferred; if only bitmapped fonts are available, they are
chosen. The Font Manager chooses bitmapped versus outline fonts on a size basis,
before it takes stylistic variations into account, which can lead to unexpected results.
For further information, see "How the Font Manager Responds to a Font Request," beginning on page 4-17.

The preference you set is valid only during the current session with your application. The outlinePreferred parameter does not set a global variable.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the SetOutlinePreferred procedure are

Trap macro	Routine selector
_FontDispatch	$7001