NAME

       fcft_set_emoji_presentation - configures the default emoji presentation

SYNOPSIS

       #include <fcft/fcft.h>

       bool fcft_set_emoji_presentation(struct fcft_font *font,
           enum fcft_emoji_presentation presentation);

DESCRIPTION

       fcft_set_emoji_presentation() configures the default presentation style to use with emojis
       with both a text presentation, and an emoji presentation style.

       One example of such an emoji is U+263A - WHITE SMILING FACE:

       •   unqualified: ☺
       •   text: ☺︎
       •   emoji: ☺️

       These emojis can be followed by an (invisible) variation selector. When they are not
       followed by a selector, the implementation must choose a style.

       The Unicode standard defines the default presentation styles, and this is what fcft
       defaults to.

       However, in some cases, the application may want to always use either the text style, or
       the emoji style.

       This is what fcft_set_emoji_presentation() is for. Possible values for presentation are:

       •   FCFT_EMOJI_PRESENTATION_DEFAULT
       •   FCFT_EMOJI_PRESENTATION_TEXT
       •   FCFT_EMOJI_PRESENTATION_EMOJI

       To re-iterate; this setting affects emoji's without an explicit variation selector. In
       other words, it overrides the default presentation style.

       FCFT_EMOJI_PRESENTATION_DEFAULT is the default, and causes fcft to use the default
       presentation as defined by Unicode.

       FCFT_EMOJI_PRESENTATION_TEXT forces all multi-presentation style emojis to be rendered in
       their text presentation style.

       FCFT_EMOJI_PRESENTATION_EMOJI forces all multi-presentation style emojis to be rendered in
       their emoji presentation style.

       This function does not clear the glyph caches and should therefore be called before
       rasterizing any glyphs.

SEE ALSO

       fcft_glyph_rasterize(), fcft_grapheme_rasterize(), fcft_text_run_rasterize()