term% cat index.txt 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 48×48 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 48×48 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 as‐
pect 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)