system_defaultfont(3)

✨ system_defaultfont(3) ✨

okay bestie, this one's called system_defaultfont — it sets (or replaces) the current default font 💅 and it lives in the Arcan Lua API, so yeah, we're doing graphics-adjacent things today 🎀

---

🌸 NAME 🌸

system_defaultfont — set / replace the current default font, periodt 💖

---

🦋 SYNOPSIS 🦋

boolres, height, baseline,
system_defaultfont( fontres, fontsz, fonth, fallback )

ok so it returns three things — boolres, height, and baseline — and takes up to four args. slay ✨

---

💜 DESCRIPTION 💜

so here's the vibe: all the text rendering functions need some kind of font to actually, y'know, render text 😭 you can set that default font in two ways, bestie:

1. call this function directly, or
2. get it set indirectly — through the first render_text call that passes an explicit font 👑

here's the arg breakdown, no cap:

• fontres — a string reference to a valid file inside the SYS_FONT_RESOURCE namespace 📁
• fontsz — the size argument, exactly as it's used in render_text 📏
• fonth — specifies the anti-aliasing strength (0: disabled, 1: light, ...) ✨

and highkey the fun part: you can also specify an additional fallback font 🫶 it covers any missing glyphs that aren't found in fontres. the tradeoff? the downside is that those fallback glyphs might not visually blend with the primary ones in a visually appealing way 🙈 but honestly it may still be better than invisible characters 💀 so like... take the win, i guess?

---

⭐ NOTES ⭐

1. this is also implicitly updated in LWA arcan builds if it receives a FONTHINT event from the display server connection 👀 and here's the catch — there is no event-trigger to detect if that occurs 😭 so you just have to vibe with it, fr fr.

---

🔥 EXAMPLE 🔥

here's the whole thing in action, copy it exactly bestie:

function system_defaultfont0()
      system_defaultfont("default.ttf", 12, 0);
end

look at her go 🧚 font "default.ttf", size 12, anti-aliasing 0. iconic. 👑

---

🌈 SEE ALSO 🌈

system — go peek at her too, iykyk 🌸

---

friendly reminder that fonth goes from 0 (disabled) and 1 (light) onward, and that fallback glyphs may not blend cute with your primary font — but invisible characters are worse, so 💅

---

this lil page came to you courtesy of the Arcan Lua API, dated October 2026 🎀 and it's system_defaultfont(3) — mwah, go render something pretty bestie 💖🦋✨