TTF_OpenFontIO(3)

📦
version 3.2.2 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

okay so bestie, welcome to TTF_OpenFontIO(3) from the SDL_ttf3 FUNCTIONS manual 💖✨ this one is literally about opening a font from an SDL_IOStream with a point size, and it’s giving “tiny but important” main character energy 💅

✨ NAME ✨

TTF_OpenFontIO — create a font from an SDL_IOStream, using a specified point size 🎀

🎀 HEADER FILE 🎀

Defined in SDL3_ttf/SDL_ttf.h 🦋

🦋 SYNOPSIS 🦋

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_OpenFontIO(SDL_IOStream *src, bool closeio, float ptsize);

💜 DESCRIPTION 💜

okay so here’s the tea ☕ some .fon fonts will have several sizes embedded in the file, so the point size becomes the index of choosing which size. If the value is too high, the last indexed size will be the default 👀

If closeio is true, src will be automatically closed once the font is closed. Otherwise you should keep src open until the font is closed — no cap, that part matters 🫶

When done with the returned TTF_Font, use TTF_CloseFont () to dispose of it 🧚

🌸 FUNCTION PARAMETERS 🌸

  • src — an SDL_IOStream to provide a font file's data 📁
  • closeio — true to close src when the font is closed, false to leave it open 🔓
  • ptsize — point size to use for the newly-opened font 🔢

⭐ RETURN VALUE ⭐

The return type is ( TTF_Font *) — yes, literally that — and it returns a valid TTF_Font , or NULL on failure; call SDL_GetError() for more information 😭

🔥 THREAD SAFETY 🔥

It is safe to call this function from any thread 💀✨ no stress, bestie.

🌈 AVAILABILITY 🌈

This function is available since SDL_ttf 3.0.0 🗓️💖

👑 SEE ALSO 👑

  • •(3) — yep, that’s literally what the page says, I’m just the messenger 🙈
  • TTF_CloseFont(3) — the cleanup bestie 🧼💅

cute little sign-off: this page comes from source SDL_ttf, version SDL_ttf 3.2.2, and the footer doesn’t list a date — so that’s the whole footer tea, bestie 🍓🫶 mwah 💋

📦 where this page comes from