giftrans(1)

giftrans1

Transform gif from gif87 to gif89, making one color transparent

Usage

giftrans [options] [-o filename] filename

Overview

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

-h

Print short help on stdout.

-t

Specify the transparent color

-T

Index of the transparent color is the background color index

-B

Specify the transparent color's new value

-b

Specify the background color

-g

Change a color in the global color table

-c

Add a comment

-C

Remove old comment

-l

Only list the color table

-L

Verbose output of GIFs contents

-V

Verbose output while converting

-o

Redirect stdout to a file

-e

Redirect stderr to a file

Colors may be specified as index, as rgb.txt entry or in the #rrggbb form. Of course, beware that shells will often consider the # character to start a comment and so you may have to escape it!

Examples

To convert the white background of a gif file to transparent, use

giftrans -t #ffffff file.gif > transparentfile.gif

Version history

Version 1.12.2 - 11.4.96

Changed to GNU copyright

Version 1.12.1 - 9.2.96

Fix for multi-word color names.

Version 1.12 - 17.2.95

Incorporated dumpcomment by [email protected] (Thomas Omerzu)
Outputs original version if newer than GIF89a.

Version 1.11.2 - 14.12.94

Incorporated OS/2 port by [email protected] (Klaus Johannes Rusch)
Different rgb.txt file for OS/2, setmode replaced by freopen for
OS/2 (SAA C)

Version 1.11.1 - 11.8.94

Allows for use of the -g option without the -B option.

Version 1.11 - 21.7.94

Moved Plain Text Extension to the Extensions section where it belongs
Accept Unknown Extension Labels
Incorporated MS-DOS port by [email protected] (Enzo Michelangeli)
Added -o and -e options to redirect stdout and stderr
Added -D debug flag

Version 1.10.2 - 22.6.94

Support for -DRGBTXT flag

Version 1.10.1 - 21.6.94

Different rgb.txt file FreeBSD/386BSD

Version 1.10 - 19.6.94

Added option to change a color in the global color table
Added option to change the color for the transparent color index

Version 1.9.1 - 7.6.94

Different rgb.txt files for X11 and Open Windows

Version 1.9 - 1.6.94

Fixed a bug which caused color names to be rejected.

Version 1.8 - 30.5.94

Accept #rrggbb style arguments.
Do nothing if rgb-color not found in GIF.

Version 1.7 - 16.5.94

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.

Version 1.6 - 5.4.94

Added color names recognition.

Version 1.5 - 15.3.94

Added basic verbose output to analyze GIFs.

Version 1.4 - 8.3.94

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 ([email protected]).

Thanks

Thanx for bug reports, ideas and fixes to

[email protected] (Patrick Atoon)

[email protected] (Wes Barris)

[email protected] (Patrick M. Fitzgerald)

[email protected] (frans van hoesel)

[email protected] (Dan Boardman)

[email protected] (Ken Weiss)

[email protected] (Chuck Musciano)

[email protected] (Torsten Heycke)

[email protected] (Colin Law)

[email protected] (Joseph C. Walker)

[email protected] (Bjorn Borud)

[email protected] (CJS Vance)

[email protected] (Peder Langlo)

[email protected] (Ian Rutson)

[email protected] (Nicolas Pioch)

[email protected] (John Kilburg)

[email protected] (Enzo Michelangeli)

[email protected] (Terry von Gease)

[email protected] (Klaus Johannes Rusch)

[email protected] (Thomas Omerzu)

[email protected] (Willem Vermin)

[email protected] (Warren Jones)

Releases

14 releases since Debian 2.1 (Slink); the text changed 3 times.

  1. 2.1–3.0
  2. 3.1–4.0
  3. 5.0–7
  4. 8–13

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.

From giftrans 1.12.2-20 in Debian 13 (Trixie). Parsed by carta from the page's man source.