diff options
| author | Hugo Locurcio <hugo.locurcio@hugo.pro> | 2022-07-22 22:09:38 +0200 |
|---|---|---|
| committer | Hugo Locurcio <hugo.locurcio@hugo.pro> | 2022-07-22 22:39:00 +0200 |
| commit | f0b896e9a3f8e39b23c1fdad80344d2466e7c1f6 (patch) | |
| tree | 89ddb14de9469135f1b5dfb717e2b3acc95a9430 | |
| parent | 79463aa5defb083569d193658a62755223f14dc4 (diff) | |
Add example usage for `Font.get_string_size()`
The font size is now separated from the font itself, so it makes
sense to have an example for people coming from Godot 3.x.
| -rw-r--r-- | doc/classes/Font.xml | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/classes/Font.xml b/doc/classes/Font.xml index e95f444d55..6377c829e1 100644 --- a/doc/classes/Font.xml +++ b/doc/classes/Font.xml @@ -226,9 +226,12 @@ <argument index="5" name="direction" type="int" enum="TextServer.Direction" default="0" /> <argument index="6" name="orientation" type="int" enum="TextServer.Orientation" default="0" /> <description> - Returns the size of a bounding box of a string, taking kerning and advance into account. + Returns the size of a bounding box of a single-line string, taking kerning and advance into account. See also [method get_multiline_string_size] and [method draw_string]. + For example, to get the string size as displayed by a single-line Label, use: + [codeblock] + var string_size = $Label.get_theme_font("font").get_string_size($Label.text, HORIZONTAL_ALIGNMENT_LEFT, -1, $Label.get_theme_font_size("font_size")) + [/codeblock] [b]Note:[/b] Real height of the string is context-dependent and can be significantly different from the value returned by [method get_height]. - See also [method draw_string]. </description> </method> <method name="get_supported_chars" qualifiers="const"> |