Index Index for
Section 1X
Index Alphabetical
listing for F
Bottom of page Bottom of
page		 

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

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

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

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

  -udc base_name
      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 specifiers and the .pcf and .bdf 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

  -font `reference_font'
      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 specified code.)

      The reference_font parameter is specified using the format
      registry_width_height, for example:

	   -font 'JISX.UDC_*'

  -preload preload_file
      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

  preload_file
      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

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

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

  /usr/lib/X11/app-defaults/Fontconverter
      Contains fontconverter error messages.


SEE ALSO

  Commands: cedit(1), cgen(1)

Index Index for
Section 1X
Index Alphabetical
listing for F
Top of page Top of
page