home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / fonts / a_q / pixelfont / ReadMe < prev   
Text File  |  1998-04-30  |  4KB  |  99 lines
  1.  ————————————————————
  2.   Help for PixelFont
  3.  ————————————————————
  4.  
  5. This is version 1 of PixelFont, 25-04-1998.
  6. Copyright Richard Atterer.
  7. This program is Free Software - see the file “Copying” for details. The
  8. source is available in a separate archive. PixelFont uses the Fontfile
  9. library by Jakob Stoklund Olesen (thanks!).
  10.  
  11.  
  12. PixelFont is a small utility that turns 16-colour greyscale sprites into
  13. bitmap fonts, which can then be used as the system font or for the display
  14. in Zap, Messenger etc. A number of example sprite files are included -
  15. double-click “CreateFonts” to convert them into fonts.
  16.  
  17. Note: Because PixelFont only creates fonts for a specific point size and
  18. resolution, the FontManager won't display the bitmaps (and give an error
  19. instead) unless exactly that size is requested. Also, many programs, e.g.
  20. Draw, refuse to use the fonts.
  21.  
  22.  
  23. The first four columns and the two bottom rows of the sprite have special
  24. meaning. They may only contain black and white pixels.
  25.  
  26. Column 0: Gives the height and position of capital letters, e.g. ‘E’, ‘X’.
  27. Column 1: Height and position of lowercase letters like ‘b’, ‘d’, ‘f’. These
  28.              characters are usually slightly larger than the capital letters for
  29.       some typefaces - see the example “Trinity”.
  30. Column 2: Height and position of lowercase letters, e.g. ‘n’, ‘x’.
  31. Column 2: Height and position of the part of ‘g’, ‘p’, ‘q’ etc. that extends
  32.              below the baseline.
  33. The values must all specify the same coordinate as the font baseline. Note
  34. that (apart from the position of the baseline) the FontManager does not make
  35. use of the information - however, some programs may.
  36.  
  37.  
  38. The two bottom rows contain information about the individual character
  39. widths. The bottom row is only used to indicate where the definition of a
  40. character begins and ends, it doesn’t influence the width. In the row above
  41. the bottom row, the width as well as the horizontal position of a character
  42. is specified.
  43.  
  44. It is possible to create characters that overlap slightly (which is the case
  45. with many italic/oblique styles) or special characters which add an accent to
  46. the following character because they don’t advance the cursor after having
  47. been printed.
  48.  
  49. If the second row doesn’t contain any black pixels for a character, that
  50. character has a width of zero and the relative x origin is the left side of
  51. the black pixels in the lowest row (this is the only case for which the
  52. position of the pixels in the lowest row influences the final output). If you
  53. want to specify a different x position but at the same time want the width to
  54. remain zero, let the second row contain <black><white><black> - in this case,
  55. the x origin is set to the coordinate of the leftmost black pixel.
  56.  
  57.  
  58. When creating the bitmap font, PixelFont throws away any completely white
  59. rows and columns it finds in a character. This can reduce the required disc
  60. space and speed up screen output.
  61.  
  62.  
  63. Syntax:
  64.  
  65. *PixelFont <spritefile> <fontname> [<destination dir>] [<options>]
  66.  
  67. The following options are supported. They can be abbreviated to the first
  68. letter, e.g. “-s”:
  69.  
  70. -size <points*16>
  71.     Assumed design size of the font, in 16ths of points. The default is
  72.     12 points, i.e. a value of 12*16. This influences both the x and
  73.     y size.
  74. -height <points*16>
  75.     As -size, but only influences the y size.
  76. -xdpi <dpi> and -ydpi <dpi>
  77.     Resolution the font is designed for. The default is 90 dpi for both
  78.     the x and y resolution.
  79. -ulinepos <1/256th em>
  80. -ulinethick <1/256th em>
  81.     Position of underlined text (in relation to the base line)
  82.     and thickness of the line. Doesn’t seem to be used by the
  83.     FontManager.
  84. -monospaced <pixel width>
  85.     Create a font in which all defined characters have the same width,
  86.     specified in pixels.
  87. -gamma <floating point value>
  88.     Very unfortunately, the FontManager doesn’t have any support for
  89.     gamma correction of its output. Usually, this means that a font that
  90.     you designed for black on white display will look poor when viewed
  91.     white on black. In this case, you can make PixelFont re-map the
  92.     shades of grey to compensate for the non-linear representation on
  93.     your monitor.
  94.  
  95.  
  96.   __   _
  97.   |_) /|  Richard Atterer
  98.   | \/¯|  atterer@augsburg.baynet.de
  99.   ¯ ´` ¯