TTF_GetGPUTextDrawData - Man Page

Get the geometry data needed for drawing the text.

Header File

Defined in SDL3_ttf/SDL_ttf.h

Synopsis

#include "SDL3_ttf/SDL_ttf.h"

TTF_GPUAtlasDrawSequence * TTF_GetGPUTextDrawData(TTF_Text *text);

Description

text must have been created using a TTF_TextEngine
from

TTF_CreateGPUTextEngine ().

The positive X-axis is taken towards the right and the positive Y-axis is taken upwards for both the vertex and the texture coordinates, i.e, it follows the same convention used by the SDL_GPU API. If you want to use a different coordinate system you will need to transform the vertices yourself.

If the text looks blocky use linear filtering.

Function Parameters

text

the text to draw.

Return Value

( TTF_GPUAtlasDrawSequence
*) Returns a NULL terminated linked list of

TTF_GPUAtlasDrawSequence
objects or NULL if the passed text is empty or in case of 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.

See Also

·(3), TTF_CreateGPUTextEngine(3), ·(3), TTF_CreateText(3)

Referenced By

TTF_CreateGPUTextEngine(3), TTF_CreateGPUTextEngineWithProperties(3), TTF_GPUAtlasDrawSequence.3type(3).

SDL_ttf 3.2.2 SDL_ttf3 FUNCTIONS