Annotation of researchv10dc/630/man/src/u_man/man1/loadfont.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.