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

TTF_CopyFont

Create a copy of an existing font.

Header File

Defined in <SDL3_ttf/SDL_ttf.h>

Syntax

TTF_Font * TTF_CopyFont(TTF_Font *existing_font);

Function Parameters

TTF_Font *

existing_font

the font to copy.

Return Value

(TTF_Font *) Returns a valid TTF_Font, or NULL on failure; call SDL_GetError() for more information.

Remarks

The copy will be distinct from the original, but will share the font file and have the same size and style as the original.

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

Thread Safety

This function should be called on the thread that created the original font.

Version

This function is available since SDL_ttf 3.0.0.

See Also

• TTF_CloseFont

---

CategoryAPI, CategoryAPIFunction, CategorySDLTTF

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