term% cat index.txt CROP(1) General Commands Manual CROP(1)
NAME
crop, iconv - frame, crop, and convert image
SYNOPSIS
crop [ -b red green blue ] [ -c red green blue ] [ -i n | -r minx miny
maxx maxy | -x dx | -y dy ] [ -t tx ty ] [ -b red green blue ] [ file ]
iconv [ -u ] [ -c chandesc ] [ file ]
DESCRIPTION
Crop reads an image(6) file (default standard input), crops it, and
writes it as a compressed image(6) file to standard output. There are
two ways to specify a crop, by color value or by geometry. They may be
combined in a single run of crop, in which case the color value crop
will be done first.
The -c option takes a red-green-blue triplet as described in color(2).
(For example, white is 255 255 255.) The corresponding color is used
as a value to be cut from the outer edge of the picture; that is, the
image is cropped to remove the maximal outside rectangular strip in
which every pixel has the specified color.
The -i option insets the image rectangle by a constant amount, n, which
may be negative to generate extra space around the image. The -x and
-y options are similar, but apply only to the x or y coordinates of the
image.
The -r option specifies an exact rectangle.
The -t option specifies that the image's coordinate system should be
translated by tx, ty as the last step of processing.
The -b option specifies a background color to be used to fill around
the image if the cropped image is larger than the original, such as if
the -i option is given a negative argument. This can be used to draw a
monochrome frame around the image. The default color is black.
Iconv changes the format of pixels in the image file (default standard
input) and writes the resulting image to standard output. Pixels in
the image are converted according to the channel descriptor chandesc,
(see image(6)). For example, to convert a 4-bit-per-pixel grey-scale
image to an 8-bit-per-pixel color-mapped image, chandesc should be m8.
If chandesc is not given, the format is unchanged. The output image is
by default compressed; the -u option turns off the compression.
EXAMPLE
To crop white edges off the picture and add a ten-pixel pink border,
crop -c 255 255 255 -i -10 -b 255 150 150 imagefile > cropped
SOURCE
/sys/src/cmd/crop.c
SEE ALSO
image(6), color(2)
BUGS
Iconv should be able to do Floyd-Steinberg error diffusion or dithering
when converting to small image depths.
CROP(1)