From b41b9034225ab3e49980d9de55c141011b6383b0 Mon Sep 17 00:00:00 2001 From: Taru Karttunen Date: Wed, 30 Mar 2011 16:49:47 +0300 Subject: Import sources from 2011-03-30 iso image - sys/man --- sys/man/1/mug | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100755 sys/man/1/mug (limited to 'sys/man/1/mug') diff --git a/sys/man/1/mug b/sys/man/1/mug new file mode 100755 index 000000000..93815fc0b --- /dev/null +++ b/sys/man/1/mug @@ -0,0 +1,56 @@ +.TH MUG 1 +.SH NAME +mug - convert an image to a face icon +.SH SYNOPSIS +.B mug +[ +.I file +] +.SH DESCRIPTION +.I Mug +reads a Plan 9 +.IR image (6) +from +.I file +(or standard input if there is no +.IR file ) +and +displays a working version of the icon +a gray ramp, +and a larger image (the `crop box'), +all derived from +.IR file . +Selecting +.L Write +from the button-3 menu will write the icon in +.IR face (6) +format to standard output. +.LP +Imagine a 3x3 grid on the crop box. You can move an +edge or corner of the box by putting the mouse in the +corresponding section of the grid and dragging. +Dragging in the middle box in the grid translates the +crop box. The mouse cursor changes to tell you where you are. +.LP +The bar in the gray ramp controls the map from picture +gray levels to the output levels. The values along the +bar are mapped to 0 through 255 in the output. You can +move the bar vertically by grabbing the midsection or +adjust the width by grabbing an endpoint. +.LP +The current icon is shown in the bottom left corner, +surrounded by eight small empty boxes. You can save the +settings as they are by dragging the current icon into +one of the other boxes. You can restore the settings by +dragging an icon from one of the periphery boxes into the middle. +.SH EXAMPLES +Convert a JPEG image into a face icon. +.IP +.EX +jpg -c plus.jpg | mug >plus.1 +.EE +.SH SEE ALSO +.IR faces (1), +.IR jpg (1), +.IR face (6), +.IR image (6) -- cgit v1.2.3