TTF_OpenFont(3)

TTF_OpenFont3

Create a font from a file, using a specified point size.

Usage

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_OpenFont(const char *file, float ptsize);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Overview

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.

When done with the returned TTF_Font , use

TTF_CloseFont () to dispose of it.

Function parameters

file

path to font file.

ptsize

point size to use for the newly-opened font.

Return value

( TTF_Font
*) 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.

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.