NAME

NAME
GD::Latin2 - ISO-8859-2 support for GD module

SYNOPSIS
If you have successfully aplied this patch and reinstalled GD,
you can call string with parameters containing ISO-Latin-2
characters and they will be correctly displayed in the gifs.

DESCRIPTION
This is a patch that replaces standard ASCII-only fonts in
libgd, used by GD module, by those with full 256 char Latin2
support. In order to put new fonts into the library, the source
has to be changed and the library recompiled. That's why you
need to have untarred GD library ready before aplying this
patch.

INSTALLATION
This is my attempt to make the patch easily installable.
However, it may fail on your configuration, but do not worry --
you can patch the GD/gdlib yourself, see below.

Unpack this distribution next to unpacked GD distribution. Then
run

perl Makefile.PL
make
make install

You will be prompted for a directory containing the untarred GD
distribution. Then the files containing the fonts are replaced
with those with ISO-8859-2. Also, libgd.c and gd.h files are
patched to make them 8-bit clean. And, the fifth test output gif
(that contains some texts) is also replaced, so that the tests
run OK.

You can of course do all this by hand: the fonts are in the
fonts directory, you should copy them into the libgd directory
in GD distribution, in Un*x using command like

cp fonts/* ../GD-1.16/libgd

assuming you are chdir'd in the GD-Latin2 directory and the GD
distribution is unpacked next to it (in ../GD-1.16).

Then apply the patches in file libgd.c.diff to libgd.c and that
in gd.h.diff to gd.h file in GD distribution. The Un*x command
using the program patch would be like

patch -d ..GD-1.16/libgd < libgd.c.diff
patch -d ..GD-1.16/libgd < gd.h.diff

You can of course change the relevant files by hand, change the
lines in the diff files marked by !.

OTHER CHARSETS
In this package, I have also included my little script bdftogd
that creates gd font definitions from those in bdf file format.
So you can run your favorite ISO-8859-1 or so fonts through it
and make use of them.

BUGS
You have to reinstal this patch whenever you upgrade your GD
package.

The small font has changed from 6x12 to 6x13 in ISO-8859-2
version.

The bdftogd convertor is really a simple hack that suits my
needs. You are welcome to find problems and send me patches to
make it more general.

CHANGES
0.54

Fixed bug in bdftogd, causing wide characters to be broken.

0.53

Bug with "Up" characters fixed, spotted by Michal Brandejs. This
resulted in a change in function prototype in libgd.c and also
in gd.h, because eight bit characters cannot be treated as
signed. We need to have them either as ints or as unsigned
chars.

0.51

Better font found for 5x8, also the Giant font generated.

0.5

First release, put on CPAN; Lincoln Stein responds by saying he
wants to apply the patch directly into the GD package.

VERSION
0.53

AUTHOR
Jan Pazdziora, [email protected]

http://www.fi.muni.cz/~adelton/

at Faculty of Informatics, Masaryk University in Brno, Czech
Republic