home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / font143 / README.ASC
Text File  |  1995-02-07  |  8KB  |  218 lines
  1. Psion 3a Fonteditor v1.41 (05/11/94)
  2. ===================
  3.  
  4. Software is copyright Steve Godfrey.
  5.  
  6. This file must accompany all copies of this software.
  7.  
  8. This program is SHAREWARE. You may use it for a period of upto
  9. 30 days, but if you continue to use it you must register it.
  10. This can be done by sending 5 UK pounds to:
  11.  
  12.  Steve Godfrey
  13.  12 Linden Place
  14.  Mitcham
  15.  Surrey
  16.  CR4 4EY
  17.  England
  18.  
  19. email: stevegodfrey@cix.compulink.co.uk
  20.  
  21. I will attempt to implement any suggestions made by registered users.
  22.  
  23. Additional features are available to registered users, and more will
  24. appear from time to time.
  25.  
  26. Installation:
  27. -------------
  28.  
  29. Install the following files on your 3a, in the stated directories.
  30. Any disk(s) can be used.
  31.  
  32.   \APP\Fontedit.opa       - the application
  33.  
  34.   \APP\Fonted\Copybit.bin - machine code routines
  35.  
  36.   \FON\Beton13.fon        - font to test program with
  37.  
  38.   \APP\Fonted\Fonted.hlp  - the help file. Only copy this if you require
  39.                             online help
  40.  
  41.   \OPO\Sys$help.opo       - the opl help module. You may already have
  42.                             a copy of this on your 3a
  43.                             Only required if you want online help.
  44.  
  45. ********* IMPORTANT NOTE FOR ARCHIMEDES/POCKET FS USERS: ***********
  46.  
  47.   \OPO\Sys<help.opo       - A copy of Sys$help for Archimedes users.
  48.                             Due to the fact that Archimedes cannot
  49.                             have a $ in a filename, even with zipfiles,
  50.                             use this file instead. Make sure it is
  51.                             called Sys$help.opo when copied to the
  52.                             Psion 3a. (PocketFS should insert the $
  53.                             for you. PC/MCLINK users ignore this file.
  54.  
  55. Install the application as normal. Any available fonts should be listed
  56. under the fonted icon.
  57.  
  58. Note: The example font was obtained from a selection of fonts converted
  59. ===== from the Amiga by M.Schuster (ns103@fim.uni-erlangen.de). It is
  60.       however, possible to create such fonts using this program with
  61.       time and effort! You can of course, use this program to modify
  62.       exisiting fonts for your own use.
  63.  
  64.  
  65. Keys: (Certain features are only available to registered users).
  66.  
  67. From main display:
  68.  
  69.         Psion-o : open font file
  70.   Shift-Psion-r : load font from ROM
  71.         Psion-x : Exit program
  72.         Psion-s : save font
  73.         Psion-a : save as
  74.         Psion-p : save as pic file
  75.         Psion-n : create new font
  76.         Psion-h : Alter height of font
  77.         Psion-i : Invert whole font
  78.         Psion-c : Clear font
  79.         Psion-d : Delete character
  80.         Psion-v : Show version
  81.         Psion-q : Register
  82.         Psion-b : Alter baseline position
  83.         DIAM    : Edit current character
  84.  
  85. Additional main functions for registered users:
  86.  
  87.         Psion-f : Alter/view font info
  88.         Psion-r : Alter range of characters defined in font
  89.         Psion-k : Compress font - removes any undefined characters from the
  90.                   low and high end of the font, to save space. Only works on
  91.                   normal fonts, as fast fonts have all 256 characters stored
  92.                   regardless of whether they are defined or not.
  93.   Shift-Psion-b : Convert BBC font to psion font
  94.  
  95. Edit display keys:
  96.  
  97.         Psion-w : Alter width of character
  98.         Psion-c : Clear character
  99.         Psion-i : Invert character
  100.         Psion-x : Exit program
  101.         Psion-+ : Next character
  102.         Psion-- : Previous character
  103.         DIAM    : Return to main display
  104.  
  105. Additional edit functions for registered users:
  106.  
  107.         Psion-b : Bring (import) bitmap from another character
  108.                   This is useful for example, to create an R.
  109.                   Bring in the definition of a P and most of the
  110.                   work is done! Same with O/Q, I/T etc.
  111.                   You will be asked for a character to copy from.
  112.                   Either type a single letter/digit to be copied,
  113.                   or type a two/three digit decimal number, or
  114.                   hex preceeded by $. ie. if you type 1 character,
  115.                   it takes the ascii code of the character and copies
  116.                   that character. If you type more than 1 character,
  117.                   it tries to evaluate what you type to get the ascii
  118.                   code to copy from.
  119.  
  120.         Psion-g : Open/Close gap. This effectively lets you delete
  121.                   or insert rows/columns in the character. This works
  122.                   in a similar way to the same function in the
  123.                   spreadsheet, except that you can open/close to
  124.                   any of the four sides of the cursor. You will be
  125.                   asked for the type of gap, open/close, and the
  126.                   direction, left/right/up/down.
  127.  
  128. More features will appear in later versions.
  129.  
  130. Editing fonts:
  131. ===================
  132.  
  133. The DIAM key toggles between the full font and character edit mode.
  134.  
  135. When a font is loaded, the program will display all the characters
  136. in the font along with the character bounding boxes in grey. The
  137. cursor will indicate the selected character. You can select
  138. other characters using the cursor keys or by pressing the character
  139. required. Undefined characters within the fonts character range
  140. are shown as grey blocks.
  141.  
  142. If the font is too large to fit all characters on the screen at once,
  143. the characters will scroll as required.
  144.  
  145. If you try and edit an undefined character, you will be asked if
  146. you wish to create it, and if so, you can enter the character width.
  147. Note that FAST fonts are limited to widths of 8 or less.
  148.  
  149. Press DIAM to edit the currently selected character. A charcter edit
  150. box will appear, the scale of which depends on the height and/or width
  151. of the font. Use the cursor keys to move the cursor around the edit box,
  152. and TAB to toggle a bit on or off. Use shift-cursor keys to set pixels
  153. as the cursor moves, and psion-cursor keys to clear pixels as the cursor
  154. moves.
  155.  
  156. The baseline of the font will be shown as a black/grey line. 
  157.  
  158. To select another character, either press the appropriate key, or use
  159. Psion+/-
  160.  
  161. To return to the main display use the DIAM key.
  162.  
  163. When loading fonts from ROM, do not press TAB on the file selector as this
  164. will reset the current path - this is an operating system 'feature'.
  165.  
  166. Some of the font files in ROM are multiple font files. If you load one of
  167. these, you will be shown the names of the fonts contained in the file.
  168. Select the one to load and press enter.
  169.  
  170. Creating a new font
  171. ===================
  172. Select Psion-n. You will be asked the following:
  173.  
  174. Fontname  - upto 16 characters. This is stored inside the fontfile, and
  175.             does not have to be the same as the font filename.
  176.  
  177. Fonttype  - Normal or Fast. Fast fonts are stored with one byte per character
  178.             per row, taking up more room, but making for faster display.
  179.             Fast fonts are limited to character widths of 0 to 8.
  180.  
  181. Low char  - Lowest character code used by the font (0 to 255)
  182.  
  183. High char - Highest character code used by the font (0 to 255)
  184.  
  185. Press enter to continue or esc to quit create new font
  186.  
  187. You will then be asked:
  188.  
  189. Spacing   - Proportional or fixed. If proportional, the program intelligently
  190.             works out suitable spacing for all the characters for you, with the
  191.             widest character determined by max width. You can of course alter
  192.             them yourself. If fixed, all the characters have the width as set
  193.             by max width.
  194.  
  195. Max Width - Sets the width of all characters on fixed spacing, or the maximum
  196.             width of characters on proportional spacing.
  197.  
  198. Height    - Height of font in pixels.
  199.  
  200. Descender - Number of pixels below baseline.
  201.  
  202. Pressing enter confirms the new font, and you can then start creating it.
  203.  
  204. ===============================================================================
  205.  
  206. Using fonts in your own programs:
  207.  
  208. From OPL, your fonts can be used as follows:
  209.  
  210. PROC test:
  211.   global fo%
  212.   fo%=gloadfont("\fon\Myfont.fon")
  213.   gfont fo%
  214.   gat 0,120
  215.   gprint "Hello there"
  216.   get
  217. ENDP
  218.