TTF_GetGlyphKerning(3)

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

💖 TTF_GetGlyphKerning 💖

okay bestie, so this one lives in the SDL_ttf3 manual — it's a <pink>SDL_ttf</pink> function page, and it's literally the tool that tells you how much two glyphs wanna snuggle together. Let's get into it. 🫶

✨ NAME ✨

TTF_GetGlyphKerning — Query the kerning size between the glyphs of two UNICODE codepoints.

that's it. that's the whole vibe. two codepoints walk in, one number walks out. 💅

📁 HEADER FILE 📁

Defined in SDL3_ttf/SDL_ttf.h

🎀 SYNOPSIS 🎀

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_GetGlyphKerning(TTF_Font *font, Uint32 previous_ch, Uint32 ch, int *kerning);

🌸 FUNCTION PARAMETERS 🌸

  • font — the font you're querying. the main character. 👑
  • previous_ch — the previous codepoint, aka the one that came before. the before bestie.
  • ch — the current codepoint. the now bestie.
  • kerning — a pointer that gets filled in with the kerning size between the two glyphs, in pixels. and yeah, it may be NULL — no pressure, no stress, she can just vibe and hand you nothing back if you don't need the number. 🙈

⭐ RETURN VALUE ⭐

Returns true on success or false on failure. and if it's giving failure, call SDL_GetError() for more information — that's your group chat for the deets on what went wrong. 😭

🧵 THREAD SAFETY 🧵

This function should be called on the thread that created the font.

no cap, this one's not thread-hoppable — keep it on the font's home thread or she will simply not respect you. 💀

🌈 AVAILABILITY 🌈

This function is available since SDL_ttf 3.0.0. so if you're on something older than that... bestie, we gotta talk. ✨

and that's the page!! 🦋 this whole thing shipped out with SDL_ttf 3.2.2 under the <purple>SDL_ttf</purple> name — TTF_GetGlyphKerning(3) — so if you ever need to cite her, that's the signature. mwah, go kern something gorgeous. 💖🎀

📦 where this page comes from