Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Font¶

Inherits: Resource < RefCounted < Object

Inherited By: FontFile, FontVariation, SystemFont

Abstract base class for fonts and font variations.

Description¶

Abstract base class for different font types. It has methods for drawing text and font character introspection.

Methods¶

float	draw_char ( RID canvas_item, Vector2 pos, int char, int font_size, Color modulate=Color(1, 1, 1, 1) ) const
float	draw_char_outline ( RID canvas_item, Vector2 pos, int char, int font_size, int size=-1, Color modulate=Color(1, 1, 1, 1) ) const
void	draw_multiline_string ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int max_lines=-1, Color modulate=Color(1, 1, 1, 1), LineBreakFlag brk_flags=3, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
void	draw_multiline_string_outline ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int max_lines=-1, int size=1, Color modulate=Color(1, 1, 1, 1), LineBreakFlag brk_flags=3, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
void	draw_string ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, Color modulate=Color(1, 1, 1, 1), JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
void	draw_string_outline ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int size=1, Color modulate=Color(1, 1, 1, 1), JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
RID	find_variation ( Dictionary variation_coordinates, int face_index=0, float strength=0.0, Transform2D transform=Transform2D(1, 0, 0, 1, 0, 0) ) const
float	get_ascent ( int font_size=16 ) const
Vector2	get_char_size ( int char, int font_size ) const
float	get_descent ( int font_size=16 ) const
int	get_face_count ( ) const
Font[]	get_fallbacks ( ) const
String	get_font_name ( ) const
int	get_font_stretch ( ) const
FontStyle	get_font_style ( ) const
String	get_font_style_name ( ) const
int	get_font_weight ( ) const
float	get_height ( int font_size=16 ) const
Vector2	get_multiline_string_size ( String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int max_lines=-1, LineBreakFlag brk_flags=3, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
Dictionary	get_opentype_features ( ) const
Dictionary	get_ot_name_strings ( ) const
RID[]	get_rids ( ) const
int	get_spacing ( SpacingType spacing ) const
Vector2	get_string_size ( String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const
String	get_supported_chars ( ) const
Dictionary	get_supported_feature_list ( ) const
Dictionary	get_supported_variation_list ( ) const
float	get_underline_position ( int font_size=16 ) const
float	get_underline_thickness ( int font_size=16 ) const
bool	has_char ( int char ) const
bool	is_language_supported ( String language ) const
bool	is_script_supported ( String script ) const
void	set_cache_capacity ( int single_line, int multi_line )
void	set_fallbacks ( Font[] fallbacks )

Method Descriptions¶

float draw_char ( RID canvas_item, Vector2 pos, int char, int font_size, Color modulate=Color(1, 1, 1, 1) ) const

Draw a single Unicode character char into a canvas item using the font, at a given position, with modulate color. pos specifies the baseline, not the top. To draw from the top, ascent must be added to the Y axis.

Note: Do not use this function to draw strings character by character, use draw_string or TextLine instead.

float draw_char_outline ( RID canvas_item, Vector2 pos, int char, int font_size, int size=-1, Color modulate=Color(1, 1, 1, 1) ) const

Draw a single Unicode character char outline into a canvas item using the font, at a given position, with modulate color and size outline size. pos specifies the baseline, not the top. To draw from the top, ascent must be added to the Y axis.

Note: Do not use this function to draw strings character by character, use draw_string or TextLine instead.

void draw_multiline_string ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int max_lines=-1, Color modulate=Color(1, 1, 1, 1), LineBreakFlag brk_flags=3, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const

Breaks text into lines using rules specified by brk_flags and draws it into a canvas item using the font, at a given position, with modulate color, optionally clipping the width and aligning horizontally. pos specifies the baseline of the first line, not the top. To draw from the top, ascent must be added to the Y axis.

void draw_multiline_string_outline ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, int max_lines=-1, int size=1, Color modulate=Color(1, 1, 1, 1), LineBreakFlag brk_flags=3, JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const

Breaks text to the lines using rules specified by brk_flags and draws text outline into a canvas item using the font, at a given position, with modulate color and size outline size, optionally clipping the width and aligning horizontally. pos specifies the baseline of the first line, not the top. To draw from the top, ascent must be added to the Y axis.

void draw_string ( RID canvas_item, Vector2 pos, String text, HorizontalAlignment alignment=0, float width=-1, int font_size=16, Color modulate=Color(1, 1, 1, 1), JustificationFlag justification_flags=3, Direction direction=0, Orientation orientation=0 ) const

Draw text into a canvas item using the font, at a given position, with modulate color, optionally clipping the width and aligning horizontally. pos specifies the baseline, not the top. To draw from the top, ascent must be added to the Y axis.