TTF_SetFontLanguage(3)

TTF_SetFontLanguage3

Set language to be used for text shaping by a font.

Usage

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_SetFontLanguage(TTF_Font *font, const char *language_bcp47);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Overview

If SDL_ttf was not built with HarfBuzz support, this function returns false.

This updates any TTF_Text
objects using this font.

Function parameters

font

the font to specify a language for.

language_bcp47

a null-terminated string containing the desired language's BCP47 code. Or null to reset the value.

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.

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