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