unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



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

  -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 stan-
      dalone 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 appli-
  cations.

				     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 for-
       mat files.  The advantage of using the cgen command for a merge opera-
       tion 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)