NAME¶

TTF_OpenFontIndexDPIIO - Opens a font from an SDL_IOStream with target resolutions (in DPI).

SYNOPSIS¶

#include "SDL3_ttf/SDL_ttf.h"

TTF_Font * TTF_OpenFontIndexDPIIO(SDL_IOStream *src, SDL_bool closeio, int ptsize, long index, 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.

If closeio is SDL_TRUE src will be automatically closed once the font is closed. Otherwise you should close src yourself after closing the font.

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.

FUNCTION PARAMETERS¶

src

an SDL_IOStream to provide a font file's data.

closeio

SDL_TRUE to close src when the font is closed, SDL_FALSE to leave it open.

ptsize

point size to use for the newly-opened font.

index

index of the face in the font file.

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)