A text based tool for creating and manipulating GIF images

Provides shell level access to the gd 1.2 graphics library

Author: Bradley K. Sherman

The latest release of tgd is version 1.2c (7 Oct 1996). The latest version of the documentation should be available at .
RCS:$Id: index.html,v 1.2 2002/06/15 17:08:33 bks Exp $


tgd reads text files and writes GIF files. Typically, in a Unix environment, it would be at the end of a pipe: my_program | tgd. It can also be invoked on a file: tgd my_text_file. By using the special file handle stdout, it can be used in WWW applications to push images to a browser. It was born out of a desire to learn the gd graphics library and Perl simultaneously (but it can be used with any scripting language). I hope that it will allow me to make new tools available on the World-Wide Web to help molecular biologists cope with ever increasing quantities of data. .

Credits & Rights

This program would not exist if Doug Bigwood had not shown Thomas Boutell's gd 1.1.1 graphics library to me. To appreciate tgd you must read Boutell's documentation . You can find the Credits and License terms of the gd 1.2 library at gd.html#notice or in the tgd distribution.

We place no further restrictions on distribution of the source code other than those attached to the software from which it is derived except to request that novel software derived from tgd include credit to the Dendrome project, Institute of Forest Genetics, USDA Forest Service.

The Dendrome project is funded by the USDA ARS Plant Genome Research Program and by the USDA Forest Service .

tgd was written by Bradley K. Sherman . Please send bug reports and comments to

Table of Contents

Change in version 1.2

Font names are now case insensitive. There are three new fonts: gdFontTiny, gdFontMediumBold and gdFontGiant. There is a complete list of fonts below.

Changes in version1.2b

Font source files are broken up into separate file to allow compilation on machine where object modules must be kept smaller. Commands gif and gd will now accept special filename stdout to mean write the image files to the standard output rather than to a disk file.

Changes in version1.2c

Fixed polygon and filledpolygon bugs reported and diagnosed by Ronan Waide (

Where do I get tgd

Compressed with compress (tgd1.2c.tar.Z)
Gzipped with gzip (tgd1.