DragonFly On-Line Manual Pages

GIFCOMB(1)                   GIFLIB Documentation                   GIFCOMB(1)

NAME
       gifcomb - combine GIF images with mask

SYNOPSIS
       gifcomb [-v] [-m maskfile] [-h] [[gif-file]...]

DESCRIPTION
       A program to combine 2 GIF images of exactly the same size into one.
       The color maps are merged, but the result may not exceed 256 colors. A
       boolean mask GIF file can be used to set which pixel from two images to
       use at each location. Otherwise any background color from first image
       is converted to second image color at that point. Only the first image
       of each file is combined; again, all files' first images must be of
       exactly the same size.

OPTIONS
       -v
           Verbose mode. Enables printout of running scan lines.

       -m maskfile
           The maskfile can be regular GIF file whose first image has same
           dimensions as the combined images. Any non-background color in it
           will select Image 1 Pixel to output, otherwise Image2 pixel will be
           selected. Usually this image will be boolean (two colors only) but
           it does not have to be.

       -h
           Print one line of command line help, similar to Usage above.

       Two GIF files must be specified; a third mask GIF file is optional.

AUTHOR
       Gershon Elber.

GIFLIB                            2 May 2012                        GIFCOMB(1)