SDL Wiki
(This function is part of SDL_ttf, a separate library from SDL.)


Create a font from an SDL_IOStream, using a specified point size.

Header File

Defined in <SDL3_ttf/SDL_ttf.h>


TTF_Font * TTF_OpenFontIO(SDL_IOStream *src, SDL_bool closeio, int ptsize);

Function Parameters

SDL_IOStream * src an SDL_IOStream to provide a font file's data.
SDL_bool closeio SDL_TRUE to close src when the font is closed, SDL_FALSE to leave it open.
int ptsize point size to use for the newly-opened font.

Return Value

(TTF_Font *) Returns a valid TTF_Font, or NULL on error.


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 SDL_TRUE, src will be automatically closed once the font is closed. Otherwise you should close src yourself after closing the font.

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


This function is available since SDL_ttf 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.