TTF_CloseFont(3)

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

💖 TTF_CloseFont(3) 💖

okay bestie, gather round, because this one is short but it MATTERS. we're in the SDL_ttf3 FUNCTIONS section of the manual, and today's main character is TTF_CloseFont. she's the goodbye girl. the one who cleans up after the party. no cap.

✨ NAME ✨

TTF_CloseFont — dispose of a previously-created font.

like, yeet it. responsibly. 💅

🌸 HEADER FILE 🌸

defined in SDL3_ttf/SDL_ttf.h

🦋 SYNOPSIS 🦋

#include "SDL3_ttf/SDL_ttf.h"

void TTF_CloseFont(TTF_Font *font);

look at her. one function, one argument, zero drama. iconic.

🎀 DESCRIPTION 🎀

call this when you're done with a font, bestie. this function will free any resources associated with it. that's it, that's the job. she takes the font and she frees everything it was holding onto. very demure, very mindful.

and here's the part that makes her sooooo forgiving: it is safe to call this function on NULL, for example on the result of a failed call to TTF_OpenFont(). so if your font-opening went sideways and you got NULL back, you can still hand it to TTF_CloseFont and she will simply not care. no crash, no tears. 🫶

⚠️ but listen. the font is not valid after being passed to this function. gone. done. do not touch. do not look at it. do not pass go.

and it's not just the font object itself — string pointers from functions that return information on this font, such as TTF_GetFontFamilyName() and TTF_GetFontStyleName(), are no longer valid after this call, as well. so if you were holding onto one of those strings thinking you could use it later? nope. she's dust. 💀

🌈 FUNCTION PARAMETERS 🌈

  • font — the font to dispose of. hand her over and let her go. 🕊️

💜 THREAD SAFETY 💜

this function should not be called while any other thread is using the font.

read that again. fr fr. if another thread is out here using that font, you do NOT get to close it yet. that's not a vibe check you want to fail. 😭

⭐ AVAILABILITY ⭐

this function is available since SDL_ttf 3.0.0.

👑 SEE ALSO 👑

(yes bestie, the bullet-thingies are literally in the source. we keep it real here. ✨)

that's the whole page, gorgeous. short, sweet, and absolutely essential — because every font you open needs a bestie who'll close her properly. 🎀

SDL_ttf, version 3.2.2 — that's the source and version this page came from, mwah, talk later, don't forget to free your fonts 💖🌸🦋

📦 where this page comes from