ICON(1)

NAME
icon - interactive icon drawing program

SYNOPSIS
icon [ -x m ] [ -y n ] [ -c ]

DESCRIPTION
The icon utility is a menu-driven interactive icon and picture drawing program. It runs under layers using the "mouse" and keyboard for command and text entry. The default icon display consists of a 50X50 cell grid in the lower right-hand corner of the layer in which icon is invoked. By invoking icon with the -x and -y flags, the grid size may be specified to be mXn, overriding the default. Each cell in this grid corresponds to a single bit in the icon being created or edited. In the upper left-hand corner of the layer, an actual size view of the icon is displayed.

The -c option causes icon to be cached in the 630 MTG application cache.

The grid size parameters m and n must be in the range of 1 to 480. A parameter larger than 480 is reduced to 480, and a parameter smaller than 1 is set to the default value of 50.

If icon is invoked in a window that is too small for the specified grid size, icon will display a grid icon in the upper left corner of the window along with a message ``menu on button 2''. The window must be reshaped before icon will continue. At this point a menu on button 2 will contain a reshape selection. If selected, icon will automatically reshape its window to a size and shape appropriate for the grid size. Alternately, the button 3 reshape function can be used to manually reshape the window. If at any time the window is again reshaped to a size too small to display the selected grid size, icon will redisplay the grid icon and the ``menu on button 2'' message.

When using icon, the meanings of the three mouse buttons are as follows:

Button 1
    Button 1, when depressed and held in, fills in the grid position pointed to by the mouse cursor.

Button 2
    Button 2, when depressed and held in, clears the grid position pointed to by the mouse cursor.

Button 3
    Button 3, when depressed, displays a matrix of icons. By moving the cursor (now a box) over the desired icon and releasing the button, commands will be invoked. If the command requires a section of the grid display to be selected, depressing button 2 will select a 16x16 grid outline. To specify other than this 16x16 grid outline, depress button 3 and sweep out the rectangle you wish the command to act on.

  Commands
The command selection matrix icons are described below from the upper left by rows to the bottom right. On the bottom row is a help command designated by the word "help."

Arrow
    move selection to another portion of the grid.

Copier
    copy selection to another portion of the grid.

Black and white squares
    change light squares to dark and dark squares to light (invert video).

Garbage can
    erase.

Horizontal wrap arrow
    flip on the x-axis.

Vertical wrap arrow
    flip on the y-axis.

To right and down arrow
    rotate 90 degrees clockwise.

Up and to left arrow
    rotate 90 degrees counterclockwise.

Horizontal lines
    shear along the x-axis.

Vertical lines
    shear along the y-axis.

Four line sets
    stretch (expand).

Pinwheels
    take one pattern and make many copies of it.

Eyeglasses
    read an icon file.

Grid
    draw a reference grid.

Mouse
    change current mouse cursor to selected 16 x 16 grid.

Quill pen
    write an icon file.

Grid, arrow to grid
    bitblt operator.

HELP
    prints the help menu.

Smoking gun
    exit the icon program.

  Cursor Icons
The following are status indicator icons that the mouse cursor changes to under various conditions:

Alarm clock
    wait.

Dead Mouse
    mouse inactive.

Dark square in stack
    menu on button 3.

Square with arrow
    sweep rectangle (button 3).

Double square with arrow
    sweep rectangle (button 3) or get 16x16 grid frame (button 2).

FILES
$DMD/lib/icon.m    terminal support program
$DMD/icons/*    icons

SEE ALSO
ucache(1).
layers(1) in the UNIX System V Release 3 User's Reference Manual.
layers(1) in the 5620 Dot-Mapped Display Reference Manual.