[pango/pango2: 46/56] docs: Add a section on custom fonts
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [pango/pango2: 46/56] docs: Add a section on custom fonts
- Date: Tue, 14 Jun 2022 03:59:26 +0000 (UTC)
commit 56d59ea1661cb9c5a469f0f51343dd9527191396
Author: Matthias Clasen <mclasen redhat com>
Date: Mon Jun 13 00:01:43 2022 -0400
docs: Add a section on custom fonts
docs/pango_fonts.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
---
diff --git a/docs/pango_fonts.md b/docs/pango_fonts.md
index 21dd98c01..1cae8c685 100644
--- a/docs/pango_fonts.md
+++ b/docs/pango_fonts.md
@@ -31,6 +31,25 @@ Once you have a fontmap, you can enumerate the available font families using
the [iface@Gio.ListModel] implementation of the fontmap. To enumerate the faces
of a font family, use the [iface@Gio.ListModel] implementation of the font family.
+# Custom Fonts
+
+The default font map used by Pango will contain the fonts that are available
+via the font enumeration APIs of the system (for Linux, that is fontconfig).
+For special situations (such as writing Pango tests), it can appropriate
+to create an empty font map with [ctor Pango FontMap new] and populate it
+only with the fonts you need, using [method@Pango.FontMap.add_file].
+
+It is also possible to add custom fonts to the default font map if you
+just want to make some custom font available in addition to the normal
+system fonts. While loading a font from a .ttf or .otf file with
+[method@Pango.FontMap.add_file] is often the most convenient way to add
+a custom font, it is also possible to load a font from memory by combining
+[ctor@Pango.HbFace.new_from_hb_face] and `hb_face_create()`.
+
+Another approach to custom fonts is to draw the glyphs yourself. This
+is possible with [class@Pango.UserFace]. Such font faces can also be
+added to font maps and used like regular font faces.
+
# Font Descriptions
Since loading fonts uses system resources, Pango provides a way to describe
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]