diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2023-02-13 09:11:21 +0100 |
|---|---|---|
| committer | Rémi Verschelde <rverschelde@gmail.com> | 2023-02-13 09:11:21 +0100 |
| commit | 3cc78567d7ee5209f7b316f2bb556e57d2e789c7 (patch) | |
| tree | bea516d33952535e818f4882dfc98a182501543c | |
| parent | 2615a99b3f8abc118970190614eb49f811577e2f (diff) | |
| parent | 11f6dc295de9b0225359877fbef9e288dde1e9be (diff) | |
Merge pull request #73103 from Calinou/doc-font-get-string-size
Clarify `Font.get_string_size()` taking kerning into account
| -rw-r--r-- | doc/classes/Font.xml | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/doc/classes/Font.xml b/doc/classes/Font.xml index 761e75339a..2f1c68c322 100644 --- a/doc/classes/Font.xml +++ b/doc/classes/Font.xml @@ -238,7 +238,7 @@ <param index="5" name="direction" type="int" enum="TextServer.Direction" default="0" /> <param index="6" name="orientation" type="int" enum="TextServer.Orientation" default="0" /> <description> - 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]. + Returns the size of a bounding box of a single-line string, taking kerning, advance and subpixel positioning 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: [codeblocks] [gdscript] @@ -249,6 +249,7 @@ Vector2 stringSize = label.GetThemeFont("font").GetStringSize(label.Text, HorizontalAlignment.Left, -1, label.GetThemeFontSize("font_size")); [/csharp] [/codeblocks] + [b]Note:[/b] Since kerning, advance and subpixel positioning are taken into account by [method get_string_size], using separate [method get_string_size] calls on substrings of a string then adding the results together will return a different result compared to using a single [method get_string_size] call on the full string. [b]Note:[/b] Real height of the string is context-dependent and can be significantly different from the value returned by [method get_height]. </description> </method> |