TTF_FontIsFixedWidth(3)

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

💖 TTF_FontIsFixedWidth(3) 💖

okay bestie, welcome to the SDL_ttf3 FUNCTIONS corner of the manual, where we answer the age-old question: is this font giving grid, or is it giving chaos? ✨

🌸 NAME 🌸

TTF_FontIsFixedWidth — the lil function that queries whether a font is fixed-width. 🎀

📁 HEADER FILE 📁

Defined in SDL3_ttf/SDL_ttf.h. she lives there. that's her home. 🏠

✨ SYNOPSIS ✨

#include "SDL3_ttf/SDL_ttf.h"

bool TTF_FontIsFixedWidth(const TTF_Font *font);

look at her. one parameter. returns a bool. no notes. 👑

💅 DESCRIPTION 💅

so like, a "fixed-width" font means all glyphs are the same width across. every single one. no cap. a lowercase 'i' will be the same size across as a capital 'W', for example. like, the i is out here taking up the exact same amount of horizontal real estate as the W. iconic behaviour honestly. 🌈

this is common for terminals and text editors, and other apps that treat text as a grid. it's giving spreadsheet. it's giving "everything lines up perfectly." 📐

most other things (WYSIWYG word processors, web pages, etc) are more likely to not be fixed-width in most cases. those are the proportional girlies. they do their own thing. 🦋

🫶 FUNCTION PARAMETERS 🫶

  • font — the font to query. that's it. that's the whole vibe check. you hand her a font, she tells you the truth. 💜

⭐ RETURN VALUE ⭐

Returns true if the font is fixed-width, false otherwise. yes ma'am, binary. no maybe. no "it depends." she said periodt. 💅

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread. literally any of them. go wild. call it from all of them at once, she does not care, she is unbothered, she is moisturised, she is in her lane. 🔥

👑 AVAILABILITY 👑

This function is available since SDL_ttf 3.0.0. so if you're on something older... bestie. update. 😭

ok real talk though — this is a query function, it does not mutate anything, it does not allocate, it just tells you a fact about a font. use it to decide whether you can do cute grid math or whether you gotta measure every string like a peasant. iykyk. 🙈

mwah 💋 sending u off with love from the SDL_ttf manual, version 3.2.2, brought to you by the SDL_ttf girlies. go forth and align ur text. 🍓✨💖

📦 where this page comes from