DTUDCEXCH(1)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💖 NAME 💖

okay so bestie, meet dtudcexch(user cmd) — the UDC data exchange utility. It’s the tool for moving User Defined Character (UDC) glyph images between systems, and it is literally GUI mode only. no terminal-only era here 💅✨

✨ SYNOPSIS ✨

dtudcexch

🦋 DESCRIPTION 🦋

dtudcexch is the tool for exchanging UDC glyph images between systems, and yes it runs only in GUI mode. 🫶

It gives the system administrator a whole mechanism for distributing UDC glyph images among different systems. Specifically, it lets UDC glyph images be created on one system using the UDC Font Editor (dtudcfonted) and then propagated to other systems. dtudcexch stores the UDC glyph images in a BDF (Bitmap Distribution Format) file, which gets transported to a target system. On the target system, dtudcexch is run again — this time to extract the images from the BDF file and add them to the appropriate font file. 🎀

dtudcexch provides both an export and an import function. The export function reads the selected UDC glyph images from a font file and stores them in a BDF file for transfer to other systems. The import function reads all UDC glyph images in a BDF file and adds them to a specified font file. 🔥

dtudcexch searches font files in the directories specified on the X server’s font path or in the DTUDCFONTPATH environment variable. It accepts only UDC fonts that are available in the current locale and that are defined in the X NLS database. 👑

When exporting, dtudcexch uses glyph indexes of the UDC code area in the PCF/SNF font file to select the UDC glyph images. It stores the converted images in the BDF-format file at the same glyph indexes. When importing, dtudcexch adds the UDC glyph images to the PCF/SNF font file at the same glyph indexes found in the BDF file. The UDC code area information is defined in the X NLS database. 🦋

To create different glyph indexes for the images on the target system, you can edit the BDF file before you invoke the import function. periodt. 💜

🌟 Starting the Exchange Utility 🌟

Start the Exchange Utility by entering the dtudcexch command. The Starting window appears.

💫 Exporting UDCs 💫

To export UDCs:

  1. Select the export function button on the Starting window. The Font Selection window appears. (This window is the same as the Font Selection window in the Font Editor. For a description of the available operations on this window, see dtudcfonted(1).)
  2. Select a font on the Font Selection window and click Open. The UDC Glyph Indexes Selection window appears. This window lists all the glyph indexes for all the UDC glyph images contained in the selected font.
  3. Select one or more glyph indexes on the window. (To select multiple glyph indexes, use the Ctrl or Shift key as usual.) Then click OK. The BDF File Selection window appears.
  4. Specify a file name on the BDF File Selection window and click OK. dtudcexch creates the file and stores the glyph images of the selected glyph indexes in the file in BDF format. dtudcexch then terminates.

🎀 Importing UDCs 🎀

To import UDCs:

  1. Select the import function button on the Starting window. The BDF File Selection window appears.
  2. Specify the name of the BDF file that contains the UDC glyph images to be imported and click OK. The Font Selection window appears.
  3. Select an XLFD (X Logical Font Description) font file and click Open. dtudcexch adds all glyph images in the BDF file to the selected font. dtudcexch then terminates.

🔥 EXIT STATUS 🔥

  • 0 — dtudcexch terminated successfully. 💖
  • >1 — an error occurred. 😭

🌈 ENVIRONMENT VARIABLES 🌈

dtudcexch references the DTUDCFONTPATH variable, which is a colon-separated list of directories to search when looking for UDC font files.

🍓 RESOURCES 🍓

None. literally none, bestie 🫶

🧚 ACTIONS/MESSAGES 🧚

None.

💀 ERRORS/WARNINGS 💀

  • Failed to open the selected font. You have no right to access the font file, or the format of the file is not consistent." 10 — an error occurred when attempting to open the PCF/SNF font file.
  • Failed to open BDF-font-file. ou have no right to access the file, or the format of the file is not consistent." 10 — an error occurred when attempting to open the BDF font file. (yes, ou is in the manual; not me, bestie 😭)
  • Glyph images in this BDF file can't be added to the font." 10 — an error occurred when attempting to save the PCF/SNF font file.
  • There are one or more glyph images being overwritten. Overwrite?" 10 — one or more glyph images in the PCF/SNF font file will be replaced by glyph images from the BDF file.

🫶 FILES 🫶

None.

⭐ EXAMPLES ⭐

None.

👑 SEE ALSO 👑

dtudcfonted(1)

later, bestie — this has been dtudcexch(user cmd), with no version/date footer energy, just that title and a whole lot of UDC. stay hydrated and GUI-only 💖🎀✨

📦 where this page comes from