home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / printer / pfont.lha / PFont.doc < prev    next >
Text File  |  1990-09-15  |  6KB  |  161 lines
  1.                       PFont © 1990 by Doug McLean
  2.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. PFont will take 8 point non-proportional fonts and download them to
  5. your printer. "Wait", you say, "my word processor lets me use whatever
  6. font I want!".
  7.  
  8. But PFont is different. Usually when you print Amiga fonts on your printer,
  9. they are printed as graphics, not text. PFont changes your printers default
  10. font, so that any text you print, whether from the CLI or wherever, is in
  11. the new font. Of course, the change is temporary, it only lasts until
  12. the printer is reset. There are several restrictions on the fonts that
  13. may be used, see below.
  14.  
  15. There is no fancy intuition interface because I wanted to keep the
  16. program small, and I wanted to be able to put it in my startup-sequence.
  17.  
  18.  
  19. We Interrupt This File For A Brief Word From The Sponsor
  20. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21.  
  22. PFont is copyright 1990 by Doug McLean. You may freely distribute PFont only
  23.  
  24.       - on public BBSs and information services
  25.       - on a disk that contains only freely distributable software
  26.       - at user group and similar meetings
  27.  
  28. No fee may be charged for distribution of PFont, with the exception of
  29. the normal user fees that BBSs and information services charge.
  30.  
  31. PFont may only be distributed in it's original archived form, complete with
  32. all included files. If distributed on disk, it may be uncompressed it's in
  33. it's own directory and complete (it's easier for the user that way).
  34. Feel free to add your own printer config files.
  35.  
  36. If you keep and use PFont, please send two or three disks of 
  37. PD/Freeware/Shareware/Whateverware, or maybe a game you are tired of or
  38. have beaten, to the author:
  39.  
  40. Doug McLean
  41. Apt #203
  42. 242 Regent St.
  43. Fredericton, NB
  44. Canada
  45.  
  46.  
  47. You Need
  48. ~~~~~~~~
  49.   - An Amiga with Kiskstart 1.2 or 1.3.
  50.   - A printer that accepts downloadable fonts. The printer must
  51.     accept 11 bytes of data per character to be defined. Sorry, NLQ
  52.     fonts ae not supported.
  53.   - PFont compatible fonts (see below, several are included).
  54.  
  55.  
  56. Using PFont
  57. ~~~~~~~~~~~
  58.   [1] Copy the compatible fonts to wherever you want them to reside
  59.       (I suggest fonts:).
  60.   [2] Make your config file. Put is in the s: directory (it will also
  61.       work if the config file is in the current directory when you run
  62.       PFont)
  63.   [3] Run the program.
  64.  
  65.  
  66. [1] Fonts
  67. ~~~~~~~~~
  68. Compatible fonts are subject to the following restrictions:
  69.   [a] They ust be 8 point
  70.   [b] They may not be proportional
  71.   [c] They may not have any undefined characters in the range you wish
  72.       to send to the printer
  73. FastFonts has similar restrictions, so if a font works with FF, it
  74. should work with PFont. FF has extra restrictions, so if a font doesn't
  75. work with FF, it still might work with PFont.
  76.  
  77. Many fonts are available that alost eet the restrictions above, but not
  78. quite, for example they are 9 points. You can easily change these with
  79. the font editor on the Workbenck 1.3 extras disk- just change the x size
  80. from 9 to 8. Other minor problems can be corrected too, like undefined
  81. characters. Or you can create your own font from scratch, for example
  82. you may wish to create a special character set for some special
  83. purpose (spell symbols for a game?).
  84.  
  85.  
  86. [2] The Config File
  87. ~~~~~~~~~~~~~~~~~~~
  88. The config file must be named pfont-config, and must be in either the
  89. current directory or s: directory. Values are entered in hex, each
  90. value must be 2 characters (for example 0f). Sorry about allowing hex only,
  91. but I like hex, and it was easier this way. Your printer book will have
  92. the correct hex values to use. Values must be seperated by spaces, and the
  93. last value on each line must be the last thing on the line before a return,
  94. no extra spaces or anything. Rather than send the entire font at once (as
  95. many printers allow), character definitions are sent one at a time (this is
  96. to make PFont compatible with as many printers as possible). Use a * to
  97. represent the value of the character you are downloading. If your printer
  98. wants to see a range of characters, use a * for the begining of the range
  99. and for the end (thus defining a range of 1 character). The StarNX1000
  100. config file shows an example of this.
  101.  
  102. There are two sample config files included, please read them, they contain
  103. comments (comments are allowed in a config file after the last line of data)
  104. and may assist you in creating your own config.
  105.  
  106. Each line in the config file must:
  107.  
  108.  - begin in the first column.
  109.  - end with a return immediately after the last entry, with no extra
  110.    spaces or other characters.
  111.  
  112. Line 1 - Selects device, either SER: or PAR:.
  113. Line 2 - Hex escape sequence to reset the printer.
  114. Line 3 - Optional hex initalization sequence 1.
  115. Line 4 - Optional hex initalization sequence 2.
  116. Line 5 - Hex sequence to copy ROM printer font to RAM.
  117. Line 6 - Hex sequence to download a single character. Use * to represent the
  118.          number of the character being defined.
  119. Line 7 - Hex sequence to acticate the RAM font just downloaded.
  120. Line 8 - Optional hex post download sequence.
  121. Line 9 - Hex value for lowest character to download.
  122. Line 10- Hex value for highest character to download.
  123.  
  124.  
  125. [3] Running It
  126. ~~~~~~~~~~~~~~
  127. Run PFont as follows:
  128.   pfont pathname/fontname [d]
  129.  
  130. The d is optional, if incleded it will display config and font info to the
  131. screen as it sets your printer up.
  132.  
  133. When run, PFont looks first in the current directory, then in the s:
  134. directory for the config file. Then it looks for the font definition file
  135. (pathname/fontname/8). So if you have an acceptable font called byte in
  136. your fonts: directory, you would type:
  137.  
  138. pfont fonts:byte     or     pfont fonts:byte d
  139.  
  140. You should have byte.font and a subdirectory called byte (with a file called
  141. 8 in it) in your fonts: directory. Note that the font specified doesn't
  142. have to be in fonts:, that is just the most logical place to put them.
  143.  
  144.  
  145. Help
  146. ~~~~
  147. If you have trouble setting up PFont, or using it, call The Mad Scientist's
  148. BBS, and I will try to help you. Just leave feedback describing the problem.
  149.  
  150. The Mad Scientist's BBS
  151. (506) 455-2808
  152. 12/24  8/N/1
  153. Hours: whenever I don't need the computer for other stuff.
  154.  
  155.  
  156. I don't know if I will bother upgrading PFont, but I would like to add
  157. the ability to download 6 to 11 point fonts (others are outside most
  158. printers capabilities). If you have the C source for a simple font editor,
  159. I would appreciate a copy.
  160.  
  161.