NAME¶

TTF_OpenFontDPI - Create a font from a file, using target resolutions (in DPI).

SYNOPSIS¶

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_OpenFontDPI(const char *file, int ptsize, unsigned int hdpi, unsigned int vdpi);

DESCRIPTION¶

DPI scaling only applies to scalable fonts (e.g. TrueType).

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.

hdpi

the target horizontal DPI.

vdpi

the target vertical DPI.

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)