.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "fcft_set_emoji_presentation" "3" "2025-01-02" "3.1.10" "fcft"
.PP
.SH NAME
.PP
fcft_set_emoji_presentation - configures the default emoji presentation
.PP
.SH SYNOPSIS
.PP
\fB#include <fcft/fcft.\&h>\fR
.PP
\fBbool fcft_set_emoji_presentation(struct fcft_font *\fR\fIfont\fR\fB,
.RS 4
enum fcft_emoji_presentation \fR\fIpresentation\fR\fB);\fR
.PP
.RE
.SH DESCRIPTION
.PP
\fBfcft_set_emoji_presentation\fR() configures the default presentation
style to use with emojis with both a text presentation, and an emoji
presentation style.\&
.PP
These emojis can be followed by an (invisible) variation
selector.\& When they are not followed by a selector, the implementation
must choose a style.\&
.PP
One example of such an emoji is U+263A - WHITE SMILING FACE:
.PP
.PD 0
.IP \(bu 4
unqualified: ☺
.IP \(bu 4
text: ☺︎
.IP \(bu 4
emoji: ☺️
.PD
.PP
The Unicode standard defines the default presentation styles, and this
is what fcft defaults to.\&
.PP
However, in some cases, the application may want to always use either
the text style, or the emoji style.\&
.PP
This is what \fBfcft_set_emoji_presentation\fR() is for.\& Possible values
for \fIpresentation\fR are:
.PP
.PD 0
.IP \(bu 4
\fBFCFT_EMOJI_PRESENTATION_DEFAULT\fR
.IP \(bu 4
\fBFCFT_EMOJI_PRESENTATION_TEXT\fR
.IP \(bu 4
\fBFCFT_EMOJI_PRESENTATION_EMOJI\fR
.PD
.PP
To re-iterate; this setting affects emoji'\&s without an explicit
variation selector.\& In other words, it overrides the \fBdefault\fR
presentation style.\&
.PP
\fBFCFT_EMOJI_PRESENTATION_DEFAULT\fR is the default, and causes fcft
to use the default presentation as defined by Unicode.\&
.PP
\fBFCFT_EMOJI_PRESENTATION_TEXT\fR forces all multi-presentation style
emojis to be rendered in their text presentation style.\&
.PP
\fBFCFT_EMOJI_PRESENTATION_EMOJI\fR forces all multi-presentation style
emojis to be rendered in their emoji presentation style.\&
.PP
This function does \fBnot\fR clear the glyph caches and should therefore be
called before rasterizing any glyphs.\&
.PP
.SH SEE ALSO
.PP
\fBfcft_rasterize_char_utf32\fR(), \fBfcft_rasterize_grapheme_utf32\fR(),
\fBfcft_rasterize_text_run_utf32\fR()