---
name: "TTF_SetTextFont"
section: "3"
platform: "linux"
package: "libsdl3-ttf-doc"
version: "3.2.2+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/TTF_SetTextFont"
---

# TTF\_SetTextFont(3)

Set the font used by a text object.

## NAME

TTF\_SetTextFont - Set the font used by a text object.

## HEADER FILE

Defined in SDL3\_ttf/SDL\_ttf.h

## SYNOPSIS

```
#include "SDL3_ttf/SDL_ttf.h"
```

**bool TTF\_SetTextFont(TTF\_Text \*text, TTF\_Font \*font);**

## DESCRIPTION

When a text object has a font, any changes to the font will automatically regenerate the text. If you set the font to NULL, the text will continue to render but changes to the font will no longer affect the text.

This function may cause the internal text representation to be rebuilt.

## FUNCTION PARAMETERS

- *text*

  the  **TTF\_Text**\
    to modify.

- *font*

  the font to use, may be NULL.

## RETURN VALUE

Returns false if the text pointer is null; otherwise, true. call SDL\_GetError() for more information.

## THREAD SAFETY

This function should be called on the thread that created the text.

## AVAILABILITY

This function is available since SDL\_ttf 3.0.0.

## SEE ALSO

**•**(3), [**TTF\_GetTextFont**(3)](/TTF_GetTextFont/3.md)