home *** CD-ROM | disk | FTP | other *** search
/ DTP Toolbox / DTPToolbox.iso / goodies / post / fontutils / docs / mkbmap.doc < prev    next >
Encoding:
Text File  |  1991-10-03  |  6.0 KB  |  170 lines
  1. Amiga bitmapped font builder
  2. ============================
  3.  
  4. MkBmap V1.3 Copyright Adrian Aylward 1991
  5.  
  6. You may freely copy, use, and modify this program.  The source is included
  7. in the distribution.
  8.  
  9. This program builds Amiga format bitmapped fonts from PostScript fonts.
  10. It uses the library "post.library" to render the characters.  This is
  11. included in the PostScript interpreter package "Post" that is freely
  12. distributable on the Amiga.
  13.  
  14. Best results will be obtained by using fully hinted type 1 fonts, such as
  15. those supplied by Adobe and other vendors.  It should however work with
  16. any other PostScript fonts, though the quality will not be so high.
  17.  
  18. Command line interface
  19. ======================
  20.  
  21. usage:
  22.  
  23.     mkbmap -options bmapfile fontname nn,nn,...
  24.  
  25. options:
  26.  
  27.         -s startupfile
  28.                 The PostScript library startup file name.  Default
  29.                 "PSFonts:init.ps".
  30.  
  31.         -e encodingfile
  32.                 The character set encoding file.  Default
  33.                 "PSFonts:encoding.ps".
  34.  
  35.         -f      Use font specific encoding - for fonts such as "Symbol"
  36.                 where the character names are non-standard.
  37.  
  38.         -n      Make new .font contents file.  Updates the font directory
  39.                 information, like running the FixFonts program, but updating
  40.                 just the particular font.
  41.  
  42.         -dnnn   Set the density, in dots per inch, both x and y directions.
  43.                 Default is 75 dpi..
  44.  
  45.         -xnnn   Set the x density.
  46.  
  47.         -ynnn   Set the y density.
  48.  
  49.         -znnn   Set the baseline, in units of 1/1000 of the pixel height.
  50.                 Default automatically accomodates the descenders.
  51.  
  52.         -wnnn   Set the nominal character width, in units of 1/1000 of the
  53.                 character cell.  Default is the average width of all the
  54.                 characters.
  55.  
  56.         -lnnn   Set LoChar, the lowest character code value in the font.
  57.                 Default 32.
  58.  
  59.         -hnnn   Set HiChar, the highest character code value in the font.
  60.                 Default 255.
  61.  
  62.         -c      Clip characters to their width, so that overhanging
  63.                 sidebearings are truncated.
  64.  
  65.         -m      Flag the font as monospaced, i.e. not proportionally
  66.                 spaced.  Should only be used if all the characters in the
  67.                 font actually are the same width, e.g. Courier.
  68.  
  69.         -b      Set Bold style flag.
  70.  
  71.         -i      Set Italic style flag.
  72.  
  73.         -t      Turn trace on, for debugging.
  74.  
  75. The "bmapfile" argument is the name of the bitmapped font file to be created.
  76. So that more than one size can be created at once, the name can be specified
  77. as a prototype.  Any "*" characters are replaced by the point size, and any
  78. "?" characters are replaced by teh individual digits.  For example if we
  79. generate 9 and 10 point then "fonts:fred/*" will become "fonts:fred/9" and
  80. "fonts:fred/10"; "t:fred??" wil become "t:fred09" and "t:fred10".
  81.  
  82. The "fontname" is the PostScript font name, for example "Palatino-Roman".
  83.  
  84. The last argument is the list of point sizes to be generated, for example
  85. "10,12,24".  The minimum size allowed is 5, and the maxium 500 - if you
  86. have enough memory.
  87.  
  88. Normally, all three arguments are required.  However, if just the first
  89. argument is given then the "-n" option may be used to update the font
  90. contents.
  91.  
  92. For example:
  93.  
  94.     mkbmap -n fonts:Times/* Times-Roman 10,12,14
  95.  
  96. Creates bitmapped versions of the "Times" font in the current fonts
  97. directory, updating the font contents file "fonts:Times.font" so they
  98. become immediately available to the system.
  99.  
  100.     mkbmap t:Times24 Times-Roman 24
  101.  
  102. Creates a bitmapped 24 point "Times" in the temporary directory.  If
  103. you then copy it into the fonts: directory:
  104.  
  105.     copy t:Times24 fonts:Times/24
  106.  
  107. you must then either run FixFonts or use mkbmap to update the font contents:
  108.  
  109.     mkbmap -n fonts:Times/
  110.  
  111. The font is now available for use.  N.B. the trailing "/" on the path name
  112. must not be omitted; otherwise it will be looking for individual bitmaps
  113. within the fonts:directory, rather than in the Times subdirsctory.
  114.  
  115. If you use the "-n" option, the font subdirectory will be created
  116. automatically if necessary.
  117.  
  118. Character sizes
  119. ===============
  120.  
  121. The size list is the heights of the generated bitmaps, in pixels.  This is
  122. also the point size (in PostScript terminology) at the chosen resolution.
  123. When characters are rendered at 75 dpi. (the default) the alphabet normally
  124. fits satisfactorily into the pixel height.  However the upper case accented
  125. characters are normally too large to fit, so are scaled down.  Excessively
  126. long descenders are scaled too.  This can lead to a slightly ragged look on
  127. the screen, but fortunately these characters are rarely used.
  128.  
  129. Alternatively, you can adjust the density to make the charecters fit.  At
  130. about 60dpi. even the tallest characers should be OK.  But the characters
  131. may then look too small in relation to the line spacing.
  132.  
  133. If you are generating a font for a screen where the pixels are not
  134. approximately square (such as high-res, non-interlaced) you can set the
  135. x and y density separately.
  136.  
  137. Professional Page renders its screen at 75 dpi., so you should normally use
  138. the default density when generating fonts for it.
  139.  
  140. The baseline is normally positioned automatically, so the alphabetic
  141. descenders just fit.  If you prefer you can set it yourself; values of
  142. 200 - 250 are about right (1/5 to 1/4 of the pixels below the baseline.
  143.  
  144. The Xsize (nominal width) is automatically set to the average width of
  145. the characters generated.  You can set it yourself from the command line;
  146. values will typically range from 300 to 700 (in 1/1000 character space
  147. coordinates used by Adobe).
  148.  
  149. Versions
  150. ========
  151.  
  152.     V1.0  03-May-91
  153.  
  154. The original.
  155.  
  156.     V1.1  04-May-91
  157.  
  158. Rendering code changed so as not to clip characters by default.  New -c
  159. option to enable old behaviour.
  160.  
  161.     V1.2  13-May-91
  162.  
  163. Bugs fixed: -s and -e options, characters with negative sidebearings.
  164.  
  165.     V1.3  01-Oct-91
  166.  
  167. Bugs fixed: flattenpath before calculating character bounding boxes, bitmap
  168. bounding box rounding error.
  169.  
  170.