home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk943 / mkfont / mkfont.doc < prev    next >
Text File  |  1993-12-21  |  14KB  |  299 lines
  1.  
  2.  
  3.  
  4.                               Mkfont
  5.  
  6.                             Version 1.0
  7.  
  8.                       Written by Tonio Voerman
  9.  
  10.  
  11.  
  12. Preface
  13. =======
  14.  
  15. This software is  F R E E W A R E  !     That means:
  16.  
  17. - Mkfont is copyrighted, and therefor your NOT allowed to alter Mkfont OR
  18.   this accompanying documentation file.
  19. - Your FREE to use it. This is NOT shareware.
  20. - It's forbidden to charge more than a SMALL fee for this program. It should
  21.   not be more than the copying costs.
  22. - Your FREE to distribute Mkfont and the documentation file, but you MUST
  23.   distribute them together.
  24. - This program is NOT to be sold as a commercial program!
  25. - Your NOT allowed to modify the author's name.
  26. - Your NOT allowed to steal any parts of Mkfont or to use it in any other
  27.   way than as a stand alone product.
  28.  
  29.  
  30. CONTENTS:
  31. - What is Mkfont anyway ?
  32. - Requirements
  33. - Features
  34. - Installation
  35. - How to run Mkfont
  36. - Source
  37. - Bugs and testing
  38. - What you can do for me
  39. - future versions
  40.  
  41.  
  42. WHAT IS MKFONT ANYWAY ?
  43. =======================
  44.  
  45. As is well known, the Amiga has an impressive number of Public Domain fonts.
  46. Some are ugly and some are quite good looking. What a shame that you can
  47. display them, but not print them other than as graphics, a painfully slow
  48. proces and a big problem if your tight on printer memory!
  49. This is where Mkfont comes in: it converts a normal Amiga font into a
  50. Hewlett Packard laserprinter II compatible softfont. If you ever bought a
  51. softfont for your HP II compatible laserprinter, you'll be happy to know
  52. that you can get softfonts totally free now!
  53.  
  54.  
  55. REQUIREMENTS
  56. ============
  57.  
  58. Obviously you need to either have or have acces to a Hewlett Packard
  59. laserprinter or a compatible printer. If you don't have that you can stop
  60. reading here as Mkfont is not of any interest for you.
  61. Mkfont should run normal on all Amiga models as hardly any use is made of
  62. the Operating System. Although not tested Mkfont should work on O.S. 1.x.
  63. Mkfont however does require a hefty 200K of free contiguous memory when run,
  64. as it is unclear how much space a softfont will need when it is created. The
  65. 200K is to make sure that every created softfont fits in memory.
  66. And you gessed it: Public Domain Amiga fonts (large ones)!
  67.  
  68.  
  69. Features
  70. ========
  71.  
  72. - As far as I know, Mkfont is unique. I could not find a program to convert
  73.   Amigafonts to HP II softfonts.
  74. - Mkfont is fast. It is entirely written in assembly and it is optimized in
  75.   it's loops for full speed. Note however that due to the enormous amount of
  76.   data to deal with, converting a font can take a few seconds (on 68000).
  77. - As the process of creating a font only takes short time, it is worth it to
  78.   create fonts on demand instead of storing them permanently, thus reducing
  79.   valuable diskspace.
  80. - Mkfont itself is a small program because it's written in assembly, so it
  81.   is quickly loaded from disc and only takes little diskspace.
  82. - Mkfont is able to enlarge a soft font 2 times horizontally and vertically
  83.   during the creation of the softfont.
  84. - Mkfont will automatically smoothen the soft font a little to avoid sharp
  85.   edges often found in (scaled) Amiga fonts.
  86. - Mkfont allocates and deallocates memory, devices etc. in a system friendly
  87.   way and multitasks normally.
  88. - Mkfont is rather fool proof; you'll have a hard time trying to crash it.
  89.  
  90.  
  91. INSTALLATION
  92. ============
  93.  
  94. To make life simple for users, all that is needed is that the Amiga can
  95. find Mkfont. This means that it should be in the actual directory or that it
  96. should be in your path somewhere. For example to make it always available:
  97.                             copy Mkfont C:
  98. would do the trick. Note however that Mkfont and it's documentation file
  99. must be kept together so it is not allowed to copy Mkfont to C: AND throw
  100. away this documentation. If you want, you can copy them in a subdirectory:
  101.                             makedir df1:Mkfont
  102.                             copy #? df1:Mkfont/
  103. if df1: contains a disk on wich you want to keep Mkfont and this doc. Or you
  104. can simply keep this disk.
  105. NOTE that Mkfont is CLI-ONLY. This will be fixed later but for the moment
  106. you'll have to use the CLI.
  107.  
  108.  
  109. HOW TO RUN MKFONT
  110. =================
  111.  
  112. As stated you can only run Mkfont from the CLI. Workbench support will come
  113. later. But Mkfont is easy to use. It's syntax is:
  114.  
  115. Mkfont [options] <Amiga font file> <softfontname to be created>
  116.  
  117. That's all. If you type Mkfont or Mkfont help you get:
  118.  
  119. This program constructs a Hewlet Packard II compatible laserprinter font
  120. using an Amiga font as a basis. Such a font is downloadable, but it is
  121. only useful if you have a laserprinter at your disposal.
  122. Syntax: mkfont [options] fontfile outputfile
  123. Options are:
  124. -d: double the size of the HPfont
  125. -t: make a testfile (send the testfile to par: or ser:)
  126. -v: the program reports what it is doing
  127. -n: problems and comment are given in Dutch
  128. -p: the HPfont is always made proportional
  129.  
  130. I think the options are all pretty clear. The -n is included as I didn't
  131. want to forget the Dutch. The option -n is can be used in conjunction with
  132. the -v (for Verbose) option. The -t option is included mainly for debugging
  133. uses. It creates a softfont with an integrated testpattern. It can not be
  134. used as a normal soft font for use in packages who use softfonts. Instead it
  135. must be copied to the parallel or serial device (par: or ser:) and will
  136. print the characters of the soft font. But with this option you can test a
  137. softfont for it's appearance on paper without the hassle of starting a
  138. program wich uses that softfont. Do not copy it to prt: as this will most
  139. certainly prints garbage on your laserprinter.
  140. (For the dutch: type Mkfont -n for help!)
  141.  
  142. The input file is a bit weird for the first time. As you might know the
  143. amiga knows a FONTS: directory. In that directory there are subdirectory's
  144. containing amiga fonts and .font files. For example you can find a topaz
  145. directory and a topaz.font file. The topaz.font file is NOT used by Mkfont.
  146. Just the actual amiga font itself is needed. So if the directory topaz
  147. contains the file named "11", THAT file is needed as input. So you might
  148. specify as inputfile FONTS:topaz/11 ! The output file is a lot simpeler;
  149. just specify the name you want the soft font to have. Of course you can
  150. specify any device as a part of the name. So RAM:yo is fully acceptable.
  151. It is also possible to not use a diskname, but an other device, like nil:.
  152. The use of this is for example to test wether you have got enough free RAM
  153. to run Mkfont and to test wether or not the Amiga font can be converted
  154. without any problems (it should). An other use is to use the option -t and
  155. par: or ser: as output name. The font is then not stored, but sent to the
  156. printer right away, including a testpattern to print a sample.
  157. Mkfont is made foolproof, so with normal use you shouldn't be able to crash
  158. it (you would have to modify Amiga font files, it's pointers to be precise)!
  159. And thus it is not possible to use wrong names or options. Specifying also
  160. par: as input name will not work (good output name though)!
  161. If a mistake is detected no output file will be created. Note that specify-
  162. ing the same name for the output file as the input file is NOT considered a
  163. mistake as long as the input file exists. It will be overwritten!
  164. There is an important thing to know. Laserprinters print with 300 dpi. That
  165. means that there are about 12 pixels in a mm. That means that a "large"
  166. Amiga font from 25 pixels high prints out at a rather small 2 mm height! So
  167. it is advisable to use the option -d to double that. The smoothing algorithm
  168. will most of the time produce satisfactory result dealing with the
  169. blockiness wich results from the doubling. The smooth happens automatic and
  170. is not an option as fonts look much better with it and it doesn't take that
  171. much more time. Do NOT try an Amiga font with height 8 or something like
  172. that or you will need good eyes to see what is printed! But if you have 'em
  173. an 8 pixels heigh font is ideal for storing lots of text on 1 a4 paper.
  174.  
  175. Warning: Not every font you have might be public domain! Check that before
  176. using Mkfont. Using Mkfont is a way of copying a font and modifying it. This
  177. might be forbidden by the maker of the font! I DON'T tak