fcft_set_emoji_presentation(3)

πŸ’… fcft_set_emoji_presentation(3) β€” the fcft girlies' guide to emoji vibes

okay so bestie, this one lives in the fcft manual, and it's literally about making your emojis pick a lane. let's get into it πŸŽ€


✨ 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 πŸ’–

note: this function is deprecated and will be removed in the next major release. yes, she's on her way out 😭 use her while she's here but don't get attached.

fcft_set_emoji_presentation() configures the default presentation style to use with emojis that have both a text presentation and an emoji presentation style. two-faced icons, we stan πŸ’…

so these emojis can be followed by an (invisible) variation selector. when they're not followed by a selector, the implementation has to choose a style β€” someone's gotta make the call, and usually it's not you 🫠

one example of such an emoji is U+263A β€” WHITE SMILING FACE:

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

the Unicode standard defines the default presentation styles, and that's what fcft defaults to. iconic behavior, no notes πŸ‘‘

but sometimes the application is like "no actually, I want always text style" or "no actually, I want always emoji style." main character energy, honestly.

that's literally 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 (because yes, this matters fr fr): this setting affects emojis without an explicit variation selector. in other words, it overrides the default presentation style. it's giving "I'm the default now" 😌

FCFT_EMOJI_PRESENTATION_DEFAULT is the default, and causes fcft to use the default presentation as defined by Unicode. classic, reliable, she ate 🌈

FCFT_EMOJI_PRESENTATION_TEXT forces all multi-presentation style emojis to be rendered in their text presentation style. monochrome moment πŸ–€

FCFT_EMOJI_PRESENTATION_EMOJI forces all multi-presentation style emojis to be rendered in their emoji presentation style. full color, full sparkle ✨πŸ”₯

heads up bestie: this function does not clear the glyph caches, and should therefore be called before rasterizing any glyphs. set the vibe first, then render. don't be out here changing the rules mid-glyph πŸ™ˆ

πŸ¦‹ SEE ALSO πŸ¦‹

  • fcft_rasterize_char_utf32()
  • fcft_rasterize_grapheme_utf32()
  • fcft_rasterize_text_run_utf32()

and that's the whole page, bestie πŸ’œ this one's from fcft version 3.3.3, dated 2026-04-09, and it's fcft_set_emoji_presentation(3) signing off β€” go set some defaults and slay βœ¨πŸŽ€

πŸ“¦ where this page comes from