<?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" [
<!ENTITY email         "esr@thyrsus.com">
]>
<refentry id='gifovly.1'>
<refentryinfo><date>2 May 2012</date></refentryinfo>
<refmeta>
<refentrytitle>gifovly</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GIFLIB</refmiscinfo>
<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>gifovly</refname>
<refpurpose>composite images in a multi-image GIF as layers</refpurpose>
</refnamediv>

<refsynopsisdiv id='synopsis'>

<cmdsynopsis>
  <command>gifovly</command>
      <arg choice='opt'>-t <replaceable>trans-color</replaceable></arg>
      <arg choice='opt'>-h</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>This program takes a multi-image GIF file and generates a single GIF
consisting of all the images overlayed.  Each image's screen position
is used.  Thus, you can use this together with <ulink
url="gifpos.html">gifpos</ulink> and <ulink url="gifasm.html">gifasm</ulink> to
paste together images.</para>

<para>The GIF to be operated is read in from stdin.  The result GIF is
written to stdout.</para>

</refsect1>
<refsect1><title>Options</title>
<variablelist>
<varlistentry>
<term>-t num</term>
<listitem>
<para>If this index is given, any pixel in images after the first that
has this value is not copied.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>Print one line of command line help, similar to Usage
above.</para>
</listitem>
</varlistentry>
</variablelist>

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

<para>Eric S. Raymond <email>&email;</email>.</para>

</refsect1>
</refentry>
