TTF_SetFontStyle(3)

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

💅 TTF_SetFontStyle(3) — the SDL_ttf3 glow-up page 🎀

okay so bestie, you found it: TTF_SetFontStyle, one of the SDL_ttf3 FUNCTIONS. It lives in SDL3_ttf/SDL_ttf.h and it's literally the "give my font a whole new personality" button. Let's get into it 🦋

✨ NAME ✨

TTF_SetFontStyle — set a font's current style. that's it, that's the whole vibe. 💖

📁 HEADER FILE 📁

Defined in SDL3_ttf/SDL_ttf.h — that's the file you gotta have, no cap.

🌸 SYNOPSIS 🌸

#include "SDL3_ttf/SDL_ttf.h"

void TTF_SetFontStyle(TTF_Font *font, TTF_FontStyleFlags style);

two params, one function, zero drama. slay. ✨

💜 DESCRIPTION 💜

So here's the tea: this updates any TTF_Text objects using this font, and it clears already-generated glyphs, if any, from the cache. meaning: your text gets a fresh new look, and the old cached glyphs get evicted like they overstayed their welcome. 🙈

The font styles are a set of bit flags, OR'd together (so you stack them with |, like accessories — the more the better 💅):

  • TTF_STYLE_NORMAL (is zero — yes, the "no style" option is literally zero, iconic)
  • TTF_STYLE_BOLD
  • TTF_STYLE_ITALIC
  • TTF_STYLE_UNDERLINE
  • TTF_STYLE_STRIKETHROUGH

🫶 FUNCTION PARAMETERS 🫶

  • font — the font to set a new style on. your main character. 👑
  • style — the new style values to set, OR'd together. mix and match, go feral.

🔥 THREAD SAFETY 🔥

This function should be called on the thread that created the font. like, don't be calling it from some random other thread, that's not the move. keep it in the family. 💀

⭐ AVAILABILITY ⭐

This function is available since SDL_ttf 3.0.0. so it's been here for a minute, you're not early, you're right on time. 🎀

🌈 SEE ALSO 🌈

go read TTF_GetFontStyle(3) if you wanna check what style a font is currently serving. iykyk. 🦋

okay bestie that's the whole page, and it was all from SDL_ttf, version 3.2.2 — so if it's broken, blame the version, not me. mwah, go style something pretty 💖✨🎀

📦 where this page comes from