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 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 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 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 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 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
53 xfd accepts all of the standard toolkit command line options along with
54 the additional options listed below:
55 -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 -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 -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 -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 -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 -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 -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 -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
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 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
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
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 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 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 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 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 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
170 X(7), xlsfonts(1), xrdb(1), xfontsel(1), fc-list(1), fonts.conf(5), X
171 Logical Font Description Conventions
172
174 The program should skip over pages full of non-existent characters.
175
177 Jim Fulton, MIT X Consortium; previous program of the same name by Mark
178 Lillibridge, MIT Project Athena.
179X Version 11 xfd 1.1.1 XFD(1)