Font¶

Inherits: Resource < Reference < Object

Inherited By: BitmapFont, DynamicFont

Internationalized font and text drawing support.

Description¶

Font contains a Unicode-compatible character set, as well as the ability to draw it with variable width, ascent, descent and kerning. For creating fonts from TTF files (or other font formats), see the editor support for fonts.

Methods¶

void	draw ( RID canvas_item, Vector2 position, String string, Color modulate=Color( 1, 1, 1, 1 ), int clip_w=-1, Color outline_modulate=Color( 1, 1, 1, 1 ) ) const
float	draw_char ( RID canvas_item, Vector2 position, int char, int next=-1, Color modulate=Color( 1, 1, 1, 1 ), bool outline=false ) const
float	get_ascent ( ) const
float	get_descent ( ) const
float	get_height ( ) const
Vector2	get_string_size ( String string ) const
Vector2	get_wordwrap_string_size ( String string, float width ) const
bool	has_outline ( ) const
bool	is_distance_field_hint ( ) const
void	update_changes ( )

Method Descriptions¶

void draw ( RID canvas_item, Vector2 position, String string, Color modulate=Color( 1, 1, 1, 1 ), int clip_w=-1, Color outline_modulate=Color( 1, 1, 1, 1 ) ) const

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

float draw_char ( RID canvas_item, Vector2 position, int char, int next=-1, Color modulate=Color( 1, 1, 1, 1 ), bool outline=false ) const

Draw character char into a canvas item using the font at a given position, with modulate color, and optionally kerning if next is passed. clipping the width. position specifies the baseline, not the top. To draw from the top, ascent must be added to the Y axis. The width used by the character is returned, making this function useful for drawing strings character by character.

float get_ascent ( ) const

Returns the font ascent (number of pixels above the baseline).

float get_descent ( ) const

Returns the font descent (number of pixels below the baseline).

float get_height ( ) const

Returns the total font height (ascent plus descent) in pixels.

Vector2 get_string_size ( String string ) const

Returns the size of a string, taking kerning and advance into account.

Vector2 get_wordwrap_string_size ( String string, float width ) const

Returns the size that the string would have with word wrapping enabled with a fixed width.

bool has_outline ( ) const

Returns true if the font has an outline.

bool is_distance_field_hint ( ) const

void update_changes ( )

After editing a font (changing size, ascent, char rects, etc.). Call this function to propagate changes to controls that might use it.