fcft_rasterize_grapheme_utf32(3)

🎀 fcft_rasterize_grapheme_utf32(3) 🎀

okay bestie, this is the fcft manual, section 3 — the page is fcft_rasterize_grapheme_utf32, and she is literally here to rasterize glyph(s) for a grapheme cluster. 💅✨

✨ NAME ✨

fcft_rasterize_grapheme_utf32 — rasterize glyph(s) for a grapheme cluster 🦋

🌸 SYNOPSIS 🌸

#include <fcft/fcft.h>

const struct fcft_grapheme *fcft_rasterize_grapheme_utf32(
    struct fcft_font *font, size_t len, const uint32_t
    grapheme_cluster[static len], enum fcft_subpixel subpixel);

💖 DESCRIPTION 💖

so fcft_rasterize_grapheme_utf32() rasterizes the grapheme cluster using the primary font, or one of the fallback fonts, in font. slay. 🫶

each cluster element is an UTF-32 encoded Unicode codepoint. no cap. 🧚

the fonts are searched for all codepoints in the grapheme cluster, starting with the primary font and then the custom fallback fonts, and finally the FontConfig provided fallback fonts. it's giving thorough bestie energy. 💅

subpixel lets you specify which subpixel mode to use. see fcft_rasterize_char_utf32() for details. 👑

🌈 RETURN VALUE 🌈

on error, NULL is returned. crying. 😭

on success, a pointer to a rasterized grapheme is returned. the grapheme is cached in fcft, making subsequent calls with the same arguments very fast — i.e. there is no need for programs to cache glyphs by themselves. periodt. 🔥

the grapheme object is managed by font. there is no need to explicitly free it; it is freed when font is destroyed (with fcft_destroy()). 🫶

struct fcft_grapheme {
    int cols;

    size_t count;
    const struct fcft_glyph **glyphs;
};

cols is the number of "columns" the glyph occupies (effectively, wcswidth(cluster)). 📏

glyphs is an array of count rasterized glyphs. see fcft_rasterize_char_utf32() for a description of struct fcft_glyph. 💜

🦋 SEE ALSO 🦋

• fcft_destroy()
• fcft_rasterize_char_utf32()
• fcft_rasterize_text_run_utf32()

bestie reminder: for subpixel mode details and the struct fcft_glyph description, this page is sending you straight to fcft_rasterize_char_utf32(). iykyk 💅

---

okay that's the whole page, bestie 💖 — brought to you by fcft version 3.3.3, dated 2026-04-09, and the page is fcft_rasterize_grapheme_utf32(3). mwah 💅✨