xfd(1X)                                                   xfd(1X)



NAME
     xfd - displays the glyphs of a font

SYNOPSIS
     xfd [toolkit-option]...  [option]...

DESCRIPTION
     xfd displays all the glyphs of a font. When you run xfd, it
     creates a window containing the name of the font being
     displayed, a row of buttons you can click, several lines of
     text for displaying character metrics, and a grid containing
     one glyph per cell.

   Options
     The xfd command accepts all the standard X Toolkit command-
     line options, as described in X(1X), as well as these op-
     tions:

     -bc color
             Specifies the color to be used if the -box option is
             specified.

     -box    Draws a box around each glyph to indicate the area
             that would be filled with background color by an Im-
             ageText request.

     -center Indicates that each glyph should be centered in its
             cell.

     -column columns
             Specifies the number of columns in the grid.

     -fn font
             Specifies the font to be displayed.

     -rows rows
             Specifies the number of rows in the grid.

     -start number
             Specifies the glyph index of the upper-left corner
             of the grid.  This is used to view characters at ar-
             bitrary locations in the font.  The default is 0.

   The xfd window
     The font name displayed at the top of the window is the full
     name of the font, as determined by the server.

     The glyphs are displayed in a grid of cells, each large
     enough to hold any single character in the font.  The char-
     acters are shown in increasing order from left to right and
     from top to bottom.  The first character displayed in the
     upper-left cell is character number 0 unless the -start op-



November, 1990                                                  1

xfd(1X)                                                   xfd(1X)



     tion is supplied, in which case the number specified by the
     -start option is used.

     Each glyph is drawn using the PolyText16 request (used by
     the Xlib routine XDrawString16(3X)).  If the -box option is
     specified, a rectangle is drawn around each character, show-
     ing where an ImageText16 request (used by the Xlib routine
     XDrawImageString16(3X)) would cause a background color to be
     displayed.

     The origin of each glyph is normally set so that the charac-
     ter is drawn in the upper-left corner of the grid cell.
     However, if a glyph has a negative left bearing or an unusu-
     ally large ascent, descent, or right bearing (as is the case
     with the cursor font), some characters may not appear in
     their own grid cells.  You can use the -center option to
     force all glyphs to be centered in their respective cells.

   Using xfd
     You can cause the display of individual character metrics
     (index, width, bearings, ascent, and descent) at the top of
     the window by clicking the desired character.

     All the characters in the font may not fit in the window at
     once.  To see the next page of glyphs, click the Next Page
     button at the top of the window.  To see the previous page,
     click the Prev Page button. To exit xfd, click the Quit but-
     ton.

     See xlsfonts(1X) for ways to generate lists of fonts as well
     as more detailed summaries of their metrics and properties.

LIMITATIONS
     The xfd command should skip over pages full of nonexistent
     characters.

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

     Author: Jim Fulton, MIT X Consortium

     A previous program of the same name is by Mark Lillibridge,
     MIT Project Athena.

SEE ALSO
     X(1X), xlsfonts(1X), xrdb(1X)

     XDrawImageString16(3X), XDrawString16(3X) in X11
     Programmer's Reference for A/UX





2                                                  November, 1990