NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       fontconverter  [-merge]  [-w  width]  [-h  height]   [-udc
       udc_name] -font 'font_name' [-preload] preload_file

OPTIONS    [Toc]    [Back]

       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 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  specified
              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    [Toc]    [Back]

       Specifies the input UDC font file for which  PCF  and  BDF
       output formats are generated.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Contains fontconverter error messages.

SEE ALSO    [Toc]    [Back]

       Commands: cedit(1), cgen(1)



                                                fontconverter(1X)