Font¶
Inherits: Resource < Reference < Object
Inherited By: BitmapFont, DynamicFont
Category: Core
Brief Description¶
Internationalized font and text drawing support.
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 |
bool | has_outline ( ) const |
bool | is_distance_field_hint ( ) const |
void | update_changes ( ) |
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.
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.
Returns the size of a string, taking kerning and advance into account.
- bool has_outline ( ) const
- 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.