1XFD(1) General Commands Manual XFD(1)
2
6 xfd - display all the characters in an X font
7
9 xfd [-options ...] -fn fontname
10 xfd [-options ...] -fa fontname
12
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 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 If the -box option is given, a rectangle will be drawn around each
26 character, showing where an ImageText16 request (used by the Xlib rou‐
27 tine XDrawImageString16) would cause background color to be displayed.
28 The origin of each glyph is normally set so that the character is drawn
30 in the upper left hand corner of the grid cell. However, if a glyph
31 has a negative left bearing or an unusually large ascent, descent, or
32 right bearing (as is the case with cursor font), some character may not
33 appear in their own grid cells. The -center option may be used to
34 force all glyphs to be centered in their respective cells.
35 All the characters in the font may not fit in the window at once. To
37 see the next page of glyphs, press the Next button at the top of the
38 window. To see the previous page, press Prev. To exit xfd, press
39 Quit.
40 Individual character metrics (index, width, bearings, ascent and
42 descent) can be displayed at the top of the window by clicking on the
43 desired character.
44 The font name displayed at the top of the window is the full name of
46 the font, as determined by the server. See xlsfonts for ways to gener‐
47 ate lists of fonts, as well as more detailed summaries of their metrics
48 and properties.
49
51 xfd accepts all of the standard toolkit command line options along with
52 the additional options listed below:
53 -fn font
55 This option specifies the core X server side font to be dis‐
56 played. This can also be set with the FontGrid font resource.
57 A font must be specified.
58 -fa font
60 This option specifies a Xft font to be displayed. This can also
61 be set with the FontGrid face resource. A font pattern must be
62 specified.
63 -box This option indicates that a box should be displayed outlining
65 the area that would be filled with background color by an
66 ImageText request. This can also be set with the FontGrid box‐
67 Chars resource. The default is False.
68 -center This option indicates that each glyph should be centered in its
70 grid. This can also be set with the FontGrid centerChars
71 resource. The default is False.
72 -start number
74 This option specifies the glyph index of the upper left hand
75 corner of the grid. This is used to view characters at arbi‐
76 trary locations in the font. This can also be set with the
77 FontGrid startChar resource. The default is 0.
78 -bc color
80 This option specifies the color to be used if ImageText boxes
81 are drawn. This can also be set with the FontGrid boxColor
82 resource.
83 -rows numrows
85 This option specifies the number of rows in the grid. This can
86 also be set with the FontGrid cellRows resource.
87 -columns numcols
89 This option specifies the number of columns in the grid. This
90 can also be set with the FontGrid cellColumns resource.
91
93 In order to specify resources, it is useful to know the widgets which
94 compose xfd. In the notation below, indentation indicates hierarchical
95 structure. The widget class name is given first, followed by the wid‐
96 get instance name. The application class name is Xfd.
97 Xfd xfd
99 Paned pane
100 Label fontname
101 Box box
102 Command quit
103 Command prev
104 Command next
105 Label select
106 Label metrics
107 Label range
108 Label start
109 Form form
110 FontGrid grid
111
113 The FontGrid widget is an application-specific widget, and a subclass
114 of the Simple widget in the Athena widget set. The effects and
115 instance names of this widget's resources are given in the OPTIONS sec‐
116 tion. Capitalize the first letter of the resource instance name to get
117 the corresponding class name.
118
120 The instance names of the application specific resources are given
121 below. Capitalize the first letter of the resource instance name to
122 get the corresponding class name. These resources are unlikely to be
123 interesting unless you are localizing xfd for a different language.
124 selectFormat
126 Specifies a printf-style format string used to display informa‐
127 tion about the selected character. The default is "character
128 0x%02x%02x (%u,%u) (%#o,%#o)". The arguments that will come
129 after the format string are char.byte1, char.byte2, char.byte1,
130 char.byte2, char.byte1, char.byte2. char.byte1 is byte 1 of
131 the selected character. char.byte2 is byte 2 of the selected
132 character.
133 metricsFormat
135 Specifies a printf-style format string used to display charac‐
136 ter metrics. The default is "width %d; left %d, right %d;
137 ascent %d, descent %d (font %d, %d)". The arguments that will
138 come after the format string are the character metrics width,
139 lbearing, rbearing, character ascent, character descent, font
140 ascent, and font descent.
141 rangeFormat
143 Specifies a printf-style format string used to display the
144 range of characters currently being displayed. The default is
145 "range: 0x%02x%02x (%u,%u) thru 0x%02x%02x (%u,%u)". The argu‐
146 ments that will come after the format string are the following
147 fields from the XFontStruct that is returned from opening the
148 font: min_byte1, min_char_or_byte2, min_byte1,
149 min_char_or_byte2, max_byte1, max_char_or_byte2, max_byte1,
150 max_char_or_byte2.
151 startFormat
153 Specifies a printf-style format string used to display informa‐
154 tion about the character at the upper left corner of the font
155 grid. The default is "upper left: 0x%04x (%d,%d)". The argu‐
156 ments that will come after the format string are the new char‐
157 acter, the high byte of the new character, and the low byte of
158 the new character.
159 nocharFormat
161 Specifies a printf-style format string to display when the
162 selected character does not exist. The default is "no such
163 character 0x%02x%02x (%u,%u) (%#o,%#o)". The arguments that
164 will come after the format string are the same as for the
165 selectFormat resource.
166
168 X(7), xlsfonts(1), xrdb(1), xfontsel(1), fontconfig(3), X Logical Font
169 Description Conventions
170
172 The program should skip over pages full of non-existent characters.
173
175 Jim Fulton, MIT X Consortium; previous program of the same name by Mark
176 Lillibridge, MIT Project Athena.
177X Version 11 xfd 1.0.1 XFD(1)