• 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 (used to draw control labels)

  The 'symbol designation is special under Mac OS X and X with fontconfig/Xft; characters in the ASCII range 0-255 are converted to Unicode characters that match Adobe symbols. For example, a is converted to α.

• face – A string face name, such as "Courier" (under Windows and Mac OS X), "-*-courier" (under X), or " Luxi Sans" (under X with fontconfig/Xft; note the leading space). 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 (Windows, Mac OS X: same as 'italic; X: tries 'italic if 'slant font does not exist)

  • 'italic (X: tries 'slant if 'italic font does not exist)

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

  • 'normal

  • 'light

  • 'bold

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

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

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

  • 'partly-smoothed (Windows: TrueType when available; Mac OS X: 4-bit, pixel-aligned smoothing; X: fontconfig/Xft when available)

  • 'smoothed (Windows: ClearType when available, XP and up; Mac OS X: Quartz smoothing; X: fontconfig/Xft when available)

  • 'unsmoothed

  Special case: 'default corresponds to 'partly-smoothed when used with the 'modern family and a font size between 9 and 13 (inclusive).

• 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 (which can depend on screen resolution).

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

See also font-name-directory<%>.

See font% for information about family, style, and weight. font-name-directory<%>.

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.

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.