code.delx.au - refind/blob - fonts/README.txt

   1 This directory contains PNGs built from a couple of open source fonts: the
   2 sans serif Liberation Mono Regular and the serif Luxi Mono Regular, in 12-,
   3 14, and 24-point versions. All of these font files have anti-aliasing (aka
   4 font smoothing) applied. The directory also includes the original rEFInd
   5 font, which is a 12-point un-smoothed Times-like font.
   6
   7 If you want to create your own fonts, you can do so. If you're using Linux,
   8 the mkfont.sh script will convert an installed MONOSPACE font into a
   9 suitable format. You can use it like this:
  10
  11 ./mkfont.sh Liberation-Mono-Italic 14 -1 liberation-mono-italic-14.png
  12
  13 The result is a PNG file, liberation-mono-italic-14.png, that you can copy
  14 to your rEFInd directory and load with the "font" token in refind.conf, as
  15 in:
  16
  17 font liberation-mono-italic-14.png
  18
  19 The mkfont.sh script takes four arguments:
  20
  21 - The font name. Type "convert -list font | less" to obtain a list of
  22   fonts available on your computer. Note, however, that rEFInd requires
  23   MONOSPACED (fixed-width) fonts, and most of the fonts installed on most
  24   computers are variable-width.
  25
  26 - The font size in points.
  27
  28 - A y offset. Many fonts require an adjustment up (negative values), or
  29   occasionally down (positive values) to fit in the PNG image area. You'll
  30   have to use trial and error to get this to work.
  31
  32 - The output filename.
  33
  34 I recommend checking the PNG file in a graphics program like eog before
  35 using it. Note that the font files should have an alpha layer, which many
  36 graphics program display as a gray-and-white checkered background.
  37
  38 If you're not using Linux, or if you want to use some other method of
  39 generating fonts, you can do so. The font files must be in PNG format (the
  40 BMP format doesn't support an alpha layer, which is required for proper
  41 transparency). They must contain glyphs for the 95 characters between ASCII
  42 32 (space) and ASCII 126 (tilde, ~), inclusive, plus a 96th glyph that
  43 rEFInd displays for out-of-range characters. To work properly, the
  44 characters must be evenly spaced and the PNG image area must be a multiple
  45 of 96 pixels wide, with divisions at appropriate points. In theory, you
  46 should be able to take a screen shot of a program displaying the relevant
  47 characters and then crop it to suit your needs. In practice, this is likely
  48 to be tedious.
  49