home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 188.lha / showfont.doc < prev    next >
Text File  |  1988-04-28  |  11KB  |  198 lines
  1.                      ShowFont 3.1 - by Arthur Johnson Jr.
  2.                      ====================================
  3.  
  4.                           Last update date - 11/27/88
  5.                           ---------------------------
  6.  
  7. ****************************************************************************
  8. * To see just the changes since revision 3.0, check out the brand new      *
  9. * "Revisions n' Updates" section at the end of this documentation!         *
  10. ****************************************************************************
  11.  
  12.      This program allows you to quickly and painlessly view all 256
  13. characters in a typical font.  I wrote it because using FontEd or (choke!)
  14. NotePad to see what a font looks like can be slow, tedious, monotonous, etc.
  15.  
  16.      To use this program, simply type "ShowFont [font_name] [font_size]".
  17. Both the [font_name] (Topaz, Ruby, etc.) and [font_size] (8, 12, etc.) are
  18. purely optional.  If you do not specify a size, ShowFont will check all your
  19. available fonts and then show you what sizes/styles of the font you wanted
  20. exist.  If you also omitted the font, you can select what font/size/style to
  21. see by using the font requester.  More on this below.  Note that you
  22. currently cannot select a [font_style] to see.  You must do this through the
  23. requester.
  24.  
  25.      By the way, if someone makes an icon for this program, it might just
  26. run from WorkBench.  Since I never use WorkBench, I haven't bothered testing
  27. this.  (Version 3.1 note: I still haven't bothered)
  28.  
  29.      So, what's the font selector like?  Well, I've tried to make it pretty
  30. standard, including all the neat features most of the better ones have.  To
  31. select a font, size, or style, simply click on it with the left button.
  32. When you have the desired font, size, and style selected, press the OK
  33. button.  You can now (3.1) just double-click on the font, size, or style to
  34. view the font, size, and style you like.
  35.      To scroll around the font, size, and style lists, click on the arrows
  36. or slider gadgets.  Since you've probably used their like in other programs,
  37. you probably already know what they do.  Note that you can hold down the
  38. left button over these gadgets and the list will scroll rapidly in the
  39. direction of the arrow you're over.  You can also do this with the slider
  40. gadget and move up and down to scroll over the whole list.  Because I cannot
  41. find a way to determine when to stop updating everything when you're using
  42. the SLIDER gadget, the gadgets will continue flickering even when you let up
  43. on the button.  Just click somewhere and this will stop.  Yes, to stop the
  44. scrolling, release the left button.
  45.      If you decide you really don't want to look at a different font than
  46. what you had been checking out, press the CANCEL button.
  47.  
  48. /**************************************************************************/
  49. /*      Because most everyone changes their Preferences colors, the       */
  50. /* colors I mention below might not be correct for your system.  Just     */
  51. /* translate what the colors should be on your system (if you've changed  */
  52. /* them).  The original colors were blue, white, black, and orange (in    */
  53. /* order of how you can change them in Preferences).  Just look to see    */
  54. /* what your colors are where and things should be pretty easy to         */
  55. /* understand.  Then again, they may not.                                 */
  56. /**************************************************************************/
  57.  
  58.      If the sizes of the font you've selected are printed in WHITE, the
  59. font is non-proportional (TOPAZ).  If they are printed in ORANGE, they are
  60. proportional (most everything else).  I added this so you can easily see
  61. what fonts you may have are non-proportional, since they are real nice when
  62. trying to make tables and stuff that needs to be columnarly [sic?]
  63. organized.  If you don't understand what I'm talking about, non-proportional
  64. fonts take up the same number of pixels per character, i.e., an 'i' takes
  65. as much space as an 'm'.  Proportional fonts space the characters according
  66. to how wide they are, i.e., an 'i' would definitely take less space to
  67. write than an 'm'.  Don't know what a pixel is?  Pixels are the small dots
  68. that can be seen if you press your face to your terminal screen.  What's
  69. a terminal screen?  Well, etc., etc.
  70.  
  71. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  72. The above explanation is a perfectly good RECURSIVE DEFINITION example.
  73. But anyway, back to the documentation.
  74. ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  75.  
  76.      Clicking CANCEL when you've just booted the program without any default
  77. font will cause the program to display TOPAZ 11 (if it exists).  I don't know
  78. why it doesn't use TOPAZ 8.  I've tried to tell it to many times and in many
  79. ways, but it ignores me.  C'est la vie.  But you would never do that anyway,
  80. would you?  Someday, I'll try to track down and eliminate this one-time
  81. fault.
  82.  
  83.      * NOTE * ShowFont looks in the FONTS: directory for all its fonts.
  84.  
  85.      For a change, I think I will try to organize this documentation a bit
  86. by listing all the menus and what each selection does.  If this is too
  87. orderly for you, please call and tell me and I'll try to make it more
  88. confusing next time.
  89.  
  90. Menu    - Option           What is it?
  91. --------------------       -----------
  92. Project - About            Gives some useless information about the program.
  93. Project - Quit             Exits the program.
  94.  
  95. Fonts   - Read FONTS:      Reads in all the available fonts again.  To make
  96.                            this a useful option, you'd have to push ShowFont
  97.                            into the background and re-ASSIGN FONTS: somewhere
  98.                            else.  I usually just quit ShowFont, ASSIGN
  99.                            FONTS:, and then re-run ShowFont to avoid any
  100.                            confusion.  I might remove this feature in future
  101.                            versions, unless I receive some input to keep it.
  102. Fonts   - Font Selection   Brings up the font selecting requester.
  103.  
  104. Screen  - 320 x 200        Changes the screen size to 320 x 200.
  105. Screen  - 320 x 400        Uhm...
  106. Screen  - 640 x 200        Duh...
  107. Screen  - 640 x 400        ???...
  108.  
  109.      Notice that all the menu options except the 'Screen' menu stuff have
  110. short key-equivalents, i.e., you can press Right Amiga-? to select that
  111. menu selection, where ? is whatever letter is displayed after the neat
  112. Amiga symbol in the menu.
  113.  
  114.      If the font is found, ShowFont will display "font_name-font_size" in
  115. the upper left-hand corner of the screen next to the CLOSE gadget.  To see
  116. the rest of the font (if all 256 characters cannot fit on the screen at
  117. once), use the three gadgets on the right-hand side of the screen.  Again,
  118. their function closely resembles their appearance.  Fiddle around for about
  119. three seconds and you will be quite familiar and comfortable with scrolling
  120. around a font.  Again, you can just hold down the button and scroll happily
  121. in whatever direction you like.  And again, the slider gadget flickers
  122. happily after you do this until you click on something.
  123.  
  124.      Note that actually all 256 characters will not be displayed if there
  125. are blank (empty) characters.  The program will skip them, since they are
  126. rather uninteresting, being blank.  The program will display that segment
  127. of the characters that the font says should be displayed.  Two-to-one
  128. someone has some neat secret graphics just outside the official display
  129. range, but we'll never know.
  130.  
  131.      To exit the program, click on the CLOSE gadget or select the menu
  132. "Quit" option or press Right-Amiga-Q.  I like three ways to end a program!
  133. Actually, you can also end the program by:
  134.      1) Control Amiga-Amiga
  135.      2) Turning off your computer's power
  136.      3) Striking the system with great force with a large, blunt object
  137. That now makes a total of six ways to terminate the program.  I'm sure
  138. clever people will find even more imaginative and useful ways to end the
  139. font session.
  140.  
  141.      I guess the best advice I can give you for using and understanding this
  142. program is to type 'showfont' from CLI and fiddle around for a while until
  143. you either comprehend all the features or delete the program in a fit o'
  144. passion.  In fact, most bugs are detected this way through random menu and
  145. gadget selecting.  Thank you to the person who detected and called about the
  146. 'Read FONTS:' problem!  It gave me practice on using the new Lattice C 5.0
  147. source-level debugger.  Neat program.  But, anyway...
  148.  
  149.      I'll apologize now for this rather random and odd documentation file,
  150. but I'm usually dazed and confused after my program successfully runs
  151. without any apparent bugs.  On a technical note, the Lattice 5.0 C "big"
  152. compiler and global optimizer compiled this program without comment.  I like
  153. that.
  154.  
  155.      I would like to thank the National Type Foundry for sending me some
  156. fonts (because they are distributing my program with their product).  They do
  157. have some really nice fonts in the Roman collection.  C. Ltd. was also
  158. going to send me some information for new STYLE conventions they were
  159. petitioning Commodore for, but I never received them and lost the number and
  160. who to contact.  Maybe next time. 8-)
  161.  
  162.      By the way, ShowFont fails with some random error code when you use
  163. 'run ShowFont ...'.  Anyone know why?  It doesn't seem to affect the program
  164. or system in any way.
  165.  
  166.      That's it!  Any comments/questions/suggestions/flames/improvements/
  167. etc., can be directed to the following address:
  168.  
  169.                        *****************************
  170.                        * Arthur Johnson Jr.        *
  171.                        * 225 Montego Bay Court     *
  172.                        * Merritt Island, FL  32953 *
  173.                        *                           *
  174.                        *          - or -           *
  175.                        *                           *
  176.                        *      (407) 277-0548       *
  177.                        *****************************
  178.  
  179. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  180.      I guess I should add that this program and source are PUBLIC DOMAIN in
  181. all ways, except that if you dare to sell this program by itself for fun n'
  182. profit, you will be found and terminated.  Other than that, feel free to do
  183. whatever you like with the program, although give me some credit somewhere...
  184. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  185.  
  186.                              Revisions n' Updates
  187.                              --------------------
  188.  
  189. Version 3.1 : Fixed a bug in the 'Read FONTS:' menu selection.
  190.               Added "double-clicking" selection method.
  191.               Cleaned up the documentation a bit.
  192.  
  193. Version 3.0 and below : These records were destroyed in the great fire,
  194.                         earthquake, plague, hurricane, tsunami, volcanic
  195.                         eruption, insect infestation, computer virus, and
  196.                         alien attack of 1988.  We apologize for any
  197.                         inconvenience this may cause.
  198.