home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / fonts / a_q / chred / !ChrEd / !Help next >
Text File  |  1995-02-18  |  11KB  |  235 lines
  1.  !ChrEd
  2.  ¯¯¯¯¯¯
  3.  System font design utility
  4.  Written by D. Salt
  5.  Version 2.07, 18 February 1995
  6.  
  7.  This is a !Help-ful application which allows you to edit as many fonts as
  8. there is memory for at any one time (well, up to 16 anyway).
  9.  
  10.  ChrEd installs itself on the right hand size of the iconbar.
  11.  
  12.  Before you read any further, click once on the ChrEd icon and toggle the
  13. window you've just opened to its full size. The title of the window should be
  14. <Untitled>.
  15.  
  16.  The 'current font' is the font in the editing window with the input focus.
  17.  
  18.  The editing window initially displays the edit character (the magnified
  19. image); below left, the normal size version (black on white), which reflects
  20. any changes made to the image above; below right, the currently selected
  21. character (red on cream), which is not affected. Off to the left and below
  22. are various processing options; to the right, the font display and character
  23. selector; below that, two options that decide whether the processing icons
  24. affect the current character or the whole set.
  25.  
  26.  New features
  27.  ¯¯¯¯¯¯¯¯¯¯¯¯
  28.  The save box settings (range of characters to be saved) are set up for you
  29. when you load a font or merge two together, and stored when you save the
  30. font.
  31.  
  32.  Simple editing
  33.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  34.  Just move the pointer over one of the boxes in the edit character and click
  35. Select to set a pixel, or Adjust to clear it.
  36.  
  37.  Storing the edit character
  38.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  39.  If the current character is not the one in which you want to store the
  40. definition of the edit character, then move the pointer to the character you
  41. want in the character set display to the right and click on it. You will
  42. notice that it now appears in white on black instead of red on cream (the
  43. character immediately below, in black on white, is the redefined version, and
  44. may also be clicked on), and that the current character box also displays
  45. this character. By the way, you can't select Delete.
  46.  To store the character, click on the ‘Store’ icon. The character set display
  47. will be updated to show the change.
  48.  If you want to edit the previous definition of the character, click on
  49. ‘Swap’ instead.
  50.  By selecting another character then clicking on ‘Store’ (or ‘Swap’, if
  51. appropriate), it is possible to copy definitions all over the place - even
  52. from one font to another.
  53.  
  54.  Restoring the character to its previous shape and grabbing a new character
  55.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  56.  If necessary, select a character as described above, then click on ‘Grab’.
  57.  If its default shape (as in the standard character set or currently defined
  58. system font) is required, click on ‘Default’.
  59.  
  60.  Slightly less simple editing
  61.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  62.  The edit character can be scrolled (with wraparound) in any direction. Just
  63. click on the appropriate arrow.
  64.  If you want to reflect the character such that ⇦ becomes ⇨, click on ‘Flip
  65. X’. Or, to change ⇧ into ⇩, click on ‘Flip Y’ (and then click on ‘⇧’ - I
  66. couldn't come up with a better example).
  67.  Character rotation is also easy. ‘Rotate ⇨’ rotates the character 90°
  68. clockwise, ‘Rotate ⇦’ rotates the character 90° anticlockwise.
  69.  To logically invert the character (black becomes white, etc.), click on
  70. ‘Invert’.
  71.  You can also start afresh by clicking on ‘Clear’.
  72.  
  73.  The logic operators AND, OR, EOR
  74.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75.  You need to understand a bit about binary and logic operators here. If you
  76. already do, then ignore the following paragraph and the tables following it.
  77.  You may be aware that binary is a number base using only two digits, 0 and
  78. 1. Instead of each column representing 1s, 10s, 100s etc, they represent 1s,
  79. 2s, 4s, 8s etc. You can think of 0 as ‘off’ and 1 as ‘on’, or white and black
  80. - the possible states of each pixel in the edit character and the current
  81. character. The most relevant part is the logic operators. In the following
  82. tables, the digits down the side represent the possible states of a pixel in
  83. the edit character, and the digits across the top represent the equivalent
  84. pixel in the current character. Think of these as coordinates pointing to one
  85. of the remaining four digits, which represents the resulting pixel state.
  86.  AND - 1 if both = 1; OR - 1 if either = 1; EOR - 1 if either, not both, = 1
  87.    ¦ 0  1               ¦ 0  1                ¦ 0  1
  88.  --+-----             --+-----              --+-----
  89.  0 ¦ 0  0             0 ¦ 0  1              0 ¦ 0  1
  90.  1 ¦ 0  1             1 ¦ 1  1              1 ¦ 1  0
  91.  
  92.  Each operator combines the edit character and the current character
  93. appropriately, and stores the result in the edit character.
  94.  
  95.  The Undo facility
  96.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  97.  Clicking on the Undo icon will cause the last store, grab, clear, default,
  98. AND, OR, or EOR operation to be undone. Clicking on it again will reverse the
  99. action.
  100.  
  101.  Altering the whole font in one go
  102.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  103.  Initially, the Character option is selected. In this mode, all the icons to
  104. the left of and below the edit character affect only the edit character.
  105.  Now click on Character set. You will notice that ‘Grab’, ‘Store’, ‘Swap’,
  106. ‘Default’, ‘AND’, ‘OR’, ‘EOR’ and the arrow icons become unavailable. Also,
  107. the remaining icons now affect the whole font. Altering the font in this way
  108. takes a bit longer to do - hence the hourglass.
  109.  The flip, rotate, invert and clear operations take about 1½ seconds on my
  110. A3010.
  111.  
  112.  Selecting another font to edit
  113.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  114.  Simple - just edit it. If you use the shortcuts, it's easy enough to tell
  115. which has the input focus.
  116.  
  117.  Saving a font
  118.  ¯¯¯¯¯¯¯¯¯¯¯¯¯
  119.  Click Menu over the editing window and move the pointer to the right of
  120. ‘Save font’ (for the current font, you can press F3 instead). This will open
  121. the save window, which, for the file icon, the filename entry box to its
  122. right, and the 'OK' button, works in exactly the same way as for any other
  123. application.
  124.  You can tell whether a font has unsaved data because its window title has an
  125. asterisk at the end.
  126.  Using the radio icons, you can select exactly what you want to save...
  127.  'All' selects for saving the definitions for all of the characters
  128. (including DELETE because I couldn't be bothered to remove it);
  129.  'Top bit set': the characters shown in the lower four rows of the character
  130. set display ('€' to 'ÿ');
  131.  'Top bit clear': the rest of the characters (Space to '~');
  132.  'Special': whichever you want - enter them in the input box immediately
  133. below this option.
  134.  Some of you are probably looking at the save box right now, and are noticing
  135. the toggle size icon. Click on it to extend the window to its full size -
  136. you'll see four buttons. When you're entering the characters you want to
  137. save, click on one of these if you want. The buttons are:
  138.  'Normal \': any special meaning the following character may have is ignored.
  139. To include it as a character to save, click on it twice!
  140.  'To -': range of characters, starting with the preceding character, and
  141. ending with the following character. For example, A-Z will select all upper
  142. case letters for saving.
  143.  'Hex ☓': Character code in hexadecimal. There MUST be two hex digits
  144. following this code.
  145.  'Ctrl |': control sequence. Use |@ for ASCII 0, |A or |a for ASCII 1 ... |Z
  146. or |z for ASCII 26, |[ or |{ (27), |\ (28), |] or |} (29), |^ or |~ (30), |_
  147. or |` (31), || (124), |? (127). |! will add 128 to the following character's
  148. code. (This is a subset of the GS format.)
  149.  You cannot select unprintable characters (ASCII code less than 32) for
  150. saving; if you try to select Delete, it will be omitted.
  151.  
  152.  Loading a font
  153.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  154.  There are three ways to load a font: double-click on the file, drag it to an
  155. editing window (merging it with the font present in that window), or drag it
  156. to the ChrEd icon.
  157.  Any BBC font file can be loaded, provided that the file length is non-zero,
  158. no greater than 2240, and a multiple of 10; and each definition must start
  159. with CHR$ 23 then a printable character. You are told about non-printable
  160. characters and duplicate definitions; these are ignored.
  161.  
  162.  Testing a font
  163.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  164.  Select ‘Test font’ from the editing window's menu. The screen will be
  165. automatically redrawn using the font.
  166.  To restore the standard font, select ‘Default font’.
  167.  
  168.  Removing a font
  169.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  170.  Click on its window's close icon. If there is unsaved data, you'll be asked
  171. if you're sure you don't want to save it.
  172.  
  173.  Exiting the application
  174.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  175.  Select ‘Quit’ from the ChrEd icon menu. If there are any unsaved changes,
  176. you will be asked to confirm (‘Discard’) or abandon in order to save the
  177. altered fonts (‘Cancel’).
  178.  
  179.  Shortcuts
  180.  ¯¯¯¯¯¯¯¯¯
  181.  In most cases, clicking Adjust on an icon will perform the reverse action.
  182.  
  183.  | represents SHIFT; ^ represents CTRL; ⇦ ⇨ ⇧ ⇩ represent the cursor keys.
  184.  
  185.   Icon      Key(s)        Icon      Key(s)        Icon       Key(s)
  186.   ----      ------        ----      ------        ----       ------
  187.   Flip X    ^X            Default   ^D F9         Scroll ⇦   ⇦
  188.   Flip Y    ^Y            Clear     ^C Delete     Scroll ⇨   ⇨
  189.   Rotate ⇨  ^Q            AND       &             Scroll ⇧   ⇧
  190.   Rotate ⇦  ^A            OR        +             Scroll ⇩   ⇩
  191.   Invert    ^I            EOR       *             Character  ^O
  192.   Grab      ^G F7 Copy    Undo      F8            Char. set  ^P
  193.   Store     ^S F6 Insert  Swap      ^W F5
  194.  
  195.   Key(s)  Function
  196.   ------  --------
  197.  Font editing window
  198.   ^F2     Close editing window (font file)
  199.   F3      Opens the Save box
  200.   Shift or Ctrl + cursor keys
  201.           Select adjacent character in specified direction from current
  202.           character
  203.  Save box
  204.   F1      Equivalent to pressing RETURN or clicking ‘OK’
  205.   F2-F5   Equvalent to clicking on a radio icon - F2 = all ... F5 = special
  206.   ⇧ ⇩     Move to the other input box (if not greyed out)
  207.   Escape  Close
  208.  
  209.  Within the character set display:
  210.    SELECT or ADJUST to select the character under the pointer
  211.   Doubleclick:
  212.    SELECT to grab the character definition
  213.    ADJUST to store the edited definition
  214.   Shift-doubleclick:
  215.    SELECT to grab the character's default definition
  216.    ADJUST to swap the character definition with the edited definition
  217.  
  218. To use a font, *Print it, or load it somewhere in memory and use
  219.  SYS "OS_WriteN",<load address>,<file size>
  220.  to set it up.
  221.  A definition for Delete is included in files saved using the 'All' option,
  222. though it is never used.
  223.  
  224.  NOTE. If the character you selected for editing does not match the character
  225. displayed in the current character box, then you are either not using the UK
  226. (Latin1) character set, or you've defined your own with different characters
  227. and are using it.
  228.  I have no plans to change this; however, it is easily done - apply !Paint to
  229. the sprite 'chred_map'. The text should be in ASCII order, 32 characters per
  230. line, width=8, height=8, spacing=9. The text must line up perfectly with the
  231. existing text. You will find it easiest to plot in black, globally change red
  232. to cream, then black to red. Don't remove Delete.
  233.  If you made such a change to the sprite 'chred_map0' in an older version,
  234. then save that sprite to the new 'Sprites' file as 'chred_map'.
  235.