NAME

dtudcexch — UDC data exchange utility

SYNOPSIS

dtudcexch

DESCRIPTION

The dtudcexch utility is a tool for exchanging User Defined Character (UDC) glyph images between systems. It runs only in GUI mode.

dtudcexch provides the system administrator with a mechanism for distributing UDC glyph images among different systems. Specifically, it allows UDC glyph images to 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 is transported to a target system. On the taregt 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 that are 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.

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 imagees 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.

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.
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.