V8/usr/man/man9/mugs.9

.TH MUGS 9.1
.SH NAME
mugs \- convert gray-scale pictures into icons
.SH SYNOPSIS
.B mugs
picture ...
.SH DESCRIPTION
.I Mugs
is an interactive program for converting gray-scale images (usually scanned-in
photographs) into the 48\(mu48 icons used by
.IR vismon (9.1)
and other programs.
After digesting the first picture file,
mugs will display an approximation to the original picture,
a vertical slider-bar and a 48\(mu48 icon.  Hitting button 1 in the slider-bar
and sliding vertically adjusts the low and high points of values of the 48\(mu48
image.
Button 2 adjusts the low and high values simultaneously (i.e. it changes
the brightness without disturbing the contrast.)
Button 3 presents a menu with entries:
.TP
.B window
Select a square window in the original picture using button 3.  Touch down at
the center of the square and slide around to adjust its size.
.TP
.B save
Type in the name of a file in which to save the currently displayed 48\(mu48 icon.
.TP
.B next
Move on to the next picture mentioned on the command line.
.TP
.B exit
Confirm with button 3.
.SH FILES
/usr/jerq/mbin/mugsterm.m     terminal program
.SH BUGS
The format of
.IR mugs 's
input files is largely undocumented.
Among other things, it will accept files containing an array of one-byte pixels
of dimensions 480x512, 486x512, 488x512, 496x512, 497x512, 512x512,
2047x2048 or 2048x2048.