TTF_SetTextColorFloat(3)

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

💖 TTF_SetTextColorFloat(3) 💖

okay bestie, welcome to the SDL_ttf3 FUNCTIONS corner of the manual, where we make text go pretty colors ✨ This one lives in TTF_SetTextColorFloat(3) and it's literally the glow-up button for your text objects.

🌸 NAME 🌸

TTF_SetTextColorFloat</p> — Set the color of a text object. 🎨

🎀 HEADER FILE 🎀

Defined in SDL3_ttf/SDL_ttf.h — yes bestie, that's the one you gotta #include. 🫶

✨ SYNOPSIS ✨

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_SetTextColorFloat(TTF_Text *text, float r, float g, float b, float a);

💅 DESCRIPTION 💅

so like. the default text color? it's white. no cap. out of the box your text is sitting there in (1.0f, 1.0f, 1.0f, 1.0f) and honestly that's giving clean minimal aesthetic, but if you wanna switch the vibe, this is the function. 🦋

🌈 FUNCTION PARAMETERS 🌈

  • text — the TTF_Text to modify. that's your main character right there 👑
  • r — the red color value, normally in the range of 0-1. 🔴
  • g — the green color value, normally in the range of 0-1. 🟢
  • b — the blue color value, normally in the range of 0-1. 🔵
  • a — the alpha value in the range of 0-1. transparency moment 🙈

⭐ RETURN VALUE ⭐

Returns true on success or false on failure — and if it fails, do NOT just sit there wondering bestie, call SDL_GetError() for more information. it will tell you what went wrong fr fr 😭

🧚 THREAD SAFETY 🧚

This function should be called on the thread that created the text. like, it's loyal to its creator. don't be calling it from some random other thread, that's not the vibe. 💀

🍓 AVAILABILITY 🍓

This function is available since SDL_ttf 3.0.0. so if you're on something older... yeah. upgrade time. 🔥

🦋 SEE ALSO 🦋

heads up bestie: the color values are normally in the range of 0-1 — that's what the manpage says, so that's what we're going with. don't come at me with 255 energy and expect me to vouch for it. 💖

and that's the whole page, periodt. 🌸 this lil slice of wisdom is brought to you by SDL_ttf version SDL_ttf 3.2.2 — mwah, go make something iconic with it 💅✨🫶

📦 where this page comes from