1fcft_set_emoji_presentation(3)       fcft       fcft_set_emoji_presentation(3)
2
3
4

NAME

6       fcft_set_emoji_presentation - configures the default emoji presentation
7

SYNOPSIS

9       #include <fcft/fcft.h>
10
11       bool fcft_set_emoji_presentation(struct fcft_font *font,
12           enum fcft_emoji_presentation presentation);
13

DESCRIPTION

15       fcft_set_emoji_presentation() configures the default presentation style
16       to use with emojis with both a text presentation, and an emoji presen‐
17       tation style.
18
19       One example of such an emoji is U+263A - WHITE SMILING FACE:
20
21       •   unqualified: ☺
22       •   text: ☺︎
23       •   emoji: ☺️
24
25
26       These emojis can be followed by an (invisible) variation selector. When
27       they are not followed by a selector, the implementation must choose a
28       style.
29
30       The Unicode standard defines the default presentation styles, and this
31       is what fcft defaults to.
32
33       However, in some cases, the application may want to always use either
34       the text style, or the emoji style.
35
36       This is what fcft_set_emoji_presentation() is for. Possible values for
37       presentation are:
38
39       •   FCFT_EMOJI_PRESENTATION_DEFAULT
40       •   FCFT_EMOJI_PRESENTATION_TEXT
41       •   FCFT_EMOJI_PRESENTATION_EMOJI
42
43
44       To re-iterate; this setting affects emoji's without an explicit varia‐
45       tion selector. In other words, it overrides the default presentation
46       style.
47
48       FCFT_EMOJI_PRESENTATION_DEFAULT is the default, and causes fcft to use
49       the default presentation as defined by Unicode.
50
51       FCFT_EMOJI_PRESENTATION_TEXT forces all multi-presentation style emojis
52       to be rendered in their text presentation style.
53
54       FCFT_EMOJI_PRESENTATION_EMOJI forces all multi-presentation style emo‐
55       jis to be rendered in their emoji presentation style.
56
57       This function does not clear the glyph caches and should therefore be
58       called before rasterizing any glyphs.
59

SEE ALSO

61       fcft_glyph_rasterize(), fcft_grapheme_rasterize(), fcft_text_run_ras‐
62       terize()
63
64
65
662.5.0                             2021-11-13    fcft_set_emoji_presentation(3)
Impressum