127 lines
6 KiB
HTML
127 lines
6 KiB
HTML
<head>
|
|
<title>crop(1) - Plan 9 from User Space</title>
|
|
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
|
|
</head>
|
|
<body bgcolor=#ffffff>
|
|
<table border=0 cellpadding=0 cellspacing=0 width=100%>
|
|
<tr height=10><td>
|
|
<tr><td width=20><td>
|
|
<tr><td width=20><td><b>CROP(1)</b><td align=right><b>CROP(1)</b>
|
|
<tr><td width=20><td colspan=2>
|
|
<br>
|
|
<p><font size=+1><b>NAME </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
crop, iconv – frame, crop, and convert image<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>SYNOPSIS </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<tt><font size=+1>crop</font></tt> [ <tt><font size=+1>−c</font></tt> <i>red green blue</i> ] [ <tt><font size=+1>−i</font></tt> <i>n</i> | <tt><font size=+1>−x</font></tt> <i>dx</i> | <tt><font size=+1>−y</font></tt> <i>dy</i> | <tt><font size=+1>−r</font></tt> <i>minx miny
|
|
maxx maxy</i> ] [ <tt><font size=+1>−t</font></tt> <i>tx ty</i> ] [ <tt><font size=+1>−b</font></tt> <i>red green blue</i> ] [ <i>file</i> ]
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<tt><font size=+1>iconv</font></tt> [ <tt><font size=+1>−u</font></tt> ] [ <tt><font size=+1>−c</font></tt> <i>chandesc</i> ] [ <i>file</i> ]<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>DESCRIPTION </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<i>Crop</i> reads an <a href="../man7/image.html"><i>image</i>(7)</a> file (default standard input), crops it,
|
|
and writes it as a compressed <a href="../man7/image.html"><i>image</i>(7)</a> 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 <i>crop</i>, in which case the
|
|
color value crop will be done first.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <tt><font size=+1>−c</font></tt> option takes a red-green-blue triplet as described in <a href="../man3/color.html"><i>color</i>(3)</a>.
|
|
(For example, white is <tt><font size=+1>255 255 255</font></tt>.) 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.
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <tt><font size=+1>−i</font></tt> option insets the image rectangle by a constant amount,
|
|
<i>n</i>, which may be negative to generate extra space around the image.
|
|
The <tt><font size=+1>−x</font></tt> and <tt><font size=+1>−y</font></tt> options are similar, but apply only to the <i>x</i> or
|
|
<i>y</i> coordinates of the image.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <tt><font size=+1>−r</font></tt> option specifies an exact rectangle.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <tt><font size=+1>−t</font></tt> option specifies that the image’s coordinate system should
|
|
be translated by <i>tx</i>, <i>ty</i> as the last step of processing.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <tt><font size=+1>−b</font></tt> 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 <tt><font size=+1>−i</font></tt> option is given a negative argument. This can
|
|
be used to draw a monochrome frame around the image. The default
|
|
color is black.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<i>Iconv</i> changes the format of pixels in the image <i>file</i> (default
|
|
standard input) and writes the resulting image to standard output.
|
|
Pixels in the image are converted according to the channel descriptor
|
|
<i>chandesc</i>, (see <a href="../man7/image.html"><i>image</i>(7)</a>). For example, to convert a 4-bit-per-pixel
|
|
grey-scale image to an 8-bit-per-pixel color-mapped
|
|
image, <i>chandesc</i> should be <tt><font size=+1>m8</font></tt>. If <i>chandesc</i> is not given, the format
|
|
is unchanged. The output image is by default compressed; the <tt><font size=+1>−u</font></tt>
|
|
option turns off the compression.<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>EXAMPLE </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
To crop white edges off the picture and add a ten-pixel pink border,<br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<tt><font size=+1>crop −c 255 255 255 −i −10 −b 255 150 150 imagefile > cropped<br>
|
|
</font></tt>
|
|
</table>
|
|
|
|
</table>
|
|
<p><font size=+1><b>SOURCE </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<tt><font size=+1>/usr/local/plan9/src/cmd/draw/crop.c<br>
|
|
</font></tt>
|
|
</table>
|
|
<p><font size=+1><b>SEE ALSO </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<a href="../man7/image.html"><i>image</i>(7)</a>, <a href="../man3/color.html"><i>color</i>(3)</a><br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>BUGS </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<i>Iconv</i> should be able to do Floyd-Steinberg error diffusion or
|
|
dithering when converting to small image depths.<br>
|
|
|
|
</table>
|
|
|
|
<td width=20>
|
|
<tr height=20><td>
|
|
</table>
|
|
<!-- TRAILER -->
|
|
<table border=0 cellpadding=0 cellspacing=0 width=100%>
|
|
<tr height=15><td width=10><td><td width=10>
|
|
<tr><td><td>
|
|
<center>
|
|
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
|
|
</center>
|
|
</table>
|
|
<!-- TRAILER -->
|
|
</body></html>
|