Sets the alignment of the font string within the AlignWidth and AlignHeight area. This is used in addition to the X and Y drawing coordinates.

Defines the height of the area used for vertical alignment. If this field is 0, the target Bitmap height is used.

Defines the width of the area used for horizontal alignment. If this field is 0, the target Bitmap width is used.

Reflects the total number of pixels above the baseline, including Leading.

Setting this field before initialisation selects the Bold style, or Bold Italic if Italic is also set. Prefer Style when setting an exact style name.

Reflects the final horizontal coordinate reached by the most recent Draw() operation.

Reflects the final vertical coordinate reached by the most recent Draw() operation.

The name of an installed font face must be specified before initialisation unless Path is set directly. A list of available faces can be obtained from GetList().

Multiple font faces can be specified in CSV format, e.g. Sans Serif,Noto Sans. Names are resolved from left to right.

Forces all glyphs to advance by the specified pixel width. If the value is less than the widest glyph, rendered glyphs can overlap.

Adjusts horizontal glyph advance as a multiplier of each glyph's normal width. The default value is 1.0.

Using negative values is valid, and can lead to text being printed backwards.

Reflects the external leading, or descent area, below the baseline.

Reflects the initialised font height in pixels. It does not include Leading; use Ascent when the leading-inclusive distance above the baseline is required.

The height is calculated on initialisation and can be read at any time.

Setting this field before initialisation selects the Italic style, or Bold Italic if Bold is also set. Prefer Style when setting an exact style name.

Returns the number of lines in String. If WrapEdge is set, wrapped lines are included in the count.

Defines the vertical distance from one line baseline to the next. It is initialised from the selected font and can be increased or decreased to adjust line spacing. If negative, later lines are drawn upward.

If set before initialisation, the value is added to the font's normal line spacing instead of replacing it. For instance, setting the LineSpacing to 2 will result in an extra 2 pixels being added to the font's spacing.

Reflects the maximum bitmap height for the selected font at the current point size.

Determines the translucency level of the font fill colour. The default setting is 100, meaning fully opaque. Lower values blend the glyphs with the destination Bitmap.

Please note that the use of translucency will always have an impact on the time it normally takes to draw a font.

Draws a one-pixel outline around bitmap glyphs when set to an RGB8 colour with a non-zero alpha component. Set the field to NULL or use an alpha value of zero to disable outlining.

Defines the exact font file to load before initialisation. This bypasses normal face-name resolution through the font database.

This feature is ideal for use when distributing custom fonts with an application.

Defines the requested font size in points.

When setting the point size of a bitmap font, the system will try and find the closest matching value for the requested point size. For instance, if you request a fixed font at point 11 and the closest size is point 8, the system will drop the font to point 8.

The String field must be defined to draw text with a Font object. It must contain valid UTF-8. Line feed characters start a new line during Draw().

If a string contains characters that are not supported by a font, those characters will be printed using a default character from the font.

Selects the preferred style for initialisation. If the selected face does not provide that style, regular styling or the first registered style is used.

Bitmap fonts are a special case if a bold or italic style is selected. In this situation the system can automatically convert the font to that style even if the correct graphics set does not exist.

Conventional font styles are Bold, Bold Italic, Italic and Regular (the default).

Controls the tab interval, measured in character columns.

The default tab size is 8. This field only affects tab characters in String.

Draws an underline using the supplied RGB8 colour. Set the field to NULL or use an alpha value of zero to disable underlining.

Returns the pixel width of String using the current font metrics and wrapping settings. If String is empty, the result is 0.

Enables word wrapping when set to a value greater than zero. Wrapping occurs when a word extends beyond this X coordinate.

Defines the starting horizontal coordinate for Draw(). The default coordinate is 0.

Defines the starting vertical coordinate for Draw(). The default coordinate is 0.

Returns the vertical offset applied by VERTICAL or BOTTOM alignment. Add this value to Y to determine the aligned drawing baseline.