Type

Summary

An object used in CAPI to describe a font.

Description

Objects of type font-description contain a description of a font. The description can be partial, with only some attributes given values. font-description objects are the normal way of specifying fonts in CAPI.

font-description objects are created or returned by make-font-description, convert-to-font-description, font-description, merge-font-descriptions and augment-font-description.

font-description objects are used as the font specification for CAPI panes (see simple-pane). They can also be used directly in calls to find-best-font and find-matching-fonts.

Notes

1. font-description objects do not contain native system dependent values, and are externalizable objects.
2. A font-description cannot be used directly as an argument to draw-string or draw-character, or as the value of the graphics state parameter font in a graphics-state. These require the result of find-best-font or find-matching-fonts.

See also

make-font-description
convert-to-font-description
merge-font-descriptions
augment-font-description
font-description-attributes
find-best-font
find-matching-fonts
General Properties of CAPI Panes