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

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

## Header File

Defined in [<SDL3_ttf/SDL_ttf.h>](https://github.com/libsdl-org/SDL_ttf/blob/main/include/SDL3_ttf/SDL_ttf.h)

## Syntax

```c
TTF_Font * TTF_OpenFontIndexDPIIO(SDL_IOStream *src, bool closeio, int ptsize, long index, unsigned int hdpi, unsigned int vdpi);
```

## Function Parameters

|                |             |                                                                      |
| -------------- | ----------- | -------------------------------------------------------------------- |
| SDL_IOStream * | **src**     | an SDL_IOStream to provide a font file's data.                       |
| bool           | **closeio** | true to close `src` when the font is closed, false to leave it open. |
| int            | **ptsize**  | point size to use for the newly-opened font.                         |
| long           | **index**   | index of the face in the font file.                                  |
| unsigned int   | **hdpi**    | the target horizontal DPI.                                           |
| unsigned int   | **vdpi**    | the target vertical DPI.                                             |

## Return Value

([TTF_Font](TTF_Font) *) Returns a valid [TTF_Font](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 `closeio` is 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](TTF_Font), use
[TTF_CloseFont](TTF_CloseFont)() to dispose of it.

## Version

This function is available since SDL_ttf 3.0.0.

## See Also

- [TTF_CloseFont](TTF_CloseFont)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction)