sys/man/1/mug

   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)