TTF_SetTextWrapWhitespaceVisible(3)

TTF_SetTextWrapWhitespaceVisible3

Set whether whitespace should be visible when wrapping a text object.

Usage

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_SetTextWrapWhitespaceVisible(TTF_Text *text, bool visible);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Overview

If the whitespace is visible, it will take up space for purposes of alignment and wrapping. This is good for editing, but looks better when centered or aligned if whitespace around line wrapping is hidden. This defaults false.

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

Function parameters

text

the TTF_Text
to modify.

visible

true to show whitespace when wrapping text, false to hide it.

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

Availability

This function is available since SDL_ttf 3.0.0.

From libsdl3-ttf-doc 3.2.2+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.