home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / b / bbcfonted / !BBCFontEd / !Help < prev    next >
Text File  |  1995-10-09  |  12KB  |  291 lines
  1. --------------------------------------------------------------------------
  2.                !BBCFontEd (v1.05)  --  © Graham Hick, 1995
  3. --------------------------------------------------------------------------
  4.  
  5. === 1. Introduction ======================================================
  6.  
  7. BBCFonted is a desktop utility which lets you design new system fonts, and
  8. load and edit old ones. A new system font can make quite a difference to
  9. the niceness of your desktop. It's cheaper than buying a Risc PC, and it's
  10. more reliable (and faster, if you have an old machine) than the various
  11. outline-fonts-on-the-desktop patches that are about.
  12.  
  13. If you don't want to read all this documentation, then at least go down to
  14. the end where it says how to get in touch with me.
  15.  
  16.  
  17. === 2. Conventions =======================================================
  18.  
  19. Here are some terms I have used in this help file, with their
  20. explanations:
  21.  
  22.   * Current font: The font stored within BBCFontEd. Independent of the VDU
  23.     font (q.v.)
  24.  
  25.   * VDU font: The font held by RISC OS in some internal workspace, which
  26.     it uses when it wants to (re)draw text on the screen. Thus when I talk
  27.     about getting characters from the VDU, or sending a font to the VDU,
  28.     this is the place I mean.
  29.  
  30.   * Alphabet: A set of standard character definitions held within the
  31.     International module of RISC OS. Can be set using '*Alphabet'. The
  32.     default is usually Latin1. See the RISC OS User Guide for more
  33.     details.
  34.  
  35.  
  36. === 3. Getting Started ===================================================
  37.  
  38. The program should be loaded in the usual way, i.e. double-click on the
  39. BBCFontEd icon in the filer window. When the program starts, after a while
  40. (sorry) the main window, containing the characters of the current system
  41. font, will appear.
  42.  
  43.  
  44. === 4. File Operations ===================================================
  45.  
  46. 4.1 Loading a font
  47.  
  48.     To load a pre-defined font, you have to drag its file icon to the
  49.     BBCFontEd icon or main window. Double-clicking will load the font onto
  50.     the screen in the normal way.
  51.  
  52. 4.2 Saving a font
  53.  
  54.     Well, pretty standard I think. (Save is in the 'File' submenu in case
  55.     you couldn't find it.) Drag the font icon to a directory display, or
  56.     type a full filename into the box and press RETURN or click 'OK'. All
  57.     the defined characters are saved, in ascending order.
  58.  
  59.  
  60. === 5. Character Operations ==============================================
  61.  
  62. 5.1 Editing a character
  63.  
  64.     To change the appearance of an individual character, either double
  65.     click on it, or select 'Edit' from the 'Char...' submenu. The
  66.     functions in the Edit window should hopefully be self-explanatory. For
  67.     an explanation of the purpose of the 'description' of a character, see
  68.     below.
  69.  
  70.     When you change a character definition, the character in the main
  71.     window goes red.
  72.  
  73. 5.2 Deleting a character
  74.  
  75.     Not all characters have to be defined. To remove a definition from the
  76.     loaded font, select 'Delete' from the 'Char...' submenu. The character
  77.     in the main window goes grey.
  78.  
  79.     The reason you might want to delete characters is that, for example,
  80.     you may only want the normal (32-126) characters to be changed by a
  81.     new font file.
  82.  
  83.     Note that because of the way BBCFontEd works, the actual bitmap of the
  84.     character is not lost. If you double click on it again, and change it,
  85.     the character will be 'undeleted' and go back to red again.
  86.  
  87. 5.3 Reloading a character
  88.  
  89.     Single characters can be extracted from the VDU by selecting the 'Get
  90.     from VDU' option from the 'Char...' menu. Similarly, should you mess
  91.     up a single character in a font file which is kept on disk, you can
  92.     restore it by selecting 'Get from file' from the same menu.
  93.  
  94. 5.4 Copying characters
  95.  
  96.     You can copy one character definition onto another, by dragging the
  97.     picture of the character in the main window onto another character.
  98.     This is quite a good way to mess up a font quickly, so beware!
  99.  
  100.  
  101. === 6. Other features ====================================================
  102.  
  103. 6.1 Loading OS fonts
  104.  
  105.     The 'All chars' submenu contains facilities for extracting fonts from
  106.     the operating system. The first option, 'Get from VDU', reloads the
  107.     current system font into BBCFontEd. The 'Get ISO Alphabet' options are
  108.     similar, except that they load the standard ISO alphabets, and also
  109.     reload the relevant character definition file from the BBCFontEd
  110.     directory - see later.
  111.  
  112. 6.2 Updating the VDU font
  113.  
  114.     The 'Send to VDU' option on the main menu does just that - it updates
  115.     the VDU with the characters defined in BBCFontEd's buffer. The screen
  116.     is redrawn by a call to SWI Wimp_ForceRedraw. Note that characters
  117.     used by Zap (the excellent text editor by Dominic Symes) are not
  118.     immediately updated - you need to do Options -> Ctrl chars -> Default
  119.     from Zap's icon-bar menu.
  120.  
  121. 6.3 Character Descriptions
  122.  
  123.     This feature provides a wordy description of what each character
  124.     should look like, according to Acorn's interpretation of the ISO
  125.     8859/x standards, plus certain extensions, which apply to the
  126.     'dubious' characters between 128 and 159. These are not defined by
  127.     ISO, and therefore differ on various systems (RISC OS outline fonts,
  128.     TrueType, Apple Mac <spit>, etc.). This means that in Latin1, we get
  129.     things like W- and Y-circumflex (for Welsh), 'sexed' (yes really)
  130.     quotes (“ ” ‘ ’) and ligatures (fi fl æ œ).
  131.  
  132.     The information for these descriptions came from
  133.     Resources:$.Fonts.Encodings plus some personal knowledge. This is the
  134.     reason I haven't done the other (Hebrew, Cyrillic) alphabets yet -
  135.     they don't have an Encodings file, and I know nothing about them.
  136.  
  137.     Please note:
  138.  
  139.       * A diaeresis is a technical (or less specific to Germanic
  140.         languages) term for an umlaut (¨) symbol.
  141.  
  142.       * A guillemot (apart from being a sea-bird) is apparently a quote
  143.         character used in French, eg «Bonjour!». Although this is the
  144.         PostScript name for the character, I am not convinced. It's not in
  145.         any English dictionary I can find, and the closest thing in a
  146.         French dictionary is 'guillemet' which means 'inverted comma' or
  147.         something like that. If anyone has any better ideas, please let me
  148.         know...
  149.  
  150.  
  151. === 7. Version history ===================================================
  152.  
  153. 1.00 (18 Apr 1994)
  154.  
  155.   * First release version.
  156.  
  157. 1.01 (30 Jul 1994)
  158.  
  159.   * Templates redesigned slightly. RISC OS 2 and 3 versions sorted out.
  160.   * High and low res sprites sorted out, including proper 'Rotate' icon.
  161.   * The rotate button now rotates the character the right way.
  162.   * 'Clear' now works.
  163.   * Behaviour on shutdown is now almost right!
  164.   * Load routines tidied up.
  165.  
  166. 1.02 (28 Sep 1994)
  167.  
  168.   * Added some shadow to the app icon.
  169.   * Added file info window.
  170.   * Added support for all Latin fonts.
  171.   * Improved this documentation.
  172.  
  173. 1.03 (04 Jan 1995)
  174.  
  175.   * Changed the app icon (again).
  176.   * I found that calling SWI Wimp_SetIconState 64 times to redraw the
  177.     character definition was too slow and clunky. Now using
  178.     Wimp_ForceRedraw instead.
  179.   * Tidied up sprites/templates slightly, and got rid of 2D templates, as
  180.     they didn't seem to be worthwhile.
  181.   * Fixed a couple of obscure bugs related to loading alphabets.
  182.   * Added ISO Greek alphabet support
  183.   * Fixed spelling of 'diphthong' and 'diaeresis' in Latin alphabets.
  184.   * Added Flip controls.
  185.   * Support for interactive help introduced.
  186.   * Added significant amounts to this documentation.
  187.   * Implemented RAM transfer on save.
  188.   * Added drag-and-drop feature for individual characters.
  189.   * Added proper dialogue box to prompt the user to save/discard an
  190.     altered font, instead of the Wimp error box.
  191.  
  192. 1.04 (12 Apr 1995)
  193.  
  194.   * Completed the interactive help support, and moved all the text into
  195.     a Messages file.
  196.   * Improved and reformatted the documentation.
  197.   * Tidied lo-res !Sprites file.
  198.   * Added support for the apparent Acorn standard which requires Adjust on
  199.     close button to open filer window. Shift-Adjust doesn't close the
  200.     window.
  201.   * Added support for the 'Bfont' alphabet. I know nobo