xenial (1) otf2bdf.1.gz

Provided by: otf2bdf_3.1-3_amd64 bug

NAME

       otf2bdf - OpenType to BDF font converter

SYNOPSIS

       otf2bdf [options] font.{ttf,otf}

DESCRIPTION

       otf2bdf   will   convert   an   OpenType   font   to   a   BDF   font   using   the   Freetype2  renderer
       (http://www.freetype.org).

OPTIONS

       otf2bdf accepts the following command line arguments:

       -v      print warning messages when the font is converted.

       -n      disable glyph hinting.

       -p n    set the desired point size (see default value by running the program with the -h option).

       -et     display a list of the platforms and encodings available in the font. The default values, compiled
               into  the program, are a platform of 3 (Microsoft) and encoding of 1 (ISO10646). If the font does
               not contain the default platform and encoding, the fallback will be the Apple ISO10646 encoding.

       -r n    set both the horizontal and the vertical resolution (see default value  by  running  the  program
               with the -h option).  The minimum is 10dpi and the maximum is 1200dpi.

       -rh n   set the horizontal resolution (see default value by running the program with the -h option).  The
               minimum is 10dpi and the maximum is 1200dpi.

       -rv n   set the vertical resolution (see default value by running the program with the -h  option).   The
               minimum is 10dpi and the maximum is 1200dpi.

       -o outfile
               sets the output filename (default output is to stdout).

       -pid id set  the  platform  id  for selecting the character map (see default value by running the program
               with the -h option).

       -eid id set the encoding id for selecting the character map (see default value  by  running  the  program
               with the -h option).

       -c c    set the character spacing.  This should be one of `P' for proportional, `M' for monospace, or `C'
               for character cell.  By default, the spacing of a font will be  automatically  determined  to  be
               either `M' or `P' according to values provided in the font.

       -f name set the foundry name used in the XLFD name.  The default value is `Freetype'.

       -t name set the typeface name used in the XLFD name.  By default, otf2bdf will attempt to get a name from
               the font first and then it will use the name supplied with this command line option, and  if  all
               else fails, it will use the name `Unknown'.

       -w name set  the  weight name used in the XLFD name.  If this value is not supplied, the default value is
               assumed to be `Medium'.  Some common  values  for  this  are  `Thin',  `Delicate',  `ExtraLight',
               `Light',   `Normal',   `Medium',   `SemiCondensed',  `Condensed',  `SemiBold',  `Bold',  `Heavy',
               `ExtraBold', and `ExtraHeavy'.

       -s name set the slant name used in the XLFD name.  If this value is not supplied, the  default  value  is
               assumed to be `R', for Roman.  Some common values for this are `R' for Roman, `I' for Italic, `O'
               for Oblique, `RI' for Reverse Italic, and `RO' for Reverse Oblique.

       -k name set the width name used in the XLFD name.  The default is `Normal'.

       -d name set the additional style name used in the XLFD name.  The default is an empty string.

       -u char set the character used to replace the dashes/spaces in a font name.  The  default  is  the  space
               character.

       -l subset
               define  a  list of character codes which will be used to select a subset of glyphs from the font.
               The syntax of the subset string is the same as the syntax for selecting subsets in X11 XLFD  font
               names.  Example:

               % otf2bdf -l '60 70 80_90' font.ttf -o font.bdf

               The  command  above  will only generate the glyphs for codes 60, 70, and 80 through 90 inclusive.
               Glyphs that are not in the subset are not generated.

       -m mapfile
               specifies a mapping file which will reencode the BDF font when it is generated.  Any glyphs  with
               codes that do not have a mapping will not be generated.

               The  remapping  file  should begin with two lines, one which starts with REGISTRY followed by the
               character set registry and one which starts with ENCODING followed by the encoding.   An  example
               from the iso8859.2 file:

               REGISTRY ISO8859
               ENCODING 2

               The  remapping  data  should  be two columns of hexadecimal numbers, separated by spaces or tabs.
               The first column should have the code which should be used in the BDF font.   The  second  column
               should  be  the  hexadecimal  code of the glyph in the "cmap" table otf2bdf is using.  An example
               mapping file is provided which will  map  fonts  from  Unicode  (the  default  "cmap"  table)  to
               ISO8859-2.

               Unicode  is  not  the only option.  If you choose another platform and encoding ID on the command
               line, then the remapping is assumed to map from the chosen platform and encoding  to  some  other
               character set.

SEE ALSO

       gbdfed(1), xfed(1), bdftopcf(1), bdftosnf(1), bdfresize(1)
       Glyph Bitmap Distribution Format (BDF) Specification, Application Note 5005, Adobe System Inc, 1993
       X Logical Font Description Conventions, X Consortium

ACKNOWLEDGMENTS

       The FreeType project for providing the renderer!
       Robert  Wilhelm  <robert@physiol.med.tu-muenchen.de>  for pointing out a crucial problem with the pre-1.0
       code.
       Lho Li-Da <ollie@ms1.hinet.net> for problem reports.
       Adrian Havill <havill@threeweb.ad.jp> for unintentionally pointing out a missing feature.
       Richard Verhoeven <rcb5@win.tue.nl> for problem reports and patches.
       Choi Jun Ho <junker@jazz.snu.ac.kr> whose implementation provided some nice new features.
       Pavel Kankovsky <peak@kerberos.troja.mff.cuni.cz> for providing some critical  metrics  fixes  and  other
       improvements.
       Matti Koskinen <mjkoskin@sci.fi> for pointing out a problem.
       Eugene Bobin <gene@ftim.ustu.ru> for mapping tables.
       Oleg N. Yakovlev <yashka@optima.dnepropetrovsk.ua> for pointing out a problem.
       Bertrand Petit <elrond@phoe.frmug.org> for additional functionality.
       Roman Czyborra <czyborra@cs.tu-berlin.de> for pointing out some problems.
       Mike Blazer <blazer@mail.nevalink.ru> for some Window's compilation advice.
       Solofo Ramangalahy <solofo@mpi-sb.mpg.de> for contributing some mapping tables.
       Antoine Leca <Antoine.Leca@renault.fr> for mapping table suggestions.
       Patrick Hagglund <patrik.hagglund@bredband.net> for Freetype2 patches.
       Christos Tountas <cvt@sprynet.com> for finding problems.
       Nelson Beebe <beebe@math.utah.edu> for finding problems.
       "Prophet of the Way" <afu@wta.att.ne.jp> for finding a problem.

AUTHOR

       Mark Leisher
       Computing Research Lab
       New Mexico State University
       Email: mleisher@crl.nmsu.edu