<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC
   "-//OASIS//DTD DocBook XML V4.1.2//EN"
   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []>
<refentry id='gifcomb.1'>
<refentryinfo><date>2 May 2012</date></refentryinfo>
<refmeta>
<refentrytitle>gifcomb</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GIFLIB</refmiscinfo>
<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>gifcomb</refname>
<refpurpose>combine GIF images with mask</refpurpose>
</refnamediv>

<refsynopsisdiv id='synopsis'>

<cmdsynopsis>
  <command>gifcomb</command>
      <arg choice='opt'>-v</arg>
      <arg choice='opt'>-m <replaceable>maskfile</replaceable></arg>
      <arg choice='opt'>-h</arg>
      <arg rep='repeat'>
	<group><replaceable>gif-file</replaceable></group>
      </arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>

<para>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.</para>

</refsect1>
<refsect1><title>Options</title>

<variablelist>
<varlistentry>
<term>-v</term>
<listitem>
<para> Verbose mode.  
Enables printout of running scan lines. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>-m maskfile</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>Print one line of command line help, similar to Usage above.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Two GIF files must be specified; a third mask GIF file is optional.</para>

</refsect1>
<refsect1><title>Author</title>

<para>Gershon Elber.</para>

</refsect1>
</refentry>
