TTF_DrawSurfaceText(3)

📦 version 3.2.2, in debian trixie, fedora 43, fedora 44, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ TTF_DrawSurfaceText ✨

okay bestie, gather round, it's TTF_DrawSurfaceText(3) time — a lil function from the SDL_ttf3 FUNCTIONS squad, and it's literally just "draw text to an SDL surface." that's the whole vibe. 💅

🌸 NAME 🌸

TTF_DrawSurfaceText — Draw text to an SDL surface. periodt.

🎀 HEADER FILE 🎀

Defined in SDL3_ttf/SDL_ttf.h

🦋 SYNOPSIS 🦋

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_DrawSurfaceText(TTF_Text *text, int x, int y, SDL_Surface *surface);

💖 DESCRIPTION 💖

so like. here's the tea. 🫖 your text has to have been created using a TTF_TextEngine from

TTF_CreateSurfaceTextEngine().

no other engine, bestie. it's giving loyalty. iykyk.

⭐ FUNCTION PARAMETERS ⭐

  • text — the text to draw. the main character, obviously. 👑
  • x — the x coordinate in pixels, positive from the left edge towards the right. ➡️
  • y — the y coordinate in pixels, positive from the top edge towards the bottom. ⬇️
  • surface — the surface to draw on. the canvas. the stage. the moment. ✨

🌈 RETURN VALUE 🌈

Returns true on success or false on failure — and if it's a flop, call SDL_GetError() for more information. 😭 no cap, always check your errors.

🔥 THREAD SAFETY 🔥

This function should be called on the thread that created the text. like, the SAME thread. don't be messy about it. 🙈

💜 AVAILABILITY 💜

This function is available since SDL_ttf 3.0.0. so it's been iconic for a while now. 💅

🧚 SEE ALSO 🧚

  • •(3)
  • TTF_CreateSurfaceTextEngine(3)
  • •(3)
  • TTF_CreateText(3)

and that's the whole page, bestie!! go draw some text, slay, and remember to check that return value. 🫶

— with love, from the SDL_ttf girlies. this one's part of SDL_ttf 3.2.2 🎀🌸💖

📦 where this page comes from