TTF_SetTextFont(3)

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

✨ TTF_SetTextFont ✨

okay so bestie, this one lives in the SDL_ttf3 FUNCTIONS fam — it's TTF_SetTextFont(3), and it's literally the glow-up button for your text's font. 💅

🌸 NAME 🌸

TTF_SetTextFont — set the font used by a text object. that's it, that's the job, and she does it flawlessly. 🎀

🦋 HEADER FILE 🦋

Defined in SDL3_ttf/SDL_ttf.h

💖 SYNOPSIS 💖

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_SetTextFont(TTF_Text *text, TTF_Font *font);

👑 DESCRIPTION 👑

so here's the tea ☕ — when a text object already has a font, any changes you make to that font will automatically regenerate the text. like, the text just keeps up with the font's era, no extra steps. iconic behaviour honestly.

but if you set the font to NULL? bestie. the text will continue to render, yes, but changes to the font will no longer affect the text. it's giving "we're not together anymore but i still look cute". 🙈

heads up: this function may cause the internal text representation to be rebuilt. so don't be shocked if stuff under the hood gets a little makeover. ✨

🫶 FUNCTION PARAMETERS 🫶

  • text — the TTF_Text to modify. the main character in question. 💜
  • font — the font to use, and yes, it may be NULL. no judgement. 🧚

🔥 RETURN VALUE 🔥

Returns false if the text pointer is null; otherwise, true. and if it goes false on you, go call SDL_GetError() for more information — she'll tell you what's up. 😭

💀 THREAD SAFETY 💀

This function should be called on the thread that created the text. don't be crossing threads, babe, it's not that kind of party. 🚫

⭐ AVAILABILITY ⭐

This function is available since SDL_ttf 3.0.0. so she's been here. she's established. periodt. 👑

🌈 SEE ALSO 🌈

and that's the whole vibe check — go set some fonts, bestie, you're gonna slay. 🦋✨

mwah 💖 this was page TTF_SetTextFont(3) from the SDL_ttf manual, SDL_ttf 3.2.2 era, brought to you with love and zero cap.

📦 where this page comes from