home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / demon / amstrad / setfont.arc / ALTER.DOC < prev    next >
Encoding:
Text File  |  1994-03-22  |  11.4 KB  |  241 lines

  1. ALTER v1.02                                          J. Elliott, 9 January 1994.
  2. ================================================================================
  3.  
  4.   LocoScript 1 users: See at the end of this document for how to use ALTER on
  5.                       LocoScript 1 screen characters.
  6.  
  7.   ALTER.COM is a character set editor which will run on PCWs, CPCsº or Spectrum
  8. +3s.
  9.  
  10. º: The operation of ALTER on CPCs is untested.
  11.  
  12.   ALTER is run under the CP/M+ operating system. To use, type:
  13.  
  14.      ALTER
  15. or
  16.      ALTER fontfile.typ
  17.  
  18.   The first variant enters the editor with the current font; the second loads
  19. the specified font and enters the editor. Only standard PCW/CPC or Spectrum +3
  20. "plain" binary files can be used as fonts. Self-loading fonts, special formats
  21. etc. which cannot be used by ALTER should be loaded before entering ALTER, or
  22. resaved to standard format.
  23.   ALTER always uses the same character set as the one that is being edited, so
  24. any changes you make will be reflected in menus, messages etc. If you make the
  25. current characters unreadable, you will have to navigate "blind" through the
  26. menus to load a new character set.
  27.   There will naturally be some differences between ALTER on the PCW, CPC and the
  28. Spectrum +3. These are, for the most part, pointed out to you as they occur.
  29.   Once loaded, ALTER looks something like LocoScript. CPC and Spectrum users
  30. who will probably be unfamiliar with LocoScript should see the section "MENUS"
  31. later. PCW users should also read this section to find out about detail
  32. differences.
  33.   The Spectrum +3 contains two fonts; one is the "large" font used in the
  34. 24x32 screen mode, and the other is the "small" font used in the other screen
  35. modes. ALTER messages use the "small" font throughout, since ALTER runs in the
  36. 24x80 screen.
  37.  
  38. On startup, the options are:
  39.  
  40. E=Edit character. Characters are edited one at a time.
  41. L=Load font. Loads a standard binary file from disc.
  42. S=Save font. Saves the font as a binary file.
  43. W=Whole font options. As E=Edit but on more than one character at once.
  44.   Exit to CP/M. The actual keypress is version-dependent.
  45.  
  46. MENUS
  47.  
  48. PCW users: There are a few differences from LocoScript's own menus:
  49.            1. The keys for options are 1-5, not [f1]-[f8], and the [+] and [-]
  50.              keys are not used.
  51.            2. Making an input is similar to that in LocoScript. When the menu
  52.              bar is on an input option, anything you type will be used for an
  53.              input (ie not a shortcut).  To abandon the input, press the up or
  54.              down arrow; to finish it press [ENTER]. When making an input, most
  55.              normal CP/M editing keys apply.
  56.            3. To leave a menu without making a selection, press [STOP] or [EXIT]
  57.  
  58. CPC and +3 users: Move the cursor up and down with the cursor keys, amd press
  59.                  [ENTER] to make a selection.
  60.                There are some additional features of these menus:
  61.                 a) The menus don't "wrap around" - you can't move the cursor off
  62.                   the top to make it appear at the bottom.
  63.                 b) Shortcuts - press the initial letter of the option and the
  64.                   menu bar will jump to it (except when on an "input" line).
  65.                 c) Input - On options like "Number: ___" a cursor will appear
  66.                  in the right place for inputting. Just type and input will be
  67.                  made. When typing a number, you can use normal or Hex numbers;
  68.                  precede the number with an & to use Hex.
  69.                 d) Abandoning - press [BREAK] to leave a menu without making a
  70.                   choice.
  71. Spectrum hint: If nothing seems to be happening, press [EXTEND][ENTER] to flip
  72.                into the other half of the screen.
  73.  
  74. Existing ALTER users: ALTER v1.01 and later menus work slightly differently
  75.                      from v1.0 menus. You can still use the old "Cursor right
  76.                      before input" keypress but it is now unnecessary. You can
  77.                      now press [STOP] (^C) during an input. CAN (^H) can be used
  78.                      to abandon a menu.
  79.  
  80. SCREEN LAYOUT:
  81.  
  82.   The screen has three information lines at the top. The first contains general
  83. information. The second contains information relating to the current function,
  84. and the third shows what keys to press.
  85.   Immediately below these is the main window. This is used for editing
  86. characters or the disc directory.
  87.   At the bottom of the screen is the font window. This shows the current font
  88. (normally the small font on Spectrum +3s).
  89.  
  90. EDITING A CHARACTER:
  91.  
  92.   Press E to edit.
  93.   If you are a +3 user, a menu will ask whether you want to edit a small or
  94. large character.
  95.   The main selection menu will now appear. The options are:
  96. Typing character; ASCII number; From characters chart; and OK.
  97.   If you select OK without choosing a character, the computer will not accept
  98. this.
  99.   If you select "characters chart", a cursor will appear in the font window.
  100. Move to the right character and press [ENTER].
  101.  
  102.   The main edit screen now appears. The character, magnified x8, appears in the
  103. left-hand box; the right-hand box contains images of what the character looks
  104. like in real size. There are five options:
  105.  
  106. 1=Get character. Copies the pattern of another character (+3: of the same size)
  107.   into the editing windows.
  108. 2=Reflect. Reflects the current pattern. You have a choice of horizontally or
  109.   vertically.
  110. 3=Rotate. Standard PCW/CPC and large +3 characters can be rotated through 90ó in
  111.   either direction. Small +3 characters are rotated through 180ó.
  112. 4=Move. Slides the pattern up, down, left or right. The row that slides off the
  113.   edge comes back on the other side.
  114. 5=Options. There are seven:
  115.   (i)   Invert. All dark dots go to light; all light dots go to dark.
  116.   (ii)  Predefined patterns. See below for these two options.
  117.   (iii) Scratchpads.
  118.   (iv)  Bold. Emboldens the character by thickening vertical lines.
  119.   (v)   Doublestrike. Similar to Bold, but thickens horizontal lines.
  120.   (vi)  Italic. Tilts the character to the right.
  121.   (vii) Outline. Turns the character into a hollow shape.
  122.  
  123. "Finish edit" saves the character and returns to the main menu.
  124. "Abandon" returns you to the main menu; the character is left unchanged.
  125.  
  126. The predefined patterns menu offers:
  127. Blank.        The character is cleared.
  128. Speckled.     The character is replaced with a "grey blur"
  129. AND speckled. The effect is as if all the "blank" dots in the blur have been
  130.              transferred onto the picture. Try it on an A.
  131. OR speckled.  As if all the "coloured" dots in the blur have been painted over
  132.              the picture. Try it on an A.
  133. XOR speckled. This normally creates a messy effect; try it on character no. 128.
  134.  
  135.   The scratchpad menu allows you to save the current character in a memory
  136. area. If the pad is empty, all you can do is save the current character to it.
  137. Otherwise, you can AND, OR, XOR the contents of the pad with the current
  138. character, replace the current character with the contents of the pad, or empty
  139. the pad.
  140.  
  141.   A few notes on Bold/Doublestrike/Italic:
  142.  
  143.   Bold thickens vertical lines. You may find that the character will then join
  144. up with characters to the left and right. To make vertical lines thinner, use
  145. the sequence invert, bold, invert.
  146.   Doublestrike thickens horizontal lines. The character may then join up with
  147. characters above or below it. To make horizontal lines thinner, use the sequence
  148. invert, doublestrike, invert.
  149.   Italic works well on normal letters, although a few problems may be
  150. encountered with letters such as p or d. It is probably best not to use Italic
  151. on graphics characters. If you italicize a character which is inverted, you will
  152. also italicize the "block" it is in and be left with gaps at the top left and
  153. bottom right corners. To reverse the effect of Italic, or to tilt a character
  154. to the left, use the sequence Horizontal Reflect, Italic, Horizontal Reflect.
  155.  
  156.   Of course, characters emboldened or italicized by ALTER may not look quite as
  157. good as characters designed to be bold or italic.
  158.  
  159.   Some other useful combinations of the six options are:
  160.  
  161. AND speckled, Doublestrike
  162. Save to scratchpad, Italic, OR with pad
  163. Save to scratchpad, AND speckled, Italic, Bold, OR with pad
  164. Save to scratchpad, OR speckled, Invert, Doublestrike, Invert, AND with pad.
  165.  
  166. WHOLE FONT OPTIONS:
  167.  
  168. These are basically the same as the options at the top in the "Edit" screen, but
  169. please note:
  170.   1=Markers allows you to mark out a section of the font. The beginning and end
  171. markers will appear as underlines under the characters in question. When
  172. markers are in place, all other "Whole Font" options (except scratchpad
  173. operations) will be restricted to the characters between these markers.
  174.   The "whole font" options are very powerful and it is easy to make the font
  175. quite unreadable using them!
  176.   Note that v1.01 of ALTER contained a bug in the "Whole font" routine which
  177. could make the font unreadable anyway. This bug has now been fixed.
  178.  
  179. LOADING A FONT:
  180.  
  181.   Press L to load. The menus are mostly simple; if you get the message
  182. "Premature end-of-file", it is possible that you are trying to load a PCW or
  183. CPC font file on a Spectrum, in which case you should "ignore" the error. It is
  184. possible to load just a few characters from a font by the following procedure:
  185.  
  186. 1. From "Whole font" mark a section of the font. (+3: select the font you want
  187.                                                      to load characters into).
  188. 2. Leave "Whole font".
  189. 3. Press L to load. Then select "Marked section".
  190.  
  191. SAVING:
  192.  
  193.   Press S to save.
  194.  
  195. LEAVING:
  196.  
  197.   Press ESCAPE (BREAK,EXIT). The character set being edited remains as the
  198. current CP/M character set.
  199.  
  200.   The illustration below shows an example screen from ALTER, with a typical
  201. menu. Captions are written in a sans-serif font.
  202.  
  203. $@manual1.pic$
  204.  
  205. Version 1.02 of ALTER contains the following improvements:
  206.  
  207. 1. The bug fixes mentioned above.
  208. 2. Support for CPC6128 computers (not tested).
  209. 3. Bold; Doublestrike; Italic; Outline.
  210. ________________________________________________________________________________
  211.  
  212. Use of ALTER for LocoScript 1 screen characters:
  213.  
  214. To set up: Using the f3=Copy file option in LocoScript, copy the following
  215.           files from your CP/M master disc to a blank disc:
  216.  
  217.   J(number)CPM3.EMS (or .EMT)    SUBMIT.COM
  218.  
  219.   and the following files from this disc:
  220.  
  221.   SETFONT.COM      ALTER.COM     PROFILE.SUB
  222.  
  223. You have now set up the ALTER disc. When you have finished, follow this
  224. procedure every time you want to edit the screen characters:
  225.  
  226. 1. Copy the EMS (or EMT) file on your start-of-day disc (called perhaps
  227.   J20LOCO.EMS or J50LOCO.EMT) to a file on drive M: called LOCO.STD.
  228. 2. Copy it from drive M: to your ALTER disc.
  229. 3. Hold down [SHIFT] and [EXTRA] and press [EXIT].
  230. 4. After a short pause ALTER will start as usual. Don't change character no. 0.
  231. 5. Before leaving, save the changed character set as M:LOCO.UDG
  232. 6. When you have finished, leave with [EXIT]. When the disc drive has stopped,
  233.   you will see the symbol A>. Insert a LocoScript start-of-day disc, hold down
  234.   [SHIFT] and [EXTRA] and press [EXIT].
  235. 7. Copy the file LOCO.STD from the ALTER disc to drive M:, renaming it to
  236.   J20LOCO.EMS or whatever it was.
  237. 8. Copy it back to your start-of-day disc, hold down [SHIFT] and [EXTRA] and
  238.   press [EXIT].
  239. ________________________________________________________________________________
  240.  
  241.