blob: 9710b4f6eaae467b111453d449fdcbad7ae87fdd [file] [log] [blame]
<!doctype HTML public "-//W3O//DTD W3 HTML 2.0//EN">
<HTML>
<HEAD>
<TITLE>gifclip</TITLE>
<link rev=made href=mailto:esr@snark.thyrsus.com>
</HEAD>
<BODY>
Go to <a href="index.html">index page</a>.
<CENTER><H1>gifclip</H1></CENTER>
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 <a href="gifpos.html">gifpos</a> for that).<P>
<H1>Usage:</H1>
<pre>
gifclip [-q] [-i Xmin Ymin Xmax Ymax] [-n n Xmin Ymin Xmax Ymax] [-c] [-h] gif-file
</pre>
If no gif-file is given, GifClip will try to read a GIF file from stdin.<P>
<H1>Memory required:</H1>
Line.
<H1>Options:</H1>
<DL>
<DT> [-q]
<DD> Quiet mode. Default off on MSDOS, on under UNIX. Controls printout
of running scan lines. Use -q- to invert.<P>
<DT> [-i Xmin Ymin Xmax Ymax]
<DD> Clip first image to the dimensions as specified
by the 4 coordinates (Xmin Ymin Xmax Ymax) of a box clipping region.<P>
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.<P>
If the first parameter is bigger than third one (Xmin > Xmax) they are
swapped. Same for Y.<P>
The dimensions of the clipped image must be confined to original image
width and height. Note the clipped image includes both the min & max
boundary; an image of width W can have coordinates 0 to W-1 (zero based).<P>
Only one of -i or -n can be specified.<P>
<DT> [-n n Xmin Ymin Xmax Ymax]
<DD> 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.<P>
<DT> [-c]
<DD> 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.<P>
<DT> [-h]
<DD> Print one line of command line help, similar to Usage above.<P>
</DL>
Note: all coordinates are 0-based --- the top left corner is (0, 0).<P>
<H1>Author:</H1>
Gershon Elber
<HR>
<ADDRESS>Eric S. Raymond <A HREF="mailto:esr@thyrsus.com">&lt;esr@snark.thyrsus.com&gt;</A></ADDRESS>
</BODY>
</HTML>