.\" Generated by scdoc 1.11.2
.\" 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" "2024-02-01" "3.1.7" "fcft"
.P
.SH NAME
.P
fcft_set_emoji_presentation - configures the default emoji presentation
.P
.SH SYNOPSIS
.P
\fB#include <fcft/fcft.\&h>\fR
.P
\fBbool fcft_set_emoji_presentation(struct fcft_font *\fR\fIfont\fR\fB,
.RS 4
enum fcft_emoji_presentation \fR\fIpresentation\fR\fB);\fR
.P
.RE
.SH DESCRIPTION
.P
\fBfcft_set_emoji_presentation\fR() configures the default presentation
style to use with emojis with both a text presentation, and an emoji
presentation style.\&
.P
These emojis can be followed by an (invisible) variation
selector.\& When they are not followed by a selector, the implementation
must choose a style.\&
.P
One example of such an emoji is U+263A - WHITE SMILING FACE:
.P
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
unqualified: ☺
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
text: ☺︎
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
emoji: ☺️

.RE
.P
The Unicode standard defines the default presentation styles, and this
is what fcft defaults to.\&
.P
However, in some cases, the application may want to always use either
the text style, or the emoji style.\&
.P
This is what \fBfcft_set_emoji_presentation\fR() is for.\& Possible values
for \fIpresentation\fR are:
.P
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBFCFT_EMOJI_PRESENTATION_DEFAULT\fR
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBFCFT_EMOJI_PRESENTATION_TEXT\fR
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBFCFT_EMOJI_PRESENTATION_EMOJI\fR

.RE
.P
To re-iterate; this setting affects emoji'\&s without an explicit
variation selector.\& In other words, it overrides the \fBdefault\fR
presentation style.\&
.P
\fBFCFT_EMOJI_PRESENTATION_DEFAULT\fR is the default, and causes fcft
to use the default presentation as defined by Unicode.\&
.P
\fBFCFT_EMOJI_PRESENTATION_TEXT\fR forces all multi-presentation style
emojis to be rendered in their text presentation style.\&
.P
\fBFCFT_EMOJI_PRESENTATION_EMOJI\fR forces all multi-presentation style
emojis to be rendered in their emoji presentation style.\&
.P
This function does \fBnot\fR clear the glyph caches and should therefore be
called before rasterizing any glyphs.\&
.P
.SH SEE ALSO
.P
\fBfcft_rasterize_char_utf32\fR(), \fBfcft_rasterize_grapheme_utf32\fR(),
\fBfcft_rasterize_text_run_utf32\fR()