• size — The size of the text, either in points (the default) or logical drawing units, depending on the “size-in-pixels?” property (see below).

• family — A platform- and device-independent font designation. The families are:

  • 'default

  • 'decorative

  • 'roman

  • 'script

  • 'swiss

  • 'modern (fixed width)

  • 'symbol (Greek letters and more)

  • 'system (similar to the font to draw control labels, but see normal-control-font)

  The terminology “family” and “face” is mangled relative to its usual meaning. A font% “face” is really used more like a font family in the usual terminology or more generally as a face-description string that is combined with other font% attributes to arrive at a face. A font% “family” is a kind of abstract font family that is mapped to a particular font family on a given platform.

• face — A string face name, such as "Courier". The format and meaning of a face name is platform- and device-specific. If a font’s face name is #f, then the font’s appearance depends only on the family. If a face is provided but no mapping is available for the face name (for a specific platform or device), then the face name is ignored and the family is used. See font-name-directory<%> for information about how face names are mapped for drawing text.

• style — The slant style of the font, one of:

  • 'normal

  • 'slant (a.k.a “oblique”)

  • 'italic

• weight — The weight of the font, one of:

  • (integer-in 100 1000)

  • 'thin (equivalent to 100)

  • 'ultralight (equivalent to 200)

  • 'light (equivalent to 300)

  • 'semilight (equivalent to 350)

  • 'book (equivalent to 380)

  • 'normal (equivalent to 400)

  • 'medium (equivalent to 500)

  • 'semibold (equivalent to 600)

  • 'bold (equivalent to 700)

  • 'ultrabold (equivalent to 800)

  • 'heavy (equivalent to 900)

  • 'ultraheavy (equivalent to 1000)

  Changed in version 1.14 of package draw-lib: Changed to allow integer values and the symbols 'thin, 'ultralight, 'semilight, 'book, 'medium, 'semibold, 'ultrabold, 'heavy, and 'ultraheavy.

• underline? — #t for underlined, #f for plain.

• smoothing — Amount of anti-alias smoothing, one of:

  • 'default (platform-specific, sometimes user-configurable)

  • 'partly-smoothed (gray anti-aliasing)

  • 'smoothed (sub-pixel anti-aliasing)

  • 'unsmoothed

• size-in-pixels? — #t if the size of the font is in logical drawing units (i.e., pixels for an unscaled screen or bitmap drawing context), #f if the size of the font is in points, where a point is equal to 1 pixel on Mac OS and (/ 96 72) pixels on Windows and Unix

• hinting — Whether font metrics should be rounded to integers:

  • 'aligned (the default) — rounds to integers to improve the consistency of letter spacing for pixel-based targets, but at the expense of making metrics unscalable

  • 'unaligned — disables rounding

• feature settings — A hash of OpenType feature settings to enable or disable optional typographic features of OpenType fonts. Each entry in the hash maps a four-letter OpenType feature tag to its desired value. For boolean OpenType features, a value of 0 means “disabled” and a value of 1 means “enabled”; for other features, the meaning of the value varies (and may even depend on the font itself).

  Added in version 1.19 of package draw-lib.

To avoid creating multiple fonts with the same characteristics, use the global font-list% object the-font-list.

See also font-name-directory<%>.

Changed in version 1.2 of package draw-lib: Defined “points” as (/ 96 72) pixels on Windows, independent of the screen resolution.
Changed in version 1.14: Changed “weight” to allow integer values and the symbols 'thin, 'ultralight, 'semilight, 'book, 'medium, 'semibold, 'ultrabold, 'heavy, and 'ultraheavy.
Changed in version 1.19: Added the “feature settings” property to control OpenType features.

See font% for information about family, style, weight, smoothing, size-in-pixels?, hinting, and feature-settings. font-name-directory<%>.

See also make-font.

Changed in version 1.4 of package draw-lib: Changed size to allow non-integer and zero values.
Changed in version 1.14: Changed weight to allow integer values and the symbols 'thin, 'ultralight, 'semilight, 'book, 'medium, 'semibold, 'ultrabold, 'heavy, and 'ultraheavy.
Changed in version 1.19: Added the optional feature-settings argument.

See get-size, instead. The get-point-size method is provided for backward compatibility.

Due to space included in a font by a font designer, a font tends to generate text that is slightly taller than the nominal size.

Added in version 1.4 of package draw-lib.
Changed in version 1.19: Added the in-pixels? argument.

If the second argument is true, the result indicates whether the glyph is available for control labels. Otherwise, it indicates whether the glyph is available for dc<%> drawing.

For dc<%> drawing, due to automatic font substitution when drawing or measuring text, the result of this method does not depend on this font’s attributes (size, face, etc.). The font’s attributes merely provide a hint for the glyph search.