Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

bdftopcf (1)

Name

bdftopcf - convert X font from Bitmap Distribution Format to Portable Compiled Format

Synopsis

bdftopcf [ -pn ] [ -un ] [ -m ] [ -l ] [ -M ] [ -L ] [ -t ] [ -i ] [ -o
outputfile ] fontfile.bdf

Description

BDFTOPCF(1)                 General Commands Manual                BDFTOPCF(1)



NAME
       bdftopcf  -  convert X font from Bitmap Distribution Format to Portable
       Compiled Format

SYNOPSIS
       bdftopcf [ -pn ] [ -un ] [ -m ] [ -l ] [ -M ] [ -L ] [ -t ] [ -i ] [ -o
       outputfile ] fontfile.bdf

DESCRIPTION
       Bdftopcf is a font compiler for the X server and font server.  Fonts in
       Portable Compiled Format can be read by any architecture, although  the
       file  is  structured  to allow one particular architecture to read them
       directly without reformatting.  This allows fast reading on the  appro-
       priate machine, but the files are still portable (but read more slowly)
       on other machines.

OPTIONS
       -pn     Sets the font glyph padding.  Each glyph in the font will  have
               each scanline padded in to a multiple of n bytes, where n is 1,
               2, 4 or 8.

       -un     Sets the font scanline unit.  When the font bit order  is  dif-
               ferent  from the font byte order, the scanline unit n describes
               what unit of data (in bytes) are to be swapped; the unit i  can
               be 1, 2 or 4 bytes.

       -m      Sets  the  font  bit order to MSB (most significant bit) first.
               Bits for each glyph will be placed in  this  order;  i.e.,  the
               left  most  bit on the screen will be in the highest valued bit
               in each unit.

       -l      Sets the font bit order to LSB (least significant  bit)  first.
               The  left  most  bit on the screen will be in the lowest valued
               bit in each unit.

       -M      Sets the font byte order to MSB first.  All multi-byte data  in
               the file (metrics, bitmaps and everything else) will be written
               most significant byte first.

       -L      Sets the font byte order to LSB first.  All multi-byte data  in
               the file (metrics, bitmaps and everything else) will be written
               least significant byte first.

       -t      When this option is specified, bdftopcf will convert fonts into
               "terminal" fonts when possible.  A terminal font has each glyph
               image padded to the same size; the X server can usually  render
               these types of fonts more quickly.

       -i      This  option  inhibits  the  normal computation of ink metrics.
               When a font has glyph images which do not fill the bitmap image
               (i.e.,  the  "on"  pixels don't extend to the edges of the met-
               rics) bdftopcf computes the actual ink metrics and places  them
               in the .pcf file; the -t option inhibits this behaviour.

       -o output-file-name
               By  default  bdftopcf  writes  the pcf file to standard output;
               this option gives the name of a file to be used instead.

       -v      Print version information and exit.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+--------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE   |
       +---------------+--------------------+
       |Availability   | x11/font-utilities |
       +---------------+--------------------+
       |Stability      | Volatile           |
       +---------------+--------------------+

SEE ALSO
       X(7)

AUTHOR
       Keith Packard, MIT X Consortium



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded   from    ['https://www.x.org/releases/individ-
       ual/app/mkfontscale-1.2.1.tar.bz2',   'https://www.x.org/releases/indi-
       vidual/app/bdftopcf-1.1.tar.bz2',  'https://www.x.org/releases/individ-
       ual/font/font-util-1.3.2.tar.bz2'].

       Further information about this software can be found on the open source
       community website at https://www.x.org.



X Version 11                     bdftopcf 1.1                      BDFTOPCF(1)