XFD(1)                               BSD                                XFD(1)



NAME
     xfd - font displayer for X

SYNOPSIS
     xfd [-options ...] -fn fontname

OPTIONS
     -display display
             Specifies the display to use.

     -geometry geometry
             Specifies an initial window geometry.

     -bw number
             Allows you to specify the width of the window border in pixels.

     -rv     The foreground and background colors will be switched.  The
             default colors are black on white.

     -fw     Overrides a previous choice of reverse video.  The foreground and
             background colors will not be switched.

     -fg color
             On color displays, determines the foreground color (the color of
             the text).

     -bg color
             On color displays, determines the background color.

     -bd color
             On color displays, determines the color of the border.

     -bf fontname
             Specifies the font to be used for the messages at the bottom of
             the window.

     -tl title
             Specifies that the title of the displayed window should be title.

     -in iconname
             Specifies that the name of the icon should be iconname.

     -icon filename
             Specifies that the bitmap in file filename should be used for the
             icon.

     -verbose
             Specifies that extra information about the font should be
             displayed.

     -gray   Specifies that a gray background should be used.

     -start charnum
             Specifies that character number charnum should be the first
             character displayed.

DESCRIPTION
     Xfd creates a window in which the characters in the named font are
     displayed.  The characters are shown in increasing order from left to
     right, top to bottom.  The first character displayed at the top left will
     be character number 0 unless the -start option has been supplied in which

     case the character with the number given in the -start option will be
     used.

     The characters are displayed in a grid of boxes, each large enough to
     hold any single character in the font.  If the -gray option has been
     supplied, the characters will be displayed using XDrawImageString using
     the foreground and background colors on a gray background.  This permits
     determining exactly how XDrawImageString will draw any given character.
     If -gray has not been supplied, the characters will simply be drawn using
     the foreground color on the background color.

     All the characters in the font may not fit in the window at once.  To see
     additional characters, click the right mouse button on the window.  This
     will cause the next window full of characters to be displayed.  Clicking
     the left mouse button on the window will cause the previous window full
     of characters to be displayed.  Xfd will beep if an attempt is made to go
     back past the 0th character.

     Note that if the font is a 8 bit font, the characters 256-511 (100-1ff in
     hexidecimal), 512-767 (200-2ff in hexidecimal), ... will display exactly
     the same as the characters 0-255 (00-ff in hexidecimal).  Xfd by default
     creates a window big enough to display 16 rows of 16 columns (totally 256
     characters).

     Clicking the middle button on a character will cause that character's
     number to be displayed in both decimal and hexidecimal at the bottom of
     the window.  If verbose mode is selected, additional information about
     that particular character will be displayed as well.  The displayed
     information includes the width of the character, its left bearing, right
     bearing, ascent, and its descent.  If verbose mode is selected, typing
     '<' or '>' into the window will display the minimum or maximum values
     respectively taken on by each of these fields over the entire font.

     The font name is interpreted by the X server.  To obtain a list of all
     the fonts available, use xlsfonts(1).

     The window stays around until the xfd process is killed or one of 'q',
     'Q', ' ', or ctrl-c is typed into the Xfd window.

X DEFAULTS
     Xfd uses the following X resources:

     BorderWidth   Set the border width of the window.

     BorderColor   Set the border color of the window.

     ReverseVideo  If ``on'', reverse the definition of foreground and
                   background color.

     Foreground    Set the foreground color.

     Background    Set the background color.

     BodyFont      Set the font to be used in the body of the window.  (I.e.,
                   for messages, etc.) This is not the font that Xfd displays,
                   just the font it uses to display information about the font
                   being displayed.

     IconName      Set the name of the icon.

     IconBitmap    Set the file we should look in to get the bitmap for the
                   icon.

     Title         Set the title to be used.

SEE ALSO

     X(1), xlsfonts(1), xrdb(1)

BUGS
     It should display the name of the font somewhere.

     Character information displayed in verbose mode is sometimes clipped to
     the window boundary, hiding it from view.

     It should be rewritten to use the X toolkit.

     It should skip over pages full of non-existent characters.

COPYRIGHT
     Copyright 1988, Massachusetts Institute of Technology.
     See X(1) for a full statement of rights and permissions.

AUTHOR
     Mark Lillibridge, MIT Project Athena