TTF_RenderGlyph_Solid(3)

TTF_RenderGlyph_Solid3

Render a single 32-bit glyph at fast quality to a new 8-bit surface.

Usage

#include "SDL3_ttf/SDL_ttf.h"

SDL_Surface * TTF_RenderGlyph_Solid(TTF_Font *font, Uint32 ch, SDL_Color fg);

Header file

Defined in SDL3_ttf/SDL_ttf.h

Overview

This function will allocate a new 8-bit, palettized surface. The surface's 0 pixel will be the colorkey, giving a transparent background. The 1 pixel will be set to the text color.

The glyph is rendered without any padding or centering in the X direction, and aligned normally in the Y direction.

You can render at other quality levels with

TTF_RenderGlyph_Shaded ,

TTF_RenderGlyph_Blended , and

TTF_RenderGlyph_LCD .

Function parameters

font

the font to render with.

ch

the character to render.

fg

the foreground color for the text.

Return value

Returns a new 8-bit, palettized surface, or NULL if there was an error.

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.