From 99666de00fb30cb86473257776504ca70b4469c3 Mon Sep 17 00:00:00 2001 From: bruvzg <7645683+bruvzg@users.noreply.github.com> Date: Thu, 3 Sep 2020 14:22:16 +0300 Subject: [Complex Text Layouts] Refactor Font class, default themes and controls to use Text Server interface. Implement interface mirroring. Add TextLine and TextParagraph classes. Handle UTF-16 input on macOS and Windows. --- doc/classes/BitmapFont.xml | 112 ----------------------------------- doc/classes/DynamicFontData.xml | 36 ----------- doc/classes/Font.xml | 128 ---------------------------------------- doc/classes/Label.xml | 2 +- 4 files changed, 1 insertion(+), 277 deletions(-) delete mode 100644 doc/classes/BitmapFont.xml delete mode 100644 doc/classes/DynamicFontData.xml delete mode 100644 doc/classes/Font.xml (limited to 'doc/classes') diff --git a/doc/classes/BitmapFont.xml b/doc/classes/BitmapFont.xml deleted file mode 100644 index 87cffdaca0..0000000000 --- a/doc/classes/BitmapFont.xml +++ /dev/null @@ -1,112 +0,0 @@ - - - - Renders text using fonts under the [url=https://www.angelcode.com/products/bmfont/]BMFont[/url] format. - Handles files with the [code].fnt[/code] extension. - - - Renders text using [code]*.fnt[/code] fonts containing texture atlases. Supports distance fields. For using vector font files like TTF directly, see [DynamicFont]. - - - - - - - - - - - - - - - - - - - Adds a character to the font, where [code]character[/code] is the Unicode value, [code]texture[/code] is the texture index, [code]rect[/code] is the region in the texture (in pixels!), [code]align[/code] is the (optional) alignment for the character and [code]advance[/code] is the (optional) advance. - - - - - - - - - - - - - Adds a kerning pair to the [BitmapFont] as a difference. Kerning pairs are special cases where a typeface advance is determined by the next character. - - - - - - - - - Adds a texture to the [BitmapFont]. - - - - - - - Clears all the font data and settings. - - - - - - - - - Creates a BitmapFont from the [code]*.fnt[/code] file at [code]path[/code]. - - - - - - - - - - - Returns a kerning pair as a difference. - - - - - - - - - Returns the font atlas texture at index [code]idx[/code]. - - - - - - - Returns the number of textures in the BitmapFont atlas. - - - - - - Ascent (number of pixels above the baseline). - - - If [code]true[/code], distance field hint is enabled. - - - The fallback font. - - - Total font height (ascent plus descent) in pixels. - - - - - diff --git a/doc/classes/DynamicFontData.xml b/doc/classes/DynamicFontData.xml deleted file mode 100644 index 45585f17e0..0000000000 --- a/doc/classes/DynamicFontData.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - - Used with [DynamicFont] to describe the location of a font file. - - - Used with [DynamicFont] to describe the location of a vector font file for dynamic rendering at runtime. - - - https://godotengine.org/asset-library/asset/676 - - - - - - If [code]true[/code], the font is rendered with anti-aliasing. This property applies both to the main font and its outline (if it has one). - - - The path to the vector font file. - - - The font hinting mode used by FreeType. See [enum Hinting] for options. - - - - - Disables font hinting (smoother but less crisp). - - - Use the light font hinting mode. - - - Use the default font hinting mode (crisper but less smooth). - - - diff --git a/doc/classes/Font.xml b/doc/classes/Font.xml deleted file mode 100644 index f49fbf0d2a..0000000000 --- a/doc/classes/Font.xml +++ /dev/null @@ -1,128 +0,0 @@ - - - - Internationalized font and text drawing support. - - - 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. - [b]Note:[/b] If a DynamicFont doesn't contain a character used in a string, the character in question will be replaced with codepoint [code]0xfffd[/code] if it's available in the DynamicFont. If this replacement character isn't available in the DynamicFont, the character will be hidden without displaying any replacement character in the string. - [b]Note:[/b] If a BitmapFont doesn't contain a character used in a string, the character in question will be hidden without displaying any replacement character in the string. - - - - - - - - - - - - - - - - - - - - - Draw [code]string[/code] into a canvas item using the font at a given position, with [code]modulate[/code] color, and optionally clipping the width. [code]position[/code] specifies the baseline, not the top. To draw from the top, [i]ascent[/i] must be added to the Y axis. - See also [method CanvasItem.draw_string]. - - - - - - - - - - - - - - - - - - - Draw character [code]char[/code] into a canvas item using the font at a given position, with [code]modulate[/code] color, and optionally kerning if [code]next[/code] is passed. clipping the width. [code]position[/code] specifies the baseline, not the top. To draw from the top, [i]ascent[/i] 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. - - - - - - - Returns the font ascent (number of pixels above the baseline). - - - - - - - - - - - Returns the size of a character, optionally taking kerning into account if the next character is provided. - - - - - - - Returns the font descent (number of pixels below the baseline). - - - - - - - Returns the total font height (ascent plus descent) in pixels. - - - - - - - - - Returns the size of a string, taking kerning and advance into account. - - - - - - - - - - - Returns the size that the string would have with word wrapping enabled with a fixed [code]width[/code]. - - - - - - - Returns [code]true[/code] if the font has an outline. - - - - - - - - - - - - - After editing a font (changing size, ascent, char rects, etc.). Call this function to propagate changes to controls that might use it. - - - - - - diff --git a/doc/classes/Label.xml b/doc/classes/Label.xml index 570d7f075b..01719ecbfd 100644 --- a/doc/classes/Label.xml +++ b/doc/classes/Label.xml @@ -111,7 +111,7 @@ [Color] of the text's shadow effect. - The tint of [Font]'s outline. See [member DynamicFont.outline_color]. + The tint of [Font]'s outline. Vertical space between lines in multiline [Label]. -- cgit v1.2.3