Font rendering - Revision history

Tectu: /* Anti-Aliasing */

2021-07-30T13:47:40Z

‎Anti-Aliasing

2021-07-30T13:46:57Z

‎Usage

2021-07-30T13:46:47Z

‎Font metrics

2016-11-12T16:17:31Z

2016-02-21T21:01:15Z

‎Font metrics

2016-01-03T13:09:46Z

2015-11-10T14:25:27Z

‎Unicode

2015-10-30T15:06:54Z

‎Word-Wrapping

2015-10-30T15:01:32Z

‎Word-Wrapping

2015-10-30T15:00:35Z

‎Font metrics

@@ Line 19: / Line 19: @@
 # Either have <code>GDISP_NEED_PIXELREAD</code> set to <code>TRUE</code> or using one of the [[Drawing#Text|text drawing functions]] that have a background color parameter.
-Note that you can use normal (not anti-aliased) fonts along with anti-aliased ones without any problems.
+Note that you can use normal (non anti-aliased) fonts along with anti-aliased ones without any problems.
 === Kerning ===

@@ Line 109: / Line 109: @@
 Before you can use a font, you first have to open it by calling <code>gdispOpenFont()</code>.
 <syntaxhighlight lang=c>
-font_t font = gdispOpenFont("DejaVuSans32_aa");
+gFont font = gdispOpenFont("DejaVuSans32_aa");
 </syntaxhighlight>
 '''''Note:''' When the font name specified could not be found, the last enabled font in the [[Configuration|configuration file]] will be used.''

@@ Line 145: / Line 145: @@
 <source lang=c>
-typedef enum fontmetric { fontHeight, fontDescendersHeight, fontLineSpacing, fontCharPadding, fontMinWidth, fontMaxWidth, fontBaselineX, fontBaselineY } fontmetric_t;
+typedef enum fontmetric {
-coord_t gdispGetFontMetric(font_t font, fontmetric_t metric);
+gCoord gdispGetFontMetric(gFont font, fontmetric_t metric);
-coord_t gdispGetCharWidth(char c, font_t font);
+gCoord gdispGetCharWidth(char c, gFont font);
-coord_t gdispGetStringWidth(const char* str, font_t font);
+gCoord gdispGetStringWidth(const char* str, gFont font);
-coord_t gdispGetStringWidthCount(const char* str, font_t font, uint16_t count);
+gCoord gdispGetStringWidthCount(const char* str, gFont font, uint16_t count);
 </source>
 [[Category:GDISP]]

@@ Line 1: / Line 1: @@
 == Features ==
 The µGFX font rendering engine provides the following features:
@@ Line 155: / Line 153: @@
 </source>
 [[Category:GDISP]]

@@ Line 146: / Line 146: @@
 The GDISP API provides several function to retrieve information about font metrics:
-<syntaxhighlight lang=c>
+<source lang=c>
 typedef enum fontmetric { fontHeight, fontDescendersHeight, fontLineSpacing, fontCharPadding, fontMinWidth, fontMaxWidth, fontBaselineX, fontBaselineY } fontmetric_t;
@@ Line 152: / Line 152: @@
 coord_t gdispGetCharWidth(char c, font_t font);
 coord_t gdispGetStringWidth(const char* str, font_t font);
-</syntaxhighlight>
+coord_t gdispGetStringWidthCount(const char* str, font_t font, uint16_t count);
 [[Category:GDISP]]

@@ Line 128: / Line 128: @@
 === 2. Convert the font ===
-The next step is to convert the font into a format that can be understood by the µGFX decoder. This can be done very easily using our [http://ugfx.org/fontconvert.php online converter].
+The next step is to convert the font into a format that can be understood by the µGFX decoder. This can be done very easily using our [http://fonts.ugfx.org online converter].
 The converter allows you to set the font size, enable or disable anti-aliasing and filter for certain characters. Filtering un-needed characters is essential to keep the font size low. This [http://en.wikipedia.org/wiki/Basic_multilingual_plane#Basic_Multilingual_Plane table] might help you choose the correct character range. A click on the button «Get .c file» will offer you a C file to download after a few moments. Please click that button just once. It can take up to a minute to convert a larger font.

← Older revision		Revision as of 14:25, 10 November 2015
Line 12:		Line 12:
	[http://en.wikipedia.org/wiki/Unicode Unicode] support can be enabled by setting <code>GDISP_NEED_TEXT_UTF8</code> to <code>TRUE</code>.		[http://en.wikipedia.org/wiki/Unicode Unicode] support can be enabled by setting <code>GDISP_NEED_TEXT_UTF8</code> to <code>TRUE</code>.

		+	Unicode support allows to display fonts of many different languages such as English, French, German, Russian (Cyrillic), Chinese, Japanese and so on.
	For information about cyrillic font support, see [[Cyrillic]].		For information about cyrillic font support, see [[Cyrillic]].

@@ Line 7: / Line 7: @@
 The word wrapping feature can be enabled by setting <code>GDISP_NEED_TEXT_WORDWRAP</code> to <code>TRUE</code>.
-Word wrapping only has an effect when using <code>gdispDrawStringBox()</code> or <code>gdispFillStringBox()</code>.
+Word wrapping only has an effect when using <code>gdispDrawStringBox()</code> or <code>gdispFillStringBox()</code>. When the word wrapping feature is not enabled the string will simply be cut-off at the border of the specified box.
 === Unicode ===

@@ Line 5: / Line 5: @@
 === Word-Wrapping ===
-Word wrapping support can be enabled by setting <code>GDISP_NEED_TEXT_WORDWRAP</code> to <code>TRUE</code>.
+The word wrapping feature can be enabled by setting <code>GDISP_NEED_TEXT_WORDWRAP</code> to <code>TRUE</code>.
 Word wrapping only has an effect when using <code>gdispDrawStringBox()</code> or <code>gdispFillStringBox()</code>.