Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH MUG 1
2 
.SH NAME
3 
mug - convert an image to a face icon
4 
.SH SYNOPSIS
5 
.B mug
6 
[
7 
.I file
8 
]
9 
.SH DESCRIPTION
10 
.I Mug
11 
reads a Plan 9
12 
.IR image (6)
13 
from
14 
.I file
15 
(or standard input if there is no
16 
.IR file )
17 
and
18 
displays a working version of the icon
19 
a gray ramp,
20 
and a larger image (the `crop box'),
21 
all derived from
22 
.IR file .
23 
Selecting
24 
.L Write
25 
from the button-3 menu will write the icon in
26 
.IR face (6)
27 
format to standard output.
28 
.LP
29 
Imagine a 3x3 grid on the crop box.  You can move an
30 
edge or corner of the box by putting the mouse in the
31 
corresponding section of the grid and dragging.
32 
Dragging in the middle box in the grid translates the
33 
crop box.  The mouse cursor changes to tell you where you are.
34 
.LP
35 
The bar in the gray ramp controls the map from picture
36 
gray levels to the output levels.  The values along the
37 
bar are mapped to 0 through 255 in the output.  You can
38 
move the bar vertically by grabbing the midsection or
39 
adjust the width by grabbing an endpoint.
40 
.LP
41 
The current icon is shown in the bottom left corner,
42 
surrounded by eight small empty boxes.  You can save the
43 
settings as they are by dragging the current icon into
44 
one of the other boxes.  You can restore the settings by
45 
dragging an icon from one of the periphery boxes into the middle.
46 
.SH EXAMPLES
47 
Convert a JPEG image into a face icon.
48 
.IP
49 
.EX
50 
jpg -c plus.jpg | mug >plus.1
51 
.EE
52 
.SH SEE ALSO
53 
.IR faces (1),
54 
.IR jpg (1),
55 
.IR face (6),
56 
.IR image (6)