find-best-font Function

Summary

Returns the best font for a CAPI pane.

Package

graphics-ports

Signature

find-best-font pane fdesc => font

Arguments

pane⇩	A graphic port.
fdesc⇩	A font description.

Values

font

A font.

Description

The function find-best-font returns the best font for pane which matches fdesc. When there alternative fonts available the choice of best font is operating system dependent.

When fdesc contains the attribute :stock with value :system-font or :system-fixed-font, the lookup will always find a stock font.

By default find-best-font looks only for Truetype fonts in LispWorks 6.1 and later.

Notes

With the default drawing-mode :quality only Truetype fonts are supported. Non-Truetype fonts are supported only when using drawing-mode :compatible.

Compatibility note

To get the LispWorks 6.0 behavior where non-Truetype fonts are also found, pass :type :wild to make-font-description.

Examples

(example-edit-file "capi/graphics/catherine-wheel")

See also

find-matching-fonts
make-font-description
prompt-for-font
13 Drawing - Graphics Ports