|
|
1.1 root 1: .ds ZZ DEVELOPMENT PACKAGE
2: .TH LOADFONT 1 "630 MTG"
3: .XE "loadfont"
4: .SH NAME
5: loadfont \- font managing program
6: .SH SYNOPSIS
7: .B
8: loadfont [\-r name,name...] [\-p directory] [\-s] [\-c] [file...]
9: .SH DESCRIPTION
10: The
11: .I loadfont
12: program lets the user load and remove fonts from the terminal's cache.
13: It will download its terminal side which interacts with
14: the user. The command line arguments have the following meanings:
15: .PP
16: .TP 12
17: \fB\-r\fR
18: Removes the given font from the terminal's cache.
19: .PP
20: .TP 12
21: \fB\-p\fR
22: Sets default search path for font files. If this isn't set,
23: it defaults to $DMD/termfonts. All the file names in this directory
24: are put in the load submenu.
25: .TP 12
26: \fB\-s\fR
27: Makes loadfont stay running after executing the earlier command line options.
28: .PP
29: .TP 12
30: \fB\-c\fR
31: Causes loadfont to be cached in the 630 MTG cache system. When
32: this option is used, the loadfont program will remain in the
33: terminal after the program exits. Then, the next time loadfont
34: is executed, it will not have to be downloaded again.
35: .sp
36: Another effect of downloading loadfont with the \-c option is
37: that it can be executed in more than one window without
38: additional downloading.
39: .PP
40: .TP 12
41: \fBfile\fR
42: Loads the given font file into the terminal's cache.
43: .PP
44: If a \f3file\f1 argument and/or the
45: \f3\-r\f1 option are given, loadfont will exit after
46: loading/removing the specified fonts, unless the \f3\-s\f1 is
47: also given to make it stay running.
48: .PP
49: The user interacts with
50: .I loadfont
51: by using a button 2 menu and, when prompted, the keyboard.
52: When button 2 is depressed, a menu with the following items appears.
53: .PP
54: .TP 8
55: \fBLoad\fR
56: Load has a submenu of fonts that can be downloaded.
57: The fonts listed are all the files in the default search directory.
58: If the first item, Keyboard, is selected, the user is prompted
59: for the name of a font file to download.
60: .PP
61: .TP 8
62: \fBRemove\fR
63: Remove has a submenu of all the fonts in the terminal's cache.
64: Selecting one will remove it from the cache and free the memory
65: it was using. Fonts in ROM or being used by another process
66: will be greyed in the menu and cannot be removed.
67: .PP
68: .TP 8
69: \fBQuit\fR
70: Will make the program exit.
71: .PP
72: While a font is downloading, the button 2 menu will have only
73: one item, Terminate Download. Selecting it will stop the download
74: and switch the user back to the original menu.
75: .PP
76: The three fonts in ROM, resident to the 630 MTG, are called "small
77: font," "medium font," and "large font." Brief descriptions of these
78: fonts follow.
79: .PP
80: In the tables,
81: .I cell size
82: indicates the dimensions of the rectangle containing the character
83: image. All the characters in a particular font have the same cell size.
84: .I Character size
85: is the dimension of the largest character in the font.
86: .I Max chars
87: indicates how many characters in that font size will fit
88: horizontally and vertically in a full screen
89: window. See the section on fonts in the
90: \f2630 MTG Software Development Guide\f1
91: for more information on font data structures.
92: .sp
93: .TS
94: center, box, tab(~);
95: lb | l.
96: Font Name~small font
97: Character Size~6 pixels wide by 9 pixels high
98: Cell Size~7 pixels wide by 14 pixels high
99: Max Chars~140 across, 69 down
100: _
101: Font Name~medium font
102: Character Size~8 pixels wide by 11 pixels high
103: Cell Size~9 pixels wide by 14 pixels high
104: Max Chars~109 across, 69 down
105: _
106: Font Name~large font
107: Character Size~9 pixels wide by 12 pixels high
108: Cell Size~11 pixels wide by 16 pixels high
109: Max Chars~89 across, 61 down
110: _
111: .TE
112: .bp
113: .SH FILES
114: The default search path for font files is $DMD/termfonts. This
115: directory contains nine fonts.
116: .sp 2
117: .TS
118: center, box, tab(~);
119: lb | l.
120: Font Name~noseprint
121: Character Size~5 pixels wide by 7 pixels high
122: Cell Size~6 pixels wide by 9 pixels high
123: Max Chars~163 across, 108 down
124: Comments~The characters are a single pixel thick and all
125: ~are smaller than the characters found in the
126: ~resident "small font".
127: _
128: Font Name~7x14thin
129: Character Size~6 pixels wide by 9 pixels high
130: Cell Size~7 pixels wide by 14 pixels high
131: Max Chars~140 across, 69 down
132: Comments~The difference between "7x14thin" and the resident
133: ~"small font" is in the thickness of the characters.
134: ~The "7x14thin" consists of characters which are a
135: ~single pixel in thickness whereas the "small font"
136: ~consists of characters which are two pixels in thickness.
137: _
138: .TE
139: .bp
140: .TS
141: center, box, tab(~);
142: lb | l.
143: Font Name~12x18norm
144: Character Size~10 pixels wide by 13 pixels high
145: Cell Size~12 pixels wide by 18 pixels high
146: Max Chars~81 across, 54 down
147: Comments~The characters are 2 pixels thick.
148: _
149: Font Name~12x25thin
150: Character Size~9 pixels wide by 18 pixels high
151: Cell Size~12 pixels wide by 25 pixels high
152: Max Chars~81 across, 39 down
153: Comments~The characters are a single pixel thick.
154: _
155: Font Name~12x25norm
156: Character Size~9 pixels wide by 18 pixels high
157: Cell Size~12 pixels wide by 25 pixels high
158: Max Chars~81 across, 39 down
159: Comments~The characters are 2 pixels thick.
160: _
161: Font Name~12x25round
162: Character Size~9 pixels wide by 18 pixels high
163: Cell Size~12 pixels wide by 25 pixels high
164: Max Chars~81 across, 39 down
165: Comments~The main difference between this font and the
166: ~font called "12x25norm" is in the STYLE of the
167: ~characters. The characters in "12x25round" are
168: ~rounder in appearance, whereas the characters in
169: ~"12x25norm" are squarer in appearance.
170: _
171: Font Name~12x25BOLD
172: Character Size~9 pixels wide by 18 pixels high
173: Cell Size~12 pixels wide by 25 pixels high
174: Max Chars~81 across, 39 down
175: Comments~The characters are 3 pixels thick.
176: _
177: Font Name~script
178: Character Size~15 pixels wide (approx.) by 15 pixels high
179: Cell Size~16 pixels wide by 24 pixels high
180: Max Chars~61 across, 40 down
181: Comments~The characters in this font are created in
182: ~script style.
183: _
184: Font Name~twice_big
185: Character Size~18 pixels wide by 24 pixels high
186: Cell Size~22 pixels wide by 32 pixels high
187: Max Chars~44 across, 30 down
188: Comments~The characters are twice as tall and twice as
189: ~wide as the resident "large font"
190: _
191: .TE
192: .bp
193: .SH SEE ALSO
194: ucache(1), font(4).
195: .br
196: \f2630 MTG Software Development Guide\f1.
197: .SH WARNING
198: .P
199: Fonts that do not have 128 characters require the proper
200: parity setting when used in the default window process in the
201: non-layers environment. This is needed because a mod is done
202: on characters received from the host with the number of
203: characters in the font being used.
204: .P
205: This implies that parity bits are ignored for fonts with
206: exactly 128 characters, since c&0x7F == c%128. Fonts with less
207: than 128 characters need identical parity settings on the host
208: and in the terminal so that parity bits get stripped properly.
209: Characters with more than 128 characters require 8 bits with
210: no parity on both the host and in the terminal, because the
211: eighth bit is used to access characters greater than
212: 128.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.