..

.. GIFTRANS l local

NAME

giftrans - transform gif from gif87 to gif89, making one color transparent


SYNOPSIS

giftrans [options] [-o filename] filename


DESCRIPTION

giftrans converts any GIF file into a GIF89a. Allows for setting the transparent or background color, changing colors, adding or removing comments. Also code to analyze GIF contents.


OPTIONS

Print short help on stdout.

Specify the transparent color

Index of the transparent color is the background color index

Specify the transparent color's new value

Specify the background color

Change a color in the global color table

Add a comment

Remove old comment

Only list the color table

Verbose output of GIFs contents

Verbose output while converting

Redirect stdout to a file

Redirect stderr to a file

Colors may be specified as index, as rgb.txt entry or in the #rrggbb form.


EXAMPLE

To convert the white background of a gif file to transparent, use giftrans -t #ffffff file.gif > transparentfile.gif


BUGS

This program has been tested on a HP9000/720 with HP-UX A.08.07 In this environment, neither lint -u nor gcc -Wall produce any messages. If you encounter any errors or need to make any changes to port it to another platform, please contact me.

Known bugs:

-B flag won't work if there's an Extension between the Global Color Table and the Image Descriptor (or Graphic Control Extension). If -V has been specified, a Warning Message will be displayed. Will be fixed in 2.0

Always outputs GIF89a. Shouldn't do this if version is newer.

-D option may output changed data instead of original data, use with caution, best only with then -L option.


COPYRIGHT

Copyright (c) 24.2.94 by Andreas Ley <ley@rz.uni-karlsruhe.de>

Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies. This software is provided "as is" and without any express or implied warranties.


VERSION HISTORY

Moved Plain Text Extension to the Extensions section where it belongs

Accept Unknown Extension Labels

Incorporated MS-DOS port by enzo@hk.net (Enzo Michelangeli)

Added -o and -e options to redirect stdout and stderr

Added -D debug flag

Support for -DRGBTXT flag

Different rgb.txt file FreeBSD/386BSD

Added option to change a color in the global color table

Added option to change the color for the transparent color index

Different rgb.txt files for X11 and Open Windows

Fixed a bug which caused color names to be rejected.

Accept #rrggbb style arguments.

Do nothing if rgb-color not found in GIF.

Added -l option to only list the color table.

Added -L option for verbose output without creating a gif. Added -b option to change the background color index.

Display all matching color names for color table entries.

Fixed a bug which caused bad color names if rgb.txt starts with whitespace.

Doesn't use strdup anymore.

Fixed =& bug on dec machines.

Added color names recognition.

Added basic verbose output to analyze GIFs.

Fixed off-by-one bug in Local Color table code.

Added option to add or remove a comment.

Transparency is no longer the default.

This man file made 9.8 from documentation in the program source code by Kai Nordlund (knordlun@fltxa.helsinki.fi).


THANKS

Thanx for bug reports, ideas and fixes to

patricka@cs.kun.nl (Patrick Atoon)

wes@msc.edu (Wes Barris)

pmfitzge@ingr.com (Patrick M. Fitzgerald)

hoesel@chem.rug.nl (frans van hoesel)

boardman@jerry.sal.wisc.edu (Dan Boardman)

krweiss@chip.ucdavis.edu (Ken Weiss)

chuck@trantor.harris-atd.com (Chuck Musciano)

heycke@camis.stanford.edu (Torsten Heycke)

claw@spacsun.rice.edu (Colin Law)

jwalker@eos.ncsu.edu (Joseph C. Walker)

Bjorn.Borud@alkymi.unit.no (Bjorn Borud)

Christopher.Vance@adfa.oz.au (CJS Vance)

pederl@norway.hp.com (Peder Langlo)

I.Rutson@bradford.ac.uk (Ian Rutson)

Nicolas.Pioch@enst.fr (Nicolas Pioch)

john@charles.CS.UNLV.EDU (John Kilburg)

enzo@hk.net (Enzo Michelangeli)


DISTRIBUTION

ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/giftrans.c

ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/getopt.c

ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/giftrans.exe

ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/rgb.txt

http://melmac.corp.harris.com/transparent_images.html


SEE ALSO

xv(1), giftoppm(1), ppmtogif(1)