fontconverter(1X)														 fontconverter(1X)

NAME

       fontconverter - Converts user-defined characters (UDCs) into PCF format

SYNOPSIS

       fontconverter [-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 compo-
       nent, to which the fontconverter command automatically appends width and height specifiers 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 standalone 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  speci-
	      fied code.)

	      The reference_font parameter is specified using the format registry_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 format 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  standalone  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  registry  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)