CROP(1)

💅 CROP(1) — from the General Commands Manual, and it's giving image-glowup 🦋

✨ NAME ✨

crop, iconv — frame, crop, and convert image.

📸 SYNOPSIS 📸

crop [ -c red green blue ] [ -i n | -x dx | -y dy | -r minx miny maxx
     maxy ] [ -t tx ty ] [ -b red green blue ] [ file ]

iconv [ -u ] [ -c chandesc ] [ file ]

💖 DESCRIPTION 💖

Okay so crop reads an image(7) file — default standard input, bestie — crops it, and writes it as a compressed image(7) file to standard output. Iconic. 🫶

There are literally two ways to specify a crop: by color value or by geometry. You can combine them in a single run of crop, and when you do, the color value crop is done first. Periodt.

🎀 crop option vibes

• -c red green blue — takes a red-green-blue triplet as described in color(3). For example, white is 255 255 255. That 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. Yes, the whole maximal outside rectangular strip. She's thorough. 💅
• -i n — insets the image rectangle by a constant amount, n, which may be negative to generate extra space around the image. Negative n = extra space, iykyk.
• -x dx — similar to -i, but applies only to the x coordinate of the image.
• -y dy — similar to -i, but applies only to the y coordinate of the image.
• -r minx miny maxx maxy — specifies an exact rectangle. No guessing, just coordinates.
• -t tx ty — specifies that the image's coordinate system should be translated by tx, ty as the last step of processing. Last step means last step, bestie.
• -b red green blue — 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 option vibes

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

• -c chandesc — the channel descriptor used for the pixel conversion (see image(7)). If it's not given, the format stays unchanged.
• -u — turns off compression for the output image. Compression is on by default.

🌸 EXAMPLE 🌸

To crop white edges off the picture and add a ten-pixel pink border, do this:

crop -c 255 255 255 -i -10 -b 255 150 150 imagefile > cropped

📂 SOURCE 📂

/src/cmd/draw/crop.c

👀 SEE ALSO 👀

image(7), color(3)

💀 BUGS 💀

Iconv should be able to do Floyd-Steinberg error diffusion or dithering when converting to small image depths.

okay bestie, that's the CROP(1) page — footer check: it just says CROP(1), with no version or date listed, so this is your girl signing off 💖🎀