TTF_SetTextColor(3)

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

💖 TTF_SetTextColor(3) 💖

okay bestie, welcome to the SDL_ttf3 FUNCTIONS corner of the group chat, where we make text go from "meh, white" to "main character in every colour" 💅✨

🎀 NAME 🎀

TTF_SetTextColor</p> — set the color of a text object. literally that. that's the whole job. and she does it beautifully. 🌈

📁 HEADER FILE 📁

Defined in SDL3_ttf/SDL_ttf.h — go get your include, bestie, she's right there 🫶

✨ SYNOPSIS ✨

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_SetTextColor(TTF_Text *text, Uint8 r, Uint8 g, Uint8 b, Uint8 a);

four little numbers and a dream, no cap 🌸

💅 DESCRIPTION 💅

so here's the tea: the default text color is white (255, 255, 255, 255). which is fine, she's a classic, she ate. but if you want your text to be giving something more? that's what this function is for, bestie. red, green, blue, and alpha, all in one go. 🎨

🌸 FUNCTION PARAMETERS 🌸

  • text — the TTF_Text to modify. your text object. the one you're about to glow up. 💖
  • r — the red color value in the range of 0-255. 🔴
  • g — the green color value in the range of 0-255. 🟢
  • b — the blue color value in the range of 0-255. 🔵
  • a — the alpha value in the range of 0-255. 👻 (that's the transparency vibe check, iykyk)

👑 RETURN VALUE 👑

Returns true on success or false on failure. and if she says false? not me crying. 😭 call SDL_GetError() for more information — she will tell you what went wrong, fr fr.

🧵 THREAD SAFETY 🧵

This function should be called on the thread that created the text. periodt. don't be out here calling her from some random thread, that's not the vibe 🚫

⭐ AVAILABILITY ⭐

This function is available since SDL_ttf 3.0.0. she's been iconic since day one, no notes 💜

🔥 SEE ALSO 🔥

(yes, the bullets are real, yes they're just like that, we don't ask questions, we love her anyway 🦋)

and that's the whole page, bestie!! 🫶 this lil slice of SDL_ttf is brought to you by SDL_ttf 3.2.2, straight from the SDL_ttf crew — go set some colors, you absolute icon ✨💖🎀🌈💅

📦 where this page comes from