TTF_CloseFont - Man Page

Dispose of a previously-created font.

Header File

Defined in SDL3_ttf/SDL_ttf.h

Synopsis

#include "SDL3_ttf/SDL_ttf.h"

void TTF_CloseFont(TTF_Font *font);

Description

Call this when done with a font. This function will free any resources associated with it. It is safe to call this function on NULL, for example on the result of a failed call to TTF_OpenFont ().

The font is not valid after being passed to this function. 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.

Function Parameters

font

the font to dispose of.

Thread Safety

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

Availability

This function is available since SDL_ttf 3.0.0.

See Also

·(3), TTF_OpenFont(3), ·(3), TTF_OpenFontIO(3)

Referenced By

TTF_CopyFont(3), TTF_OpenFont(3), TTF_OpenFontIO(3), TTF_OpenFontWithProperties(3).

SDL_ttf 3.2.2 SDL_ttf3 FUNCTIONS