dejavu-fonts/README.qpf

   1 Information about QPF version of DejaVu
   2 (by Vasek Stodulka)
   3
   4 QPF fonts are used in QT/Embedded environments - Opie and Qtopia and maybe
   5 in other QT-based systems. These environments are run mostly on pocket
   6 devices such as Linux iPaq or Sharp Zaurus.
   7
   8 Opie contains only original Bitstream Vera font without unicode capitals.
   9 This is the reason why I converted DejaVu fonts with all included unicode
  10 symbols. See the NEWS and status.txt files for a list of supported
  11 languages / glyphs.
  12
  13 QPF fonts are bitmap fonts; that means they are not scalable. They are
  14 "rendered" from TTF in fixed dimensions specified in "rendering" process.
  15 Package dejavu-qpf-normal-version.tar.gz contains all DejaVu fonts in
  16 dimensions 8, 10 and 12 points, package dejavu-qpf-huge-version.tar.gz
  17 contains 14, 18 and 24 poits large fonts. All fonts are in regular, bold,
  18 italic and bold-italic layout.
  19
  20 Devices running Opie/Qtopia are able to rotate display in four ways -
  21 portrait, landscape, upside down and landscape upside down. For each
  22 rotation you need a separate set of fonts. These packages contain fonts for
  23 all these rotations.
  24
  25 Semantics of file naming is quite easy. Example: "dejavusans_100_80i_t5.qpf"
  26 means that the name displayed in system will be "dejavusans", the number
  27 "100" means that the font is 10 points big (divide the number by 10). Next
  28 number and possibly a letter describes weight (50=regular, 80=bold,
  29 i=italic) - in our example bold-italic. "t5" means rotation - files without
  30 rotation are displayed portrait, "t5" files are rotated 90 degrees
  31 clockwise, "t15" means 180 degrees and "t10" is 270 degrees. And yes, the
  32 rotation is really little bit silly, one more time: nothing=0 degrees,
  33 t5=90, t15=180 and t10=270. In fact it is more complicated - on iPaq 3870
  34 0 degrees means "landscape" (the landscape with thumb of your right hand on
  35 5-way button) and 90 degrees means "portrait" (you need fonts without "t"
  36 and with "t5"). Other hardware platforms have different default rotation,
  37 just try.
  38
  39 To install fonts on your device, simply copy selected files into
  40 $QTDIR/lib/fonts. (This works for Opie, it may be different on other QT
  41 environments. If unsure, try to find other .qpf files.) No changes in
  42 "fontdir" file are necessary, in fact the file is required only for
  43 translating TTF or type1 fonts and can be safely deleted. After copying
  44 files optionally restart your Opie/Qtopia/whatever; is is not necessary,
  45 but just to be sure.
  46
  47 Hint: To save flash space, select only the fonts/sizes/rotations you really
  48 need. For example, you usually use only two rotations (portrait and
  49 landscape) and some sizes of fonts.
  50
  51
  52
  53 HOWTO translate TTF font into QPF
  54
  55 Difficult way:
  56 Compile makeqpf utility as described in
  57 http://www.ossh.com/zaurus/mirrors/docs.zaurus.com/ttf_conversion.shtml
  58 and translate fonts as described in page, but look into my "fontdir" file
  59 how to create your own. (!!!)
  60
  61 Easier way:
  62 download http://moria.ionkov.net/zaurus/makeqpf/makeqpf-arm to your device,
  63 place TTF fonts in your font dir, create "fontdir" file (look in my one how)
  64 and run
  65
  66 cd your_font_dir
  67 ~/makeqpf-arm -A
  68 ~/makeqpf-arm -A -display Transformed:Rot90
  69 ~/makeqpf-arm -A -display Transformed:Rot180
  70 ~/makeqpf-arm -A -display Transformed:Rot270
  71
  72 Known issues:
  73
  74 - opie-reader (up to version at least 1.1.6) does not display zcaron and
  75 scaron (it displays "z" and "s" instead). But this not a bug in dejavu-qpf.
  76 You can try Opie Text Editor, it displays all (or at least all czech :)
  77 DejaVu symbols perfectly. Opie Text Editor is utf-8 only, get some utf-8
  78 file with non latin-1 symbols and open it. Good reader for Opie is
  79 JustReader.
  80 - the most applications in present time Opie do not even try to support
  81 different encodings :(
  82
  83 Plans:
  84 - make .ipks
  85
  86 $Id$