glenda.party
term% ls -F
term% cat index.txt
MUG(1)                      General Commands Manual                     MUG(1)



NAME
       mug - convert an image to a face icon

SYNOPSIS
       mug [ file ]

DESCRIPTION
       Mug reads a Plan 9 image(6) from file (or standard input if there is no
       file) and displays a working version of the icon a  gray  ramp,  and  a
       larger  image  (the `crop box'), all derived from file.  Selecting from
       the button-3 menu will write the icon in  face(6)  format  to  standard
       output.

       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.

       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.

       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.

EXAMPLES
       Convert a JPEG image into a face icon.

              jpg -c plus.jpg | mug >plus.1

SEE ALSO
       faces(1), jpg(1), face(6), image(6)



                                                                        MUG(1)