SDL Wiki
(This function is part of SDL_ttf, a separate library from SDL.)


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

Header File

Defined in SDL_ttf.h


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

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.


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.


This function is available since SDL_ttf 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.