.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL_ttf's wiki page for TTF_OpenFontIndexDPIIO:
.\"   https://wiki.libsdl.org/SDL_ttf/TTF_OpenFontIndexDPIIO
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision 3~git20240320~6e260a2+ds-1
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20TTF_OpenFontIndexDPIIO
.\" SDL_ttf can be found at https://libsdl.org/projects/SDL_ttf
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH TTF_OpenFontIndexDPIIO 3 "SDL_ttf 3.0.0" "SDL_ttf" "SDL_ttf3 FUNCTIONS"
.SH NAME
TTF_OpenFontIndexDPIIO \- Opens a font from an SDL_IOStream with target resolutions (in DPI)\[char46]
.SH SYNOPSIS
.nf
.B #include \(dqSDL3_ttf/SDL_ttf.h\(dq
.PP
.BI "TTF_Font * TTF_OpenFontIndexDPIIO(SDL_IOStream *src, SDL_bool closeio, int ptsize, long index, unsigned int hdpi, unsigned int vdpi);
.fi
.SH DESCRIPTION
DPI scaling only applies to scalable fonts (e\[char46]g\[char46] TrueType)\[char46]

Some \[char46]fon fonts will have several sizes embedded in the file, so the point
size becomes the index of choosing which size\[char46] If the value is too high,
the last indexed size will be the default\[char46]

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

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

When done with the returned 
.BR TTF_Font
, use

.BR TTF_CloseFont
() to dispose of it\[char46]

.SH FUNCTION PARAMETERS
.TP
.I src
an SDL_IOStream to provide a font file's data\[char46]
.TP
.I closeio
SDL_TRUE to close
.BR src
when the font is closed, SDL_FALSE to leave it open\[char46]
.TP
.I ptsize
point size to use for the newly-opened font\[char46]
.TP
.I index
index of the face in the font file\[char46]
.TP
.I hdpi
the target horizontal DPI\[char46]
.TP
.I vdpi
the target vertical DPI\[char46]
.SH RETURN VALUE
Returns a valid 
.BR TTF_Font
, or NULL on error\[char46]

.SH AVAILABILITY
This function is available since SDL_ttf 3\[char46]0\[char46]0\[char46]

.SH SEE ALSO
.BR TTF_CloseFont (3)