• 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.

For a size in points and a screen or bitmap drawing context, the logical height depends on the resolution of the screen.

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.