XGLYPH(1)

👑 XGLYPH — the manual page, but make it cute ✨

okay so bestie, welcome to xglyph(1), from the General Commands Manual section. yeah, section one. she's a little demo program and she's iconic for it. let's get into it 💅

---

🌸 NAME 🌸

xglyph — a demonstration program for the t1lib font rasterizer library. that's it, that's the whole name section, she's modest 🎀

---

✨ SYNOPSIS ✨

xglyph [ fontfile... ]

look at her. simple. elegant. she eats 💖

---

💖 DESCRIPTION 💖

okay so real talk: this manual page documents briefly the xglyph program. and here's the lore — this page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. so Debian said "fine, i'll do it myself" and honestly? slay 🫶

xglyph is a program which demonstrates the capabilities of the t1lib library. it lets you view an arbitrary character or string rendered in the various ways possible with the library. and by default — not me forgetting to mention this — it writes a log file named t1lib.log in the current directory. so yes, a little log file just appears. that's her. that's the vibe ✨

if you invoke it with no arguments, it will attempt to read the global configuration file and font database. she's self-sufficient like that, main character energy fr fr.

but ALSO: it will accept any number of filenames on the command line, and in that case those are treated as font files to be loaded instead of the default font database. so you're either like "do your default thing babe" or you hand her your own fonts directly. no in-between, pick a lane 💅

---

🎀 OPTIONS 🎀

here we go, the full lineup, no skips, no skimming, we respect every single one of these:

• --help — shows a brief help text. quick lil hello.
• --Help — shows a description of all options. yeah, capital H, she's different, she's thorough 👑
• --noGrid — don't draw grid lines when displaying glyphs. no grid, just vibes 🌈
• --setPad — set bitmap padding. give her some breathing room.
• --logError — log errors only.
• --logWarning — log errors and warnings.
• --logStatistic — log errors, warnings, and statistics.
• --logDebug — log just about everything. she's telling you EVERYTHING, bestie 😭
• --ignoreForceBold — don't make pseudo-boldface glyphs. fake bold? not today 💀
• --ignoreFamilyAlignment — the original page gives no description here, she just stands there looking mysterious 🧚
• --ignoreHinting — ignore hints when scaling glyphs.
• --debugLine — show debugging info for line-drawing operations in the rasterizer.
• --debugRegion — show debugging info for region operations in the rasterizer.
• --debugPath — show debugging info for path operations in the rasterizer.
• --debugFont — again, no description in the original. mystery icon behavior, iykyk 🙈
• --debugHint — show debugging info for hinting in the rasterizer.
• --checkPerformance — do some simple performance tests while rasterizing. she's benchmarking, she's doing cardio 🏃‍♀️
• --checkCopyFont — check that copying fonts works.
• --checkConcatGlyphs — check that concatenating glyphs works.
• --checkBadCharHandling — no description given, she's just here, existing, serving 🍓
• --checkDefaultEncoding — set a default encoding vector.

ngl bestie, a few of these came with absolutely no explanation in the original page, and i'm not about to invent one for you. i would never. that's not the move 💜

---

🦋 ENVIRONMENT 🦋

in the Debian GNU/Linux version of this program, the environment variable T1LIB_CONFIG, if set, points to an alternate configuration file with which to initialize the library. so if you want her to read a different config, that's the little knob you turn ✨

---

⭐ SEE ALSO ⭐

• FontDataBase(5)
• t1libconfig(8)

and ALSO, because she's lowkey an overachiever: xglyph is much more fully documented in the LaTeX documentation that accompanies the upstream t1lib distribution. that documentation is installed in PostScript and source formats with the t1lib-dev package in /usr/share/doc/t1lib-dev, and it's also accessible through the dwww system. so many ways to learn her lore, obsessed 📚💖

---

🌸 AUTHOR 🌸

this manual page was written by David Huggins-Daines <dhd@debian.org>, for the Debian GNU/Linux system (but may be used by others). shoutout to David, real one, thank you for your service 🫶

---

and that's the whole page bestie!! 💅✨ she lives in the General Commands Manual as xglyph(1) and she signs off as XGLYPH(1) at the bottom, like a little autograph 🎀 go render some glyphs, you got this 🦋💖