Font class is set of font data sources used to draw text. Font contains a set of glyphs to represent Unicode characters, as well as the ability to draw it with variable width, ascent, descent and kerning. [b]Note:[/b] A character is a symbol that represents an item (letter, digit etc.) in an abstract way. [b]Note:[/b] A glyph is a bitmap or shape used to draw a one or more characters in a context-dependent manner. Glyph indices are bound to the specific font data source. [b]Note:[/b] If a non of the font data sources contain glyphs for a character used in a string, the character in question will be replaced with a box displaying its hexadecimal code. [codeblocks] [gdscript] var font = Font.new() font.add_data(load("res://BarlowCondensed-Bold.ttf")) $"Label".set("custom_fonts/font", font) $"Label".set("custom_fonts/font_size", 64) [/gdscript] [csharp] var font = new Font(); font.AddData(ResourceLoader.Load<FontData>("res://BarlowCondensed-Bold.ttf")); GetNode("Label").Set("custom_fonts/font", font); GetNode("Label").Set("custom_font_sizes/font_size", 64); [/csharp] [/codeblocks] To control font substitution priority use [FontData] language and script support. Use language overrides to use same [Font] stack for multiple languages: [codeblocks] [gdscript] # Use Naskh font for Persian and Nastaʼlīq font for Urdu text. var font_data_fa = load("res://NotoNaskhArabicUI_Regular.ttf"); font_data_fa.set_language_support_override("fa", true); font_data_fa.set_language_support_override("ur", false); var font_data_ur = load("res://NotoNastaliqUrdu_Regular.ttf"); font_data_ur.set_language_support_override("fa", false); font_data_ur.set_language_support_override("ur", true); [/gdscript] [csharp] // Use Naskh font for Persian and Nastaʼlīq font for Urdu text. var fontDataFA = ResourceLoader.Load<FontData>("res://NotoNaskhArabicUI_Regular.ttf"); fontDataFA.SetLanguageSupportOverride("fa", true); fontDataFA.SetLanguageSupportOverride("ur", false); var fontDataUR = ResourceLoader.Load<FontData>("res://NotoNastaliqUrdu_Regular.ttf"); fontDataUR.SetLanguageSupportOverride("fa", false); fontDataUR.SetLanguageSupportOverride("ur", true); [/csharp] [/codeblocks] Use script overrides to specify supported scripts for bitmap font or for less common scripts not directly supported by TrueType format: [codeblocks] [gdscript] # Use specified font for Egyptian hieroglyphs. var font_data = load("res://unifont.ttf"); font_data.set_script_support_override("Egyp", true); [/gdscript] [csharp] // Use specified font for Egyptian hieroglyphs. var fontData = ResourceLoader.Load<FontData>("res://unifont.ttf"); fontData.SetScriptSupportOverride("Egyp", true); [/csharp] [/codeblocks] Add font data source to the set. Draw a single Unicode character [code]char[/code] into a canvas item using the font, at a given position, with [code]modulate[/code] color, and optionally kerning if [code]next[/code] is passed. [code]position[/code] specifies the baseline, not the top. To draw from the top, [i]ascent[/i] must be added to the Y axis. [b]Note:[/b] Do not use this function to draw strings character by character, use [method draw_string] or [TextLine] instead. Breaks [code]text[/code] to the lines using rules specified by [code]flags[/code] and draws it into a canvas item using the font, at a given position, with [code]modulate[/code] color, optionally clipping the width and aligning horizontally. [code]position[/code] specifies the baseline of the first line, not the top. To draw from the top, [i]ascent[/i] must be added to the Y axis. See also [method CanvasItem.draw_multiline_string]. Draw [code]text[/code] into a canvas item using the font, at a given position, with [code]modulate[/code] color, optionally clipping the width and aligning horizontally. [code]position[/code] specifies the baseline, not the top. To draw from the top, [i]ascent[/i] must be added to the Y axis. See also [method CanvasItem.draw_string]. Returns the average font ascent (number of pixels above the baseline). [b]Note:[/b] Real ascent of the string is context-dependent and can be significantly different from the value returned by this function. Use it only as rough estimate (e.g. as the ascent of empty line). Returns the size of a character, optionally taking kerning into account if the next character is provided. [b]Note:[/b] Do not use this function to calculate width of the string character by character, use [method get_string_size] or [TextLine] instead. Returns the font data source at index [code]idx[/code]. If the index does not exist, returns [code]null[/code]. Returns the number of font data sources. Returns the average font descent (number of pixels below the baseline). [b]Note:[/b] Real descent of the string is context-dependent and can be significantly different from the value returned by this function. Use it only as rough estimate (e.g. as the descent of empty line). Returns the total average font height (ascent plus descent) in pixels. [b]Note:[/b] Real height of the string is context-dependent and can be significantly different from the value returned by this function. Use it only as rough estimate (e.g. as the height of empty line). Returns the size of a bounding box of a string broken into the lines, taking kerning and advance into account. See also [method draw_multiline_string]. Returns the spacing for the given [code]type[/code] (see [enum SpacingType]). Returns the size size of a bounding box of a string, taking kerning and advance into account. See also [method draw_string]. Returns a string containing all the characters available in the font. If a given character is included in more than one font data source, it appears only once in the returned string. Return average pixel offset of the underline below the baseline. [b]Note:[/b] Real underline position of the string is context-dependent and can be significantly different from the value returned by this function. Use it only as rough estimate. Return average thickness of the underline. [b]Note:[/b] Real underline thickness of the string is context-dependent and can be significantly different from the value returned by this function. Use it only as rough estimate. Return [code]true[/code] if a Unicode [code]char[/code] is available in the font. Removes the font data source at index [code]idx[/code]. If the index does not exist, nothing happens. Sets the font data source at index [code]idx[/code]. If the index does not exist, nothing happens. Sets the spacing for [code]type[/code] (see [enum SpacingType]) to [code]value[/code] in pixels (not relative to the font size). After editing a font (changing data sources, etc.). Call this function to propagate changes to controls that might use it. Extra spacing at the bottom in pixels. Extra character spacing in pixels. Spacing at the top of the line. Spacing at the bottom of the line.