TTF2PT1_X2GS(1)

✨ TTF2PT1_X2GS ✨ — like, the ttf2pt1_x2gs manual, bestie 💖

okay so this is the page for ttf2pt1_x2gs, part of the TTF2PT1 Font Converter squad, and it's literally the font installer for Ghostscript. no cap. 🎀

---

🌸 NAME 🌸

ttf2pt1_x2gs — the font installer for Ghostscript 🫶

---

⭐ SYNOPSIS ⭐

ttf2pt1_x2gs [config-file]

---

💅 DESCRIPTION 💅

okay so here's the tea ☕: the fonts you generate with ttf2pt1 work fine with Ghostscript all by themselves, like they don't need anything. but the ttf2pt1_x2gs script is the main character that links the font files from the X11 directory into the Ghostscript directory and automatically creates the description file (Fontmap) in Ghostscript format. slay. ✨

if you don't specify the config file as an argument, then the file convert.cfg in the current directory gets used, exactly like the convert script does. and yes bestie, that same config file is shared by both scripts. one config, two icons. 👑

here are the Ghostscript-related parameters you'll find in the config file:

• DSTDIR — the X11 font directory that ttf2pt1_x2gs uses as the source of the fonts. this one is shared with the X11 configuration, iykyk.
• GSDIR — the base directory of Ghostscript. if you set this parameter to an empty string, then ttf2pt1_convert won't call x2gs at all. so if all you want is the X11 fonts installed, set this to an empty string and you're done. 💅 this directory can be different on different systems, so please go check your system and set this value accordingly before running the script.
• GSFONTDIR — the font directory of Ghostscript. in a standard Ghostscript installation it's a subdirectory of GSDIR, but some systems out here being different and may use completely different directories. 🙈
• GSCONFDIR — the configuration subdirectory of Ghostscript that contains the Fontmap file.
• INSTALLFONTMAP — if this value is set to YES, then the entries for the new fonts get installed right into the main Fontmap file. otherwise it just leaves the file Fontmap.ttf sitting in the Ghostscript configuration directory. simple as that.

once you've prepped the config file, run the script. it symbolically links all the font files and creates the description file Fontmap.ttf in GSCONDFIR. and after that, bestie, you have two choices. 🌈

1. if the option INSTALLFONTMAP was set to YES, then the font descriptions are also automatically installed into the master Fontmap file. and the script is clever enough to detect if it was run multiple times with the same directories — and if so, it replaces the old Fontmap entries with the new ones instead of just accumulating all of them. iconic behavior fr fr. 🔥 you may also run it multiple times for multiple X11 directories and all the results will be properly collected in the Fontmap. but it's your responsibility to watch that the names of the font files don't overlap. 👀 and if the X11 font directory gets renamed, then you have to remove its font entries from the Fontmap and only after that re-run ttf2pt1_x2gs for the new directory. order matters, don't skip steps.
2. on the other hand, if the option INSTALLFONTMAP was set to NO, then go to the GSCONFDIR directory and insert the contents of Fontmap.ttf into the Fontmap file manually. this step may be left manual to make the installation a little bit more safe. 🧚

after that you may also want to redefine some of the aliases in Fontmap so they refer to the newly installed fonts.

⚠️ but the redefinition of the aliases may be dangerous if the width of characters in the new font will be different from the old font. and alas, there is no visible solution of this problem yet. 😭 so like... be careful, bestie.

---

🎀 FILES 🎀

• /usr/share/doc/ttf2pt1-3.4.4/convert.cfg.sample
• /usr/share/ttf2pt1/scripts/*
• /usr/share/doc/ttf2pt1-3.4.4/README
• /usr/share/doc/ttf2pt1-3.4.4/FONTS
• /usr/share/ttf2pt1/*
• /usr/bin/ttf2pt1

---

🦋 SEE ALSO 🦋

• ttf2pt1(1)
• ttf2pt1_convert(1)
• t1asm(1)

---

and that's the whole page, periodt. 💜 this was version 3.4.4, dated December 31, 2003 — yeah she's an elder but she still ate. 🍓 mwah, go install some fonts bestie 💖✨