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
picfile(9.6) into 48x48 icons. It is designed to run in a
pipe, reading the picture from standard input unless a sin-
gle 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 but-
ton 3. Touch down at the top and center of the square
and slide around to adjust its size. Appropriately
cropped icons will be displayed.
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 written 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 pix-
els with aspect ratio 1.25, as produced by some frame grab-
bers. Normally pixels are assumed to be square. -1 and -2
Page 1 Plan 9 (printed 10/30/25)
MUGS(9.1) MUGS(9.1)
select the initial depth of the icons. -2 is default.
SOURCE
/sys/src/cmd/mugs.c
SEE ALSO
picfile(9.6)
Page 2 Plan 9 (printed 10/30/25)