home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / fonts / a_q / fontpool / PoolNB! < prev    next >
Text File  |  1995-01-12  |  7KB  |  114 lines

  1. FontPool v0.12
  2. ------------------------
  3. Eirik Hansen © 1994/1995
  4. ------------------------
  5.  
  6. This utility is Shareware! It means that you should READ AND OBEY THE TERMS STATED AT THE END OF THIS FILE!
  7.  
  8. -------------------------------------------------------------------------------
  9. Enclosed files:
  10. - - - - - - - -
  11.    FontPool    The FontPool module
  12.    PoolNB!     This file
  13.    PoolSWIs    How to interface with FontPool
  14.    !Ex-BASIC   A BASIC example-app showing how to use FontPool
  15.    !Ex-C       A C example-app showing how to use FontPool
  16.    PoolHelp    Help for those of you who have !StrongEd (!StrongHlp)
  17.  
  18. ===============================================================================
  19. FontPool ..in general:
  20. ----------------------
  21. FontPool provides applications with a flexible and sophisticated font-menu. Here are the pros at a glance:
  22.    * Reduces the developement-time for the programmer.
  23.    * The user spends less time locating the wanted font.
  24.    * Programs start up quicker.
  25.    * Reduces memory-consumption.
  26.    * RISC OS 2 compatible.
  27.    * Prettier.
  28.    * More flexible.
  29.  
  30. FontPool can be regarded as a centralised font-menu. An unlimited number of applications have access to the same font-menu - a menu that is rebuilt whenever there is a change in the number of available fonts. This approach uses far less memory than if every application stored its own separate font-menu internally. It also means that a second application starts up MUCH faster since the font-menu is already present. (Font_ListFonts is a call that can take an horrendous amount of time under RISC OS 2. - Try running two copies of either !Ex-ample and see how fast it starts up the second time!)
  31.  
  32. Two things was emphasised during developement: how the menu should be presented, and how fast it would be to access. The best compromise is hopefully achieved through FontPool. Eg:
  33.  
  34.    The menu is generated so as to occupy very little screen-area (and will thus
  35.    be faster to access).
  36.  
  37.    The font-families will always be sorted alphabetically whichever the version
  38.    of the FontManager.
  39.  
  40.    If there are more than a certain (configurable) amount of font-families
  41.    available, FontPool will 'alphabetize' the menu-entries. This means that you
  42.    are highly unlikely to ever get a font-menu that does not fit on the screen
  43.    and thus needs a scrollbar.
  44.  
  45.    You will never see items with 'superflous' sub-menus. Entries such as
  46.    Dingbats will always be shown as a simple 'Dingbats' in the menu, as opposed
  47.    to 'Dingbats ⇨ (Plain)'. This means that you will immediately see that the
  48.    font is only available in one type - you do not have to open a submenu to
  49.    find '(Plain)' or '(Regular)' to establish the fact that the font only comes
  50.    in a single type.
  51.  
  52.    The font-menu will never contain more than 3 sub-menus if it is alphabetized,
  53.    and 2 sub-menus if it is not. This is to reduce menu-traversal since many
  54.    fonts actually can be broken down to 4 and even 5 sub-menus (such as New ⇨
  55.    Century ⇨ Schlbk ⇨ Bold ⇨ Italic).
  56.  
  57.    The colour used to show the currently selected font (as well as those that
  58.    are not selected) can also be specified. This will be useful as an
  59.    'eye-catcher' in a long menu.
  60.  
  61.    The menu-font can be an anti-aliased one. 
  62.  
  63.    Totally hand-coded in assembler.
  64.  
  65.  
  66. You are encouraged to distribute FontPool amongst programmers, but then make sure that ALL files are included in their original UNMODIFIED state. Shareware libraries are also welcome to include FontPool.
  67.  
  68. Those of you who are fortunate users of !StrongEd can take advantage of the supplied !StrongHelp data which was meant only for my personal reference. But why shouldn't you be able to browse as quickly as I can? Anyway, drag the directory 'PoolHelp' into !StrongHelp's HelpData directory and the information is yours. It is basically the same info as you'll find if you read 'PoolSWIs' but easier to locate.
  69.  
  70. ===============================================================================
  71. Terms of use:
  72. -------------
  73. FontPool costs nothing unless you use its facilities in a program. Once you do, you should decide what category your program fall under (see below) and pay at least this minimum charge. If you find FontPool exceptionally useful you are of course welcome to pay more, and if this sum is at least MinimumCharge+£5 you will automatically receive the next version of FontPool as soon as it becomes available. To prevent the nuicance of royalties I have adobted the following scheme:
  74.  
  75. Personal use:
  76. -------------
  77. If you are using FontPool in your own personal programs or programs that are distributed free of charge, you should pay a minimum of £5. This sum covers ALL such programs that originate from the buyer.
  78.  
  79. Shareware:
  80. ----------
  81. If you are using FontPool in Shareware programs, or any type of program you charge for, you should pay at least £10. This sum covers ALL such programs that originate from the buyer, and also those mentioned under 'Personal use'.
  82.  
  83. An alternative is a swap. If you have produced something that you think I might find useful (and with a low bug-count) we could do an old-fashioned swap. (Then let me know what it is through Arcade before sending anything.)
  84.  
  85. Commercial:
  86. -----------
  87. If you are using FontPool in a commercial application it costs £20 for each DIFFERENT application using it. The application's name must then be given when registering (see below). £50 buys the right to use FontPool in all present and future commercial applications that originate from the buyer.
  88.  
  89.  
  90. NOTE that if FontPool is used as a part of a program that is distributed as public domain, Shareware or any such derivative, FontPool may be enclosed in two ways:
  91.  
  92.  - You state clearly in your documentation that your program utilises
  93.    FontPool's font-menu facilities and that FontPool is a Shareware utility.
  94.    Also it should say from what general source your copy of FontPool originated
  95.    (what BBS or Shareware library). You are then allowed to enclose JUST the
  96.    FontPool module by itself with NONE of the other files.
  97.  
  98.  - You enclose a FULL copy of FontPool with ALL associated files in an
  99.    UNMODIFIED state.
  100.  
  101.  
  102. To register as a FontPool user, state your program's category and send money to the following address:
  103.  
  104.    Eirik Hansen
  105.    Industriveien 12
  106.    8500 Narvik
  107.    Norway
  108.  
  109. I can also be contacted at Arcade where I'm user #440 (private mail please). Your comments and suggestions are very much appreciated! Especially if you think there are dissuasive shortcomings that prevents you from using FontPool.
  110.  
  111. By the way, as I cannot afford scanning all BBSs for useful (programming) utilities, could anyone direct my attention to USEFUL! things that surfaced sometime after, say may '94?
  112.  
  113.    Eirik
  114.