TTF_AddFallbackFont(3)

📦 version 3.2.2, in debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 TTF_AddFallbackFont(3) 💖

okay bestie, so this is a page from the SDL_ttf3 FUNCTIONS manual, and it's about making your fonts have a little backup squad. no cap. 🫶

🌸 NAME 🌸

TTF_AddFallbackFont — Add a fallback font.

🎀 HEADER FILE 🎀

Defined in SDL3_ttf/SDL_ttf.h

✨ SYNOPSIS ✨

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_AddFallbackFont(TTF_Font *font, TTF_Font *fallback);

💅 DESCRIPTION 💅

so basically? you're adding a font that gets used for glyphs that are not in the current font. it's giving "if my main font doesn't have this character, bestie here will cover for it." 💖

the fallback font should have the same size and style as the current font. literally matching energy only.

if there are multiple fallback fonts, they are used in the order added. first come, first served, periodt. 👑

and yes, this updates any TTF_Text objects using this font. no need to go rebuild them yourself, she handles it. 🦋

🌈 FUNCTION PARAMETERS 🌈

  • font — the font to modify.
  • fallback — the font to add as a fallback.

⭐ RETURN VALUE ⭐

Returns true on success or false on failure. if it flops, call SDL_GetError() for more information — she'll tell you what went wrong, fr fr. 😭

🔥 THREAD SAFETY 🔥

This function should be called on the thread that created both fonts. both of them. don't be messy about it. 💀

👑 AVAILABILITY 👑

This function is available since SDL_ttf 3.0.0.

🧚 SEE ALSO 🧚

not me making font fallbacks sound like a group chat. but like, that's literally what they are. 🌸

that's the whole page, bestie — stay iconic, keep your glyphs covered, and remember: this was brought to you by SDL_ttf version 3.2.2. slay 💅✨

📦 where this page comes from