fontconverter(1X)fontconverter(1X)NAMEfontconverter - Converts user-defined characters (UDCs) into PCF format
SYNOPSISfontconverter [-merge] [-w width] [-h height] [-udc udc_name] -font
'font_name' [-preload] preload_file
OPTIONS
Specifies that command output be merged with an existing PCF font file.
When the -merge option is specified, the command does not create a BDF
file. See also the entry for the -font option. Specifies the width of
the UDC font glyph. Use this option only when input fonts were created
with a width smaller than the one specified for the cedit font-editing
window. Specifies the height of the UDC font glyph. Use this option
only when input fonts were created with a height smaller than the one
specified for the cedit font-editing window. Specifies a non-default
registry name when the -merge option is not specified. The file names
for output files include base_name as the registry component, to which
the fontconverter command automatically appends width and height speci‐
fiers and the and file types. The default registry names for UDC fonts
vary according to language, as follows:
JISX.UDC, for Japanese
DEC.CNS.UDC, for Hanyu
GB.UDC, for Hanzi
When used with the -merge option, specifies the target font file
for the merge operation.
When used without the -merge option, specifies the font file
whose header is used as a reference for generating the header of
the standalone output file. Information in the reference font
file is also used to determine default characters in the stand‐
alone output file. (A default character is a glyph, usually a
square, that is displayed when the font file does not contain a
glyph for a specified code.)
The reference_font parameter is specified using the format reg‐
istry_width_height, for example:
-font 'JISX.UDC_*' Specifies the file name of the input UDC file
in a nondefault position on the command line. Include the
-preload option only when specifying the preload_file parameter
at a command line position other than last.
OPERANDS
Specifies the input UDC font file for which PCF and BDF output formats
are generated.
DESCRIPTION
The fontconverter command creates PCF format font files for user-
defined characters (UDCs) that are created by the font editor of the
cedit utility. The PCF format font files allow UDCs to be displayed by
X and Motif applications.
Note
You can also use the cgen command to create standalone PCF and BDF for‐
mat font files and to merge font information into existing PCF format
files. The advantage of using the cgen command for a merge operation
is that you do not have to use the mkfontdir and xset commands to make
information in the merged PCF file available to applications.
EXAMPLES
The following example merges the UDC file, udc_font.pre, into the
-*-140-*jisx0208* font. The generated output file is named
jisx0208-kanji11_14_14.pcf: % fontconverter-merge-font
'*-140-*jisx0208*' udc_font.pre The following example creates stand‐
alone font files in both PCF and BDF formats. The output files contain
the converted result from udc_font.pre plus the default character and
header information from font *-140-*jisx0208* but have the charset reg‐
istry name deckanji.udc: %fontconverter -udc deckanji.udc \ -font
'*-140-*jisx0208*' udc_font.pre
FILES
Contains fontconverter error messages.
SEE ALSO
Commands: cedit(1), cgen(1)fontconverter(1X)