TTF_CopyFont(3)

✨ TTF_CopyFont(3) ✨

okay bestie, welcome to the SDL_ttf3 FUNCTIONS corner of the manual, you're gonna love it here 🫶

---

💖 NAME 💖

TTF_CopyFont — make a whole entire copy of a font you already have. it's giving "twin but not identical" 💅

---

🌸 HEADER FILE 🌸

she lives in SDL3_ttf/SDL_ttf.h, no cap ✨

---

🎀 SYNOPSIS 🎀

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_CopyFont(TTF_Font *existing_font);

---

🦋 DESCRIPTION 🦋

so the copy you get back is distinct from the original — like, separate entity, her own main character energy — BUT she shares the same font file, and she's got the exact same size and style as the original. same vibe, different girl. iconic 🌈

when you're done with the TTF_Font she hands you, use

TTF_CloseFont()

to dispose of it. don't just leave her hanging, that's rude 😭

---

💜 FUNCTION PARAMETERS 💜

• existing_font — the font you wanna copy. the original. the blueprint. the moment 👑

---

⭐ RETURN VALUE ⭐

(TTF_Font *) — returns a valid TTF_Font, or NULL on failure. and if it's NULL? call SDL_GetError() for more info, she'll tell you what went wrong 💀

---

🧚 THREAD SAFETY 🧚

this function should be called on the thread that created the original font. same thread, always. don't be messy about it 🚫🧵

---

🌸 AVAILABILITY 🌸

available since SDL_ttf 3.0.0, so she's been around, she's established, she's got seniority 💅

---

🔥 SEE ALSO 🔥

• •(3)
• TTF_CloseFont(3)

---

okay that's the whole page bestie, go forth and copy fonts responsibly 💖✨

sending you off with love from the SDL_ttf manual, version SDL_ttf 3.2.2 — mwah, xoxo 🎀🦋