From b9ef703eb14ba2357b847b62a715b4e97f690209 Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Thu, 20 Aug 2020 19:25:35 +0200 Subject: wip: grapheme shaping --- doc/foot.ini.5.scd | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'doc') diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 58134060..94ad42f6 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -975,6 +975,28 @@ any of these options. Default: _no_. +*grapheme-shaping* + Boolean. When enabled, foot will use _utf8proc_ to do grapheme + cluster segmentation while parsing "printed" text. Then, when + rendering, it will use _fcft_ (if compiled with _HarfBuzz_ + support) to shape the grapheme clusters. + + This is required to render e.g. flag (emoji) sequences, keycap + sequences, modifier sequences, zero-width-joiner (ZWJ) sequences + andn emoji tag sequences. + + This is an experimental feature with the following requirements and limitations: + + - foot must have been compiled with utf8proc support + - fcft must have been compiled with HarfBuzz support + - This option must be set to true + - Foot will use *wcswidth*(3) to calculate a cluster's display + width. This will typically _not_ match the shaped glyph's width, + but is necessary to not break cursor synchronization with the + application running in foot. + + Default: _no_ + *max-shm-pool-size-mb* This option controls the amount of virtual address space used by the pixmap memory to which the terminal screen content is -- cgit v1.3 From f3e5c3deb943bde60364e129a63bea5d56cb6159 Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Thu, 24 Jun 2021 10:10:38 +0200 Subject: doc: foot.ini: grapheme-shaping: mention regular compose characters --- doc/foot.ini.5.scd | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 94ad42f6..2e408b3a 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -983,9 +983,11 @@ any of these options. This is required to render e.g. flag (emoji) sequences, keycap sequences, modifier sequences, zero-width-joiner (ZWJ) sequences - andn emoji tag sequences. + andn emoji tag sequences. It might also improve rendering of + composed characters, depending on font. - This is an experimental feature with the following requirements and limitations: + This is an experimental feature with the following requirements + and limitations: - foot must have been compiled with utf8proc support - fcft must have been compiled with HarfBuzz support -- cgit v1.3