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

TTF_OpenFontDPIRW

Opens a font from an SDL_RWops with target resolutions (in DPI).

Syntax

TTF_Font * TTF_OpenFontDPIRW(SDL_RWops *src, int freesrc, int ptsize, unsigned int hdpi, unsigned int vdpi);

Function Parameters

src

an SDL_RWops to provide a font file's data.

freesrc

non-zero to close the RWops before returning, zero to leave it open.

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.

Remarks

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 freesrc is non-zero, the RWops will be closed before returning, whether this function succeeds or not. SDL_ttf reads everything it needs from the RWops during this call in any case.

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

Version

This function is available since SDL_ttf 2.0.18.

TTF_CloseFont

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.