<?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='gifclip.1'>
<refentryinfo><date>2 May 2012</date></refentryinfo>
<refmeta>
<refentrytitle>gifclip</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GIFLIB</refmiscinfo>
<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>gifclip</refname>
<refpurpose>clip a region from a GIF</refpurpose>
</refnamediv>

<refsynopsisdiv id='synopsis'>

<cmdsynopsis>
  <command>gifclip</command>
      <arg choice='opt'>-v</arg>
      <arg choice='opt'>-i 
      		<replaceable>xmin</replaceable>
      		<replaceable>ymin</replaceable>
      		<replaceable>xmax</replaceable>
      		<replaceable>ymax</replaceable></arg>
      <arg choice='opt'>-n
      		<replaceable>n</replaceable>
      		<replaceable>xmin</replaceable>
      		<replaceable>ymin</replaceable>
      		<replaceable>xmax</replaceable>
      		<replaceable>ymax</replaceable></arg>
      <arg choice='opt'>-c</arg>
      <arg choice='opt'>-h</arg>
      <arg choice='opt'><replaceable>gif-file</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>

<para>A program to clip images in GIF files.  Only one image in a GIF file
can be modified at a time.  Neither the image position on screen nor
the screen size is modified (use <ulink
url="gifpos.html">gifpos</ulink> for that).</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>-i xmin ymin xmax max</term>
<listitem>
<para> Clip first image to the dimensions as specified by the 4
coordinates (Xmin Ymin Xmax Ymax) of a box clipping region.</para>
<para>For example: '-i 11 22 33 44' will crop the box from top left [11,22]
to bottom right [33,44] out of the first image.</para>
<para>If the first parameter is bigger than third one (Xmin > Xmax) they are
swapped.  Same for Y.</para>
<para>The dimensions of the clipped image must be confined to original image
width and height.  Note the clipped image includes both the min &amp; max
boundary; an image of width W can have coordinates 0 to W-1 (zero based).</para>
<para>Only one of -i or -n can be specified.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-n n xmin ymin xmax ymax</term>
<listitem>
<para> Same as -i above but for the nth image: `-n 1 11 22 33 44' is
exactly the same as the example in -i.  Only one of -i or -n can be
specified.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-c</term>
<listitem>
<para>Complement.  This removes horizontal and/or vertical bands of
the image. For example `-c -i 638 3 658 13' would remove a horizontal
band 11 pixels deep beginning at raster line 3, and a vertical band 21
pixels right beginning at pixel 658.</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>Note: all coordinates are 0-based --- the top left corner is (0,
0).</para>

<para>If no GIF file is given, gifclip will try to read a GIF file
from stdin.</para>

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

<para>Gershon Elber.</para>

</refsect1>
</refentry>
