---
name: "TTF_GetStringSizeWrapped"
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_GetStringSizeWrapped"
---

# TTF\_GetStringSizeWrapped(3)

Calculate the dimensions of a rendered string of UTF-8 text.

## NAME

TTF\_GetStringSizeWrapped - Calculate the dimensions of a rendered string of UTF-8 text.

## HEADER FILE

Defined in SDL3\_ttf/SDL\_ttf.h

## SYNOPSIS

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

**bool TTF\_GetStringSizeWrapped(TTF\_Font \*font, const char \*text, size\_t length, int wrap\_width, int \*w, int \*h);**

## DESCRIPTION

This will report the width and height, in pixels, of the space that the specified string will take to fully render.

Text is wrapped to multiple lines on line endings and on word boundaries if it extends beyond **wrap\_width** in pixels.

If wrap\_width is 0, this function will only wrap on newline characters.

## FUNCTION PARAMETERS

- *font*

  the font to query.

- *text*

  text to calculate, in UTF-8 encoding.

- *length*

  the length of the text, in bytes, or 0 for null terminated text.

- *wrap\_width*

  the maximum width or 0 to wrap on newline characters.

- *w*

  will be filled with width, in pixels, on return.

- *h*

  will be filled with height, in pixels, on return.

## RETURN VALUE

Returns true on success or false on failure; call SDL\_GetError() for more information.

## THREAD SAFETY

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

## AVAILABILITY

This function is available since SDL\_ttf 3.0.0.