home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / programs / list / ep-docs.ark / ECHED.DOC < prev    next >
Encoding:
Text File  |  1988-05-21  |  12.3 KB  |  326 lines
  1. \ad 1"
  2. \ll 6"
  3. \high-resolution
  4. \concatenate\justify
  5. \disk 2
  6. \font Melior\attach
  7. \font Helvetica\attach
  8. \font Eurostile\tall\attach
  9. \bold
  10. \font 1
  11.  
  12. \ce \fo 3 {\emphasize ECHED}
  13.  
  14.  \fo 3 {\tall 0 \elite ECHED\} is a font editing program for {EP.}
  15. It allows the creation of new fonts, i.e. .FN2 files, or the modification
  16. of existing ones.
  17. Two fonts can be edited at once, so that, for
  18. example, character patterns can be moved from font to font.
  19. After ECHED on the CPM command line, one or two names of
  20. fonts to be edited can be given, in which case the font files
  21. will be searched for and loaded into memory if found.
  22. The names given should not include the extension .FN2, which
  23. is added automatically.
  24. If no names are given, fonts WORK and WORK2 are looked for.
  25. Fonts can be renamed, loaded from disk, or saved into disk files
  26. at any time during editing.
  27. To load or save a font file, first give it an appropriate name
  28. with the N command described below (if you don't like the name
  29. it has already), then use the O command to load it from disk,
  30. or the S command to save it.
  31.  The largest font that can be edited is about 9K, if two fonts are
  32. being edited, but 18K if only one is being worked on.
  33.  
  34.  There are three modes: the main mode, editing mode, and a mode for
  35. configuring special properties of a font. Commands are single
  36. letters, and the commands available are listed on the screen.
  37. Either upper case or lower case letters will do.
  38.  
  39. \fo 3 {PROMPT}
  40.  
  41.  In the main mode, the following information is given at the
  42. top of the screen:
  43.  
  44. \fo 2 {\elite
  45. ECHED F1=\fo 1 {\italic fname-1} (F2=..none..
  46. \fo 1 {\em {or} fname-2})
  47. Character=\fo 1{\italic c}
  48. W=\fo 1 {\italic width}
  49. Room=\fo 1 {\italic size} H
  50. Test phrase is \fo 1 {\italic string}
  51. }
  52.  
  53.  F1 and F2 are the names of the two fonts being edited.
  54. The names can be changed with the N command.
  55. One of the two is designated as the current font;
  56. the other is shown in parentheses.
  57. The Get and Copy commands described below always use the
  58. current font.
  59. When the first font has exceeded 9K in size, the second font
  60. cannot be used, and this is indicated by listing the second
  61. name as `..none..'.
  62.  Next in the prompt line, the current character is given.
  63. This is the character that can be modified in edit mode, or
  64. can be copied with the Copy command. A different character
  65. can be designated as current with the Get command.
  66.  Following this, the width of the current character is given,
  67. then the memory available for expansion of the current font.
  68.  
  69.  Below the prompt line is the string which will be printed by
  70. the Test command. A listing of the commands available in the
  71. main mode is given on the lower part of the screen.
  72.  
  73.  
  74. \fo 3 {MAIN}
  75.  
  76.  The commands available in the main mode are as follows.
  77.  
  78. \fo 2 {Width change.}  Changes the width of the current character.
  79.  
  80. \fo 2 {Zero character.}  Makes the current character blank by
  81. removing all its dots.
  82.  
  83. \fo 2 {Get character.}  Makes a new character current, so that
  84. it can be edited or copied. Any ascii character except for numbers
  85. 0 (nul) and 127 (del) is ok.
  86.  
  87. \fo 2 {Copy to character.}  A copy of the dot pattern associated with the
  88. current character is made and associated with another character.
  89. You will be asked for the destination character. To move a character
  90. (or rather its dot pattern) from one font to another, make the source
  91. font the current one with the 1 or 2 command, Get the source character,
  92. make the destination font current with the 2 or 1 command, then use
  93. the Copy command. 
  94.  
  95. \fo 2 {Phrase for test print.} Changes the string that is printed out
  96. by the following Test command.
  97.  
  98. \fo 2 {Test print.}  Prints the current Phrase string, to see how the
  99. characters are looking. To test print on the MX-80 (instead of the FX-80)
  100. type control-T instead of T.
  101.  
  102. \fo 2 {Quiet console tog.}  Suppresses or enables output to the console.
  103. Intended for use with shell files.
  104.  
  105. \fo 2 {1st font.}  Designates the first font, F1, as the source for
  106. the Get character command or the destination for the Copy command.
  107.  
  108. \fo 2 {2nd font}  Designates the second font, F2, as the source for
  109. the Get character command or the destination for the Copy command.
  110.  
  111. \fo 2 {E Edit.}  Switches to edit mode, the modify the dot pattern of
  112. the current character (of the current font). The commands that will
  113. be available in edit mode are listed on the upper part of the screen
  114. in the main mode.
  115.  
  116. \fo 2 {Xit to CPM.}  Exits the ECHED program. Any changes to characters
  117. made since the last Save command will be lost. There is no ``are you
  118. sure'' warning.
  119.  
  120. \fo 2 {Name font.}  Changes name of current font. You will be asked
  121. for the new name. The name may contain a user or disk prefix -- e.g.
  122. 2/B:HELVETICA refers to the file HELVETICA.FN2 on the disk in drive
  123. B, in user area 2.
  124.  
  125. \fo 2 {Open font.}  Looks for a disk file with the name of the current
  126. font (plus the .FN2 extension), and if found, loads it into memory
  127. for editing.
  128.  
  129. \fo 2 {Save font.}  Saves the current font, with whatever changes have
  130. been made to it, as a disk file with whatever name has been assigned
  131. with the Name command. The Save command must be given explicitly --
  132. it is not automatic upon exit from ECHED.
  133.  
  134. \fo 2 {Read EDF.}  Reads a dot pattern for the current character
  135. from a disk text file with the name Annn.EDF, where nnn is the ascii
  136. number of the current character (e.g. A65.EDF for character A).
  137. This command is provided mainly for converting character patterns
  138. from Softcraft's Fancy Font system into a form usable by EP.
  139. The .EDF files can be created using the Fancy Font program EFONT.
  140.  
  141. \fo 2 {Disk write EDF}  Writes a dot pattern for the current character
  142. into a disk text file with the name Annn.EDF, where nnn is the ascii
  143. number of the current character (e.g. A65.EDF for character A).
  144. This command is provided mainly for converting character patterns
  145. into a form usable by Softcraft's Fancy Font system.
  146. The .EDF files can be read using the Fancy Font program EFONT.
  147.  The character pattern written to the disk file is horizontally
  148. condensed by a factor of two, since fonts in the Fancy Font system
  149. have only half the horizontal resolution of EP fonts. In case you
  150. don't want this condensation, use control-D instead of D.
  151.  
  152. \fo 2 {Mode change}  Switches to the special mode for altering
  153. certain inherent characteristics of fonts.
  154.  
  155.  
  156.  
  157. \fo 3 {EDIT}
  158.  
  159.  Use this mode to alter or create character shapes. You move the
  160. cursor to where you want a dot and press `,' or to remove
  161. a dot press the space bar.
  162.  The commands available in the edit mode are as follows.
  163.  
  164.  
  165. \fo 2 {^E cursor up}
  166.  
  167. \fo 2 {^R cursor up 8}
  168.  
  169. \fo 2 {^S cursor left}
  170.  
  171. \fo 2 {^A cursor left 8}
  172.  
  173. \fo 2 {^D cursor right}
  174.  
  175. \fo 2 {^F cursor right 8}
  176.  
  177. \fo 2 {^X cursor down}
  178.  
  179. \fo 2 {^C cursor down 8}
  180.  
  181. \fo 2 {,  dot on}  Add a dot to the pattern.
  182.  
  183. \fo 2 {SP dot off}  Remove a dot from the pattern
  184.  
  185. \fo 2 {w  widen}  Increase the width of the character by one
  186. column of dots at the right. The current width is indicated
  187. on the screen with `|'s. The width must be sufficient to contain all
  188. the dots in the pattern, and may be wider. If dots are added to the
  189. right of the current width, the next time this character is edited,
  190. you will find that the dots have disappeared.
  191.  
  192. \fo 2 {n  narrow}  Decrease the width of the character by
  193. one column of dots at the right.
  194.  
  195. \fo 2 {+  add column}  Duplicate the column of dots at the
  196. cursor position. The part of the character to the right of the
  197. cursor moves to the right to make room for the new column. 
  198.  
  199. \fo 2 {-  delete column}  Remove the column of dots at the
  200. cursor position. The part of the character to the right of the
  201. cursor moves to the left to take up the slack.
  202.  
  203. \fo 2 {0  add blank column}  Add a blank column of dots at the
  204. cursor position. The part of the character to the right of the
  205. cursor moves to the right to make room for the new column. 
  206.  
  207. \fo 2 {u  up scroll}  Move the character shape upward. The bottom
  208. row of dots is duplicated, and the top row is lost.
  209.  
  210. \fo 2 {d  down scroll}  Move the character shape downward. The top
  211. row of dots is duplicated, and the bottom row is lost.
  212.  
  213. \fo 2 {p  plus row}  Duplicate the row of dots at the
  214. cursor position. The part of the character below the
  215. cursor moves down to make room for the new row. 
  216.  
  217.  
  218. \fo 2 {m  minus row}  Remove the row of dots at the
  219. cursor position. The part of the character below the
  220. cursor moves up to take up the slack.
  221.  
  222.  
  223. \fo 2 {r  right row}  Move the row of dots at the cursor position right.
  224.  
  225. \fo 2 {l  left row}  Move the row of dots at the cursor position left.
  226.  
  227. \fo 2 {x  eXit\} (also {q})  Return to the main mode.
  228.  
  229. \fo 2 {?  for info}  Display a list of the commands available
  230. in this mode. The information appears on the right part of the
  231. screen, and could overlay part of the character shape, but this
  232. is harmless. Only the visibility of the character is temporarily
  233. affected.
  234.  
  235. Keys whose action is undefined will cause the screen to be reinitialized,
  236. but have no other effect, except that a carriage return has no
  237. effect at all.
  238.  
  239.  
  240.  
  241. \fo 3 {SPECIAL MODE}
  242.  
  243.  This mode is entered with the M command. It allows marking a font
  244. to request a special print mode under EP, or additional kerning
  245. (character-spacing). 
  246.  Move the cursor next to an attribute you want to change, then
  247. type a space, or any other non-control character.
  248. The font attributes that can be changed in the special mode are as follows.
  249.  
  250. \fo 2 {Elite}  Requests Elite mode.
  251.  
  252. \fo 2 {Duplex}  Requests Tall mode and causes characters to be printed
  253. in two parts, to achieve higher resolution for tall characters.
  254. Only half the ASCII characters can be kept in a duplex font,
  255. corresponding to characters 20H through 5EH, which hold the top
  256. halves of the character shapes. The bottoms are stored as values
  257. of characters at an offset of 20H -- minus 20H for characters 21H
  258. through 3FH, and plus 20H for 40H through 5EH.
  259.  
  260. \fo 2 {Compressed}  Requests Compressed mode.
  261.  
  262. \fo 2 {Emphasized}  Requests Emphasized mode.
  263.  
  264. \fo 2 {Double Strike}  Requests Double Strike mode.
  265.  
  266. \fo 2 {Expanded}  Requests Expanded mode.
  267.  
  268. \fo 2 {Underlined}  Well, you get the idea.
  269.  
  270. \fo 2 {Italic}
  271.  
  272. \fo 2 {Kerning}  The value entered for kerning, which may be from
  273. -128 to 127, is added to the character-spacing. With the cursor
  274. in the same row as `Kerning', type a space, or whatever you like,
  275. and a prompt `>' will be shown to show that ECHED is now expecting
  276. a number to be typed.
  277.  
  278. \fo 2 {q  Quit}  Return to the main mode.
  279.  
  280. \fo 2 {^E cursor up}
  281.  
  282. \fo 2 {^R cursor up 8}
  283.  
  284. \fo 2 {^X cursor down}
  285.  
  286. \fo 2 {^C cursor down 8
  287.  
  288.  
  289. \ce\fo 3 {INSTALLATION}
  290.  
  291.  ECHED requires CPM version 2.2 and a TPA of 46K (100H-B800H).
  292. It is screen-oriented, and needs a terminal with cursor addressing,
  293. 24 by 80 screen,
  294. and provision for clearing the screen. The initial terminal
  295. configuration is for the Admiral 3A, for which the cursor
  296. addressing protocol requires sending four characters:
  297.     escape-character '=' line-number+20H column-number+20H
  298. \break and the screen is erased by sending character control-Z.
  299.  For terminals with other conventions for cursor addressing
  300. or erasing the screen, a file ECHED.INI can be created.
  301. This initialization file is looked for whenever ECHED executes,
  302. and if found, is used to determine the above protocols.
  303. The format of this file is almost the same as the first
  304. two pages (100H-2FFH) of MicroPro's WordStar version 3.00,
  305. so the initialization file can be derived from
  306. an installed WS.COM by using DDT.
  307. The only difference is that the string at 26DH is used to
  308. erase the screen, whereas for WordStar this string is for
  309. erasing to the end of the line. (Also, ECHED would not
  310. be able to use a user-coded cursor addressing routine.)
  311.  Here is a sample dialogue for creating a ECHED.INI file for
  312. the Admiral 3A (which actually would be unnecessary,
  313. since this terminal is assumed):
  314.     A>\ul {ddt ws.com}
  315.     DDT VERS 2.2
  316.     NEXT  PC
  317.     3F00 0100
  318.     -\ul {s26d}
  319.     026D 00 \ul{1}    ;to erase screen, send 1 character
  320.     026E 1B \ul{1a}    ;first character to send
  321.     026F 4B \ul{.}    ;done -- the string has been entered
  322.     -\ul {^C}
  323.     A>\ul {save 3 eched.ini}
  324.  The last character of the string to clear the screen cannot come
  325. after 27FH.
  326.