TTF_CloseFont(3)

TTF_CloseFont3

Dispose of a previously-created font.

Usage

#include "SDL3_ttf/SDL_ttf.h"

void TTF_CloseFont(TTF_Font *font);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Overview

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.

From libsdl3-ttf-doc 3.2.2+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.