GIFCLIP(1)

NAME
gifclip - clip a region from a GIF

SYNOPSIS

gifclip [-v] [-i xmin ymin xmax ymax] [-n n xmin ymin xmax ymax] [-c] [-h] [gif-file]

DESCRIPTION

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 gifpos[1] for that).

OPTIONS

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

-i xmin ymin xmax max
    Clip first image to the dimensions as specified by the 4 coordinates (Xmin Ymin Xmax Ymax) of a box clipping region.

    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.

    If the first parameter is bigger than third one (Xmin > Xmax) they are swapped. Same for Y.

    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).

    Only one of -i or -n can be specified.

-n n xmin ymin xmax ymax
    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.

-c
    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.

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

Note: all coordinates are 0-based --- the top left corner is (0, 0).

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

AUTHOR

Gershon Elber.

NOTES

1.  gifpos
    [set $man.base.url.for.relative.links]/gifpos.html