NAME¶

TTF_OpenFontRW - Create a font from an SDL_RWops, using a specified point size.

SYNOPSIS¶

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_OpenFontRW(SDL_RWops *src, SDL_bool freesrc, int ptsize);

DESCRIPTION¶

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

When done with the returned TTF_Font , use

TTF_CloseFont () to dispose of it.

FUNCTION PARAMETERS¶

src

an SDL_RWops to provide a font file's data.

freesrc

SDL_TRUE to close the RWops when the font is closed, SDL_FALSE to leave it open.

ptsize

point size to use for the newly-opened font.

RETURN VALUE¶

Returns a valid TTF_Font , or NULL on error.

AVAILABILITY¶

This function is available since SDL_ttf 3.0.0.

SEE ALSO¶

TTF_CloseFont(3)