fcft_font_options_create(3)

💅 fcft_font_options_create — bestie, let's make a font options object ✨

Okay so this one's from the fcft manual, section 3, and it's literally the glow-up moment where you get a shiny new options object to hand off to fcft_from_name2(3). Slay.

🌸 SYNOPSIS 🌸

#include <fcft/fcft.h>

struct fcft_font_options *fcft_font_options_create(void);

✨ DESCRIPTION ✨

So fcft_font_options_create() allocates a struct fcft_font_options object, and that object is the one you'll be using with fcft_from_name2(3). That's it, that's the whole job. 💖

The returned object comes pre-initialized with default values — you just manually set struct members to override whatever you want. Easy.

⚠️ Note, and this is important, bestie: you must use fcft_font_options_create() to allocate the options object. Do not allocate it yourself — not from the heap, not on the stack. This is to ensure forward compatibility. No cap, don't skip this one. 🙈

Here's the struct in all its glory:

struct fcft_font_options {
    enum fcft_scaling_filter scaling_filter;
    enum fcft_emoji_presentation emoji_presentation;

    struct {
        bool srgb_decode;
        pixman_format_code_t format;
    } color_glyphs;
};

---

🎀 SCALING FILTER 🎀

This one configures the filter to use when downscaling bitmap fonts (typically emoji fonts). Iconic behavior honestly.

Possible values are:

• FCFT_SCALING_FILTER_NONE
• FCFT_SCALING_FILTER_NEAREST
• FCFT_SCALING_FILTER_BILINEAR
• FCFT_SCALING_FILTER_IMPULSE
• FCFT_SCALING_FILTER_BOX
• FCFT_SCALING_FILTER_LINEAR
• FCFT_SCALING_FILTER_CUBIC
• FCFT_SCALING_FILTER_GAUSSIAN
• FCFT_SCALING_FILTER_LANCZOS2
• FCFT_SCALING_FILTER_LANCZOS3
• FCFT_SCALING_FILTER_LANCZOS3_STRETCHED

FCFT_SCALING_FILTER_NONE disables filtering. Periodt.

FCFT_SCALING_FILTER_NEAREST and FCFT_SCALING_FILTER_BILINEAR are the traditional filters, and nearest is the fastest of the bunch. 🏃‍♀️💨

The rest are separable convolution filters. Fancy.

The default is FCFT_SCALING_FILTER_CUBIC. 💜

---

🦋 EMOJI PRESENTATION 🦋

So emoji_presentation configures the default presentation style to use with emojis that have both a text presentation and an emoji presentation style. Double threat emojis, iykyk.

These emojis can be followed by an (invisible) variation selector. When they're not followed by a selector, the implementation must choose a style. Main character decision, fr fr.

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. 🤓

But sometimes the application may want to always use either the text style or the emoji style. That's literally what emoji_presentation is for. Possible values are:

• FCFT_EMOJI_PRESENTATION_DEFAULT
• FCFT_EMOJI_PRESENTATION_TEXT
• FCFT_EMOJI_PRESENTATION_EMOJI

To re-iterate (because this part matters bestie): this setting affects emojis 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. 🎉

---

🌈 COLOR GLYPHS 🌈

srgb_decode: when true, the pixel data will be decoded from sRGB to linear space. When false (the default), the pixel data is used as is.

format defines the pixman surface format to use for color glyphs. The default is PIXMAN_a8r8g8b8. One use is to enable higher color precision when srgb_decode is enabled, to avoid loss of precision when decoding from sRGB. 💅

---

👑 SEE ALSO 👑

• fcft_from_name2()
• fcft_font_options_destroy()

---

Okay that's the whole page! 🫶 Cute little sign-off for you: this one's from fcft 3.3.3, dated 2026-04-09, and it's the fcft_font_options_create(3) page. Go forth and allocate responsibly, bestie. 💖✨🎀