1XFD(1)                      General Commands Manual                     XFD(1)
2
3
4

NAME

6       xfd - display all the characters in an X font
7

SYNOPSIS

9       xfd [-options ...] -fn fontname
10
11       xfd [-options ...] -fa fontname
12

DESCRIPTION

14       The  xfd utility creates a window containing the name of the font being
15       displayed, a row of command buttons, several lines of text for display‐
16       ing  character  metrics, and a grid containing one glyph per cell.  The
17       characters are shown in increasing order from left  to  right,  top  to
18       bottom.   The first character displayed at the top left will be charac‐
19       ter number 0 unless the -start option has been supplied in  which  case
20       the character with the number given in the -start option will be used.
21
22       The  characters  are displayed in a grid of boxes, each large enough to
23       hold any single character in the font.  Each character glyph  is  drawn
24       using  the  PolyText16 request (used by the Xlib routine XDrawString16)
25       or the XftDrawString32 routine, depending on whether  the  -fn  or  -fa
26       option  was  given.   If  the -box option is given, a rectangle will be
27       drawn around each character, showing where an ImageText16 request (used
28       by the Xlib routine XDrawImageString16) would cause background color to
29       be displayed.
30
31       The origin of each glyph is normally set so that the character is drawn
32       in  the  upper  left hand corner of the grid cell.  However, if a glyph
33       has a negative left bearing or an unusually large ascent,  descent,  or
34       right bearing (as is the case with cursor font), some character may not
35       appear in their own grid cells.  The -center  option  may  be  used  to
36       force all glyphs to be centered in their respective cells.
37
38       All  the  characters in the font may not fit in the window at once.  To
39       see the next page of glyphs, press the Next button at the  top  of  the
40       window.   To  see  the  previous  page, press Prev.  To exit xfd, press
41       Quit.
42
43       Individual  character  metrics  (index,  width,  bearings,  ascent  and
44       descent)  can  be displayed at the top of the window by clicking on the
45       desired character.
46
47       The font name displayed at the top of the window is the  full  name  of
48       the  font,  as  determined by the server.  See xlsfonts and fc-list for
49       ways to generate lists of fonts, as well as more detailed summaries  of
50       their metrics and properties.
51

OPTIONS

53       xfd accepts all of the standard toolkit command line options along with
54       the additional options listed below:
55
56       -fn font
57               This option specifies the core X server side font  to  be  dis‐
58               played.   This can also be set with the FontGrid font resource.
59               A font must be specified.
60
61       -fa font
62               This option specifies a Xft font to be displayed. This can also
63               be  set with the FontGrid face resource. A font pattern must be
64               specified.
65
66       -box    This option indicates that a box should be displayed  outlining
67               the  area  that  would  be  filled  with background color by an
68               ImageText request.  This can also be set with the FontGrid box‐
69               Chars resource.  The default is False.
70
71       -center This option indicates that each glyph should be centered in its
72               grid.  This can also  be  set  with  the  FontGrid  centerChars
73               resource.  The default is False.
74
75       -start number
76               This  option  specifies  the glyph index of the upper left hand
77               corner of the grid.  This is used to view characters  at  arbi‐
78               trary  locations  in  the  font.  This can also be set with the
79               FontGrid startChar resource.  The default is 0.
80
81       -bc color
82               This option specifies the color to be used if  ImageText  boxes
83               are  drawn.   This  can  also be set with the FontGrid boxColor
84               resource.
85
86       -rows numrows
87               This option specifies the number of rows in the grid.  This can
88               also be set with the FontGrid cellRows resource.
89
90       -columns numcols
91               This  option specifies the number of columns in the grid.  This
92               can also be set with the FontGrid cellColumns resource.
93

WIDGETS

95       In order to specify resources, it is useful to know the  widgets  which
96       compose xfd.  In the notation below, indentation indicates hierarchical
97       structure.  The widget class name is given first, followed by the  wid‐
98       get instance name.  The application class name is Xfd.
99
100       Xfd  xfd
101            Paned  pane
102                 Label  fontname
103                 Box  box
104                      Command  quit
105                      Command  prev
106                      Command  next
107                 Label  select
108                 Label  metrics
109                 Label  range
110                 Label  start
111                 Form  form
112                      FontGrid  grid
113

FONTGRID RESOURCES

115       The  FontGrid  widget is an application-specific widget, and a subclass
116       of the Simple widget  in  the  Athena  widget  set.   The  effects  and
117       instance names of this widget's resources are given in the OPTIONS sec‐
118       tion.  Capitalize the first letter of the resource instance name to get
119       the corresponding class name.
120

APPLICATION SPECIFIC RESOURCES

122       The  instance  names  of  the  application specific resources are given
123       below.  Capitalize the first letter of the resource  instance  name  to
124       get  the  corresponding class name.  These resources are unlikely to be
125       interesting unless you are localizing xfd for a different language.
126
127       selectFormat
128               Specifies a printf-style format string used to display informa‐
129               tion  about  the selected character.  The default is "character
130               0x%02x%02x (%u,%u) (%#o,%#o)".  The arguments  that  will  come
131               after the format string are char.byte1, char.byte2, char.byte1,
132               char.byte2, char.byte1, char.byte2.  char.byte1 is  byte  1  of
133               the  selected  character.  char.byte2 is byte 2 of the selected
134               character.
135
136       metricsFormat
137               Specifies a printf-style format string used to display  charac‐
138               ter  metrics.   The  default  is  "width %d; left %d, right %d;
139               ascent %d, descent %d (font %d, %d)".  The arguments that  will
140               come  after  the format string are the character metrics width,
141               lbearing, rbearing, character ascent, character  descent,  font
142               ascent, and font descent.
143
144       rangeFormat
145               Specifies  a  printf-style  format  string  used to display the
146               range of characters currently being displayed.  The default  is
147               "range: 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)".  The argu‐
148               ments that will come after the format string are the  following
149               fields  from  the XFontStruct that is returned from opening the
150               font:      min_byte1,       min_char_or_byte2,       min_byte1,
151               min_char_or_byte2,   max_byte1,  max_char_or_byte2,  max_byte1,
152               max_char_or_byte2.
153
154       startFormat
155               Specifies a printf-style format string used to display informa‐
156               tion  about  the character at the upper left corner of the font
157               grid.  The default is "upper left: 0x%04x (%d,%d)".  The  argu‐
158               ments  that will come after the format string are the new char‐
159               acter, the high byte of the new character, and the low byte  of
160               the new character.
161
162       nocharFormat
163               Specifies  a  printf-style  format  string  to display when the
164               selected character does not exist.  The  default  is  "no  such
165               character  0x%02x%02x  (%u,%u)  (%#o,%#o)".  The arguments that
166               will come after the format string  are  the  same  as  for  the
167               selectFormat resource.
168

SEE ALSO

170       X(7),  xlsfonts(1),  xrdb(1), xfontsel(1), fc-list(1), fonts.conf(5), X
171       Logical Font Description Conventions
172

BUGS

174       The program should skip over pages full of non-existent characters.
175

AUTHOR

177       Jim Fulton, MIT X Consortium; previous program of the same name by Mark
178       Lillibridge, MIT Project Athena.
179
180
181
182
183X Version 11                       xfd 1.1.1                            XFD(1)
Impressum