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

TTF_OpenFontIndex

Create a font from a file, using a specified face index.

Syntax

TTF_Font * TTF_OpenFontIndex(const char *file, int ptsize, long index);

Function Parameters

file path to font file.
ptsize point size to use for the newly-opened font.
index index of the face in the font file.

Return Value

Returns a valid TTF_Font, or NULL on error.

Remarks

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.

Some fonts have multiple "faces" included. The index specifies which face to use from the font file. Font files with only one face should specify zero for the index.

When done with the returned TTF_Font, use TTF_CloseFont() to dispose of it.

Version

This function is available since SDL_ttf 3.0.0.


CategoryAPI


[ 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.