TTF_GetGPUTextDrawData - Get the geometry data needed for drawing the text.
Contents
Availability
This function is available since SDL_ttf 3.0.0.
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.
Header File
Defined in SDL3_ttf/SDL_ttf.h
Name
TTF_GetGPUTextDrawData - Get the geometry data needed for drawing the text.
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.
See Also
•(3), TTF_CreateGPUTextEngine(3), •(3), TTF_CreateText(3) SDL_ttf SDL_ttf 3.2.2 TTF_GetGPUTextDrawData(3)
Synopsis
#include"SDL3_ttf/SDL_ttf.h"TTF_GPUAtlasDrawSequence*TTF_GetGPUTextDrawData(TTF_Text*text);
Thread Safety
This function should be called on the thread that created the text.
