packages icon



 GIFTRANS(l)                                                     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
      -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.

 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



                                    - 1 -      Formatted:  November 14, 2024






 GIFTRANS(l)                                                     GIFTRANS(l)
                                    local



      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
      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 enzo@hk.net (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.




                                    - 2 -      Formatted:  November 14, 2024






 GIFTRANS(l)                                                     GIFTRANS(l)
                                    local



      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 (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)




                                    - 3 -      Formatted:  November 14, 2024






 GIFTRANS(l)                                                     GIFTRANS(l)
                                    local



           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
      Original distribution site is
           ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/giftrans.c

      To compile for MS-DOS, you need getopt:
           ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/getopt.c

      MS-DOS executable can be found at
           ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/giftrans.exe

      A template rgb.txt for use with the MS-DOS version can be found at
           ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/rgb.txt

      Additional info can be found on
           http://melmac.corp.harris.com/transparent_images.html

 SEE ALSO
      xv(1), giftoppm(1), ppmtogif(1)


























                                    - 4 -      Formatted:  November 14, 2024