Written by                   Carsten Siebholz (c.siebholz@t-online.de>


Project's homepage:          http://c.siebholz.bei.t-online.de

Latest version available at: http://c.siebholz.bei.t-online.de


See the file COPYING for license information.



Description:
------------
  crtfont is a program to create fonts for the graphlcd plugin for VDR.




Installation and Configuration:
-------------------------------
  1. unpack the tarball

  2. to compile the tool, type
     make




Using crtfont:
--------------
  To create a font, 2 'source' files are required:
  - an image, that contains the characters as a bitmap
    This image might be in
    uncompressed RGB-encoded 2-color TIFF or
    uncompressed RGB-encoded 2-color Windows BMP format.
  - a description file (*.desc), that contains informations about the
    positions of each character in the image.
    The format of the description file:
      The first line contains the total height of the font.
      This value should match the vertical difference between two
      character lines in the image.
      The second line contains the height of the font without 'descending'
      pixels (like in 'g', 'p' or 'q').
      All other lines define the characters and their positions in the image.
      The syntax is like:
	PosX_1 Char_1 PosX_2 Char_2 PosX_3  ... PosX_n Char_n EndX
	
	where PosX_x specifies the horizontal position of the leftmost pixel
	of the character.
	Char_x might be the character itself (A, B, ...)
	or it's decimal ASCII value (65, 66, ...)


  Usage: crtfont -f <format> -b bmpfile -d descfile -o outfile

  -f  --format      specifies the format of the bitmap. Possible values are:
                    TIFF : file is an uncompressed RGB-encoded 2-color TIFF
                    BMP  : file is an uncompressed RGB-encoded 2-color Windows BMP
  -b  --bmpfile     specifies the name of the bitmap file (*.tif, *.bmp)
  -d  --descfile    specifies the name of the description file   (*.desc)
  -o  --outfile     specifies the name of the output file        (*.fnt)

  example: crtfont -f BMP -b f12.bmp -d f12.desc -o f12.fnt




Known Problems:
---------------
  none that I know of...
