|
|
1.1 root 1: .TH XFD 1 "12 June 1987" "X Version 11"
2: .SH NAME
3: xfd - X window system font displayer
4: .SH SYNOPSIS
5: .B xfd
6: [ =\fIgeometry\fP ] [ \fIhost\fP:\fInumber\fP ] [ options ] [ fontname ]
7: .SH DESCRIPTION
8: .I Xfd
9: creates a window which displays the characters in the named font. The
10: characters are displayed in increasing order from left to right and top to
11: bottom. The first character displayed at the top left will be character
12: number 0 unless the -start option has been supplied in which case the
13: character with the number given in the -start option will be used.
14: .PP
15: The characters are displayed in a grid of boxes, each large enough to hold any
16: character of the font.
17: If the -gray option has been supplied, the characters will be displayed using
18: XDrawImageString using the foreground and background colors on a
19: gray background. This permits determining exactly how XDrawImageString will
20: draw any given character. If -gray has not been supplied, the characters will
21: simply be drawn using the foreground color on the background color.
22: .PP
23: All the characters in the font may not fit in the window at once.
24: To see additional characters, click the right mouse button on the window.
25: This will cause the next window full of characters to be displayed.
26: Clicking the left mouse button on the window will cause the previous
27: window full of characters to be displayed.
28: .I Xfd
29: will beep if an attempt is made to go back past the 0th character.
30: .PP
31: Note that if the font is a 8 bit font, the characters 256-511 (0x100-0x1ff),
32: 512-767 (0x200-0x2ff), ...
33: will display exactly the same as the characters 0-255 (0x00-0xff).
34: .I Xfd
35: by default creates a window of size sufficient to display the first 256
36: characters using a 16 by 16 grid. In this case, there is no need to scroll
37: forward or backward window fulls in order to see the entire contents of a 8 bit
38: font. Of course, this window may very well not fit on the screen...
39: .PP
40: Clicking the middle button on a character will cause that character's
41: number to be displayed in both decimal and hexidecimal at the bottom of the
42: window. If verbose mode is selected, additional information about that
43: particular character will be displayed as well. The displayed information
44: includes the width of the character, its left bearing, right bearing, ascent,
45: and its descent. If verbose mode is selected, typing '<' or '>' into the
46: window will display the minimum or maximum values respectively
47: taken on by each of these fields over the entire font.
48: .PP
49: The font name is interpreted by the X server.
50: To obtain a list of all the fonts available, use xlsfonts.
51: On a VAX, if the name
52: does not begin with ``/'', the X server adds the suffix ``.snf'' to it and
53: looks up the font file in the directory \fI/usr/new/lib/X/font/\fP. If
54: the name does begin with ``/'', the X server treats it as an absolute
55: pathname of a file containing a font.
56: .PP
57: If no font name is given on the command line,
58: .I Xfd
59: displays the font ``fixed''.
60: .PP
61: The window stays around until the xfd process is killed
62: or one of 'q', 'Q', ' ', or ctrl-c is typed into the
63: .I Xfd
64: window.
65: .SH "OPTIONS"
66: .PP
67: .TP 8
68: .B \fIhost\fP:\fIdisplay\fP
69: Normally,
70: .I xfd
71: gets the host and display number to use from the environment
72: variable ``DISPLAY''. One can, however specify them explicitly.
73: The
74: .I host
75: specifies which machine to create the window on, and
76: the
77: .I number
78: argument specifies the display number.
79: For example,
80: ``orpheus:1'' creates a shell window on display one on the machine
81: orpheus.
82: .PP
83: .TP 8
84: .B \-bw \fIborderwidth\fP
85: Allows you to specify the width of the window border in pixels.
86: .PP
87: .TP 8
88: .B \-rv
89: The foreground and background colors will be switched. The default colors
90: are black on white.
91: .PP
92: .TP 8
93: .B \-fw
94: Overrides a previous choice of reverse video, say in a .Xdefaults file. The
95: foreground and background colors will not be switched.
96: .PP
97: .TP 8
98: .B \-fg \fIcolor\fP
99: On color displays, determines the foreground color. (the color of the text)
100: .PP
101: .TP 8
102: .B \-bg \fIcolor\fP
103: On color displays, determines the background color.
104: .PP
105: .TP 8
106: .B \-bd \fIcolor\fP
107: On color displays, determines the color of the border.
108: .PP
109: .TP 8
110: .B \-bf \fIfontname\fP
111: Specifies the font to be used for the messages at the bottom of the window.
112: .PP
113: .TP 8
114: .B \-tl \fItitle\fP
115: Specifies that the title of the displayed window should be \fItitle\fP.
116: .PP
117: .TP 8
118: .B \-in \fIiconname\fP
119: Specifies that the name of the icon should be \fIiconname\fP.
120: .PP
121: .TP 8
122: .B \-icon \fIfilename\fP
123: Specifies that the bitmap in file \fIfilename\fP should be used for the icon.
124: .PP
125: .TP 8
126: .B \-verbose
127: Specifies that verbose mode should be used.
128: .PP
129: .TP 8
130: .B \-gray
131: Specifies that a gray background should be used.
132: .PP
133: .TP 8
134: .B \-start \fIcharnum\fP
135: Specifies that character number \fIcharnum\fP should be the first character
136: displayed.
137: .PP
138: .TP 8
139: .B \=\fIgeometry\fP
140: .I Xfd
141: will also take a standard geometry specification (see X(1)).
142: .SH "X DEFAULTS"
143: .I Xfd
144: uses a number of standard default values.
145: .PP
146: .TP 8
147: .B BorderWidth
148: Set the border width of the window.
149: .PP
150: .TP 8
151: .B BorderColor
152: Set the border color of the window.
153: .PP
154: .TP 8
155: .B ReverseVideo
156: If ``on'', reverse the definition of foreground and background color.
157: .PP
158: .TP 8
159: .B Foreground
160: Set the foreground color.
161: .PP
162: .TP 8
163: .B Background
164: Set the background color.
165: .PP
166: .TP 8
167: .B Border
168: Set the color of the border.
169: .PP
170: .TP 8
171: .B BodyFont
172: Set the font to be used in the body of the window. (I.e., for messages, etc.)
173: This is not the font that \fIXfd\fP displays, just the font it uses
174: to display information about the font being displayed.
175: .PP
176: .TP 8
177: .B IconName
178: Set the name of the icon.
179: .PP
180: .TP 8
181: .B IconBitmap
182: Set the file we should look in to get the bitmap for the icon.
183: .PP
184: .TP 8
185: .B Title
186: Set the title to be used.
187: .SH FILES
188: /usr/new/lib/X/font/*.snf
189: .SH "SEE ALSO"
190: X(1), X(8C), xterm(1), xlsfonts(1)
191: .SH ENVIRONMENT
192: DISPLAY - To find out which display you are using.
193: .SH BUGS
194: It should display the name of the font somewhere.
195: .SH AUTHOR
196: Mark Lillibridge, MIT Project Athena
197: .br
198: Copyright (c) 1987 by Massachusetts Institute of Technology.
199: .br
200: See X(1) for a complete copyright notice.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.