unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (plan9)
Page:
Section:
Apropos / Subsearch:
optional field

MUGS(9.1)                                                            MUGS(9.1)



NAME
       mugs -  make face icons from pictures

SYNOPSIS
       mugs [ -a ] [ -1 ] [ -2 ] [ file ]

DESCRIPTION
       Mugs  interactively  converts  grey-scale  images  in  the form of pic-
       file(9.6) into 48x48 icons.  It is designed to run in a  pipe,  reading
       the  picture  from  standard input unless a single file is given on the
       call.  Mugs displays a large approximation to the original picture  and
       a  matrix  of 48x48 icons of varying contrast and brightness.  Button 1
       selects one of the icons.  Button 2 offers the menu entries:

       in     Zoom in to a finer contrast/brightness range around the selected
              icon.  Repeated ins will zoom in farther.

       out    Opposite of in.

       reset  Set the brightness/contrast range to the maximum.

       Both in and out preserve the brightness/contrast values in the selected
       icon.  Button 3 presents a menu with entries:

       window Select a square window in the  large  picture  using  button  3.
              Touch  down at the top and center of the square and slide around
              to adjust its size.  Appropriately cropped icons  will  be  dis-
              played.

       depth  Toggle between 1- and 2-bit deep icons.

       write  Write the selected icon to standard output.  Each write produces
              48 lines of text suitable for initializing an array in C.  1-bit
              deep icons produce three shorts per line; 2-bit depths are writ-
              ten as three longs per line.

       abort  Terminate mugs with a non-blank error return.

       finish Terminate with a null status return.

       Option -a indicates that picture  files  have  non-square  pixels  with
       aspect ratio 1.25, as produced by some frame grabbers.  Normally pixels
       are assumed to be square.  -1 and -2 select the initial  depth  of  the
       icons.  -2 is default.

SOURCE
       /sys/src/cmd/mugs.c

SEE ALSO
       picfile(9.6)



                                                                     MUGS(9.1)