What each command does
Close, Grow <-->, Destroy, Reset, Save and Load operate in exactly the same way they do in a normal viewer.
RotateDisplay: This rotates the icons on display, including those icons which exist but are not visible on the screen. Currently the limit on icons which can be displayed on the screen is 20. But it is possible to have more than 20 icons in a file. Clicking the RotateDisplay button with the red/left mouse button will rotate the icons one at a time; clicking with any other mouse button will rotate the icons four at a time. Icons will rotate to the "right" if Shift is held down while clicking; without shift, icons will rotate to the "left".
DeleteIcon: This deletes the current icon. The current icon is the one which is displayed on the Drawing Board.
CreateIcon: This creates a new blank icon. If clicked with the left or middle mouse buttons, the new icon appears at the end of the list of icons; if clicked with the right mouse button, it is inserted before the current icon.
ShowLabel: Sketches the boundaries on the label area of the icon. A MessageWindow message is printed if the icon does not have a label.
CreateFilledIcon: This creates a new blank icon and then invokes the display bounding box utility. When the cursor turns to a bullseye, the user can sweep out an arbitrary rectangular area of the screen. The new icon will be filled with the upper left 64X64 square pixels of enclosed screen bitmap.
The following commands require that a rectangle be marked first. A rectangle can be marked by holding down the yellow mouse button and marking the diagonal of the rectangle.
ShiftUp, ShiftDn, ShiftLf, ShiftRt: Shifts (actually, rotates) the contents of the rectangle by one or four rows or columns in the desired direction. "Clicking" the Shift buttons with the red mouse button will shift the contents by one; "Clicking" the Shift buttons with the blue mouse button will shift the contents by 4. NOTE: if no rectangle has been marked, it is assumed that the entire icon will be shifted. WARNING: If your icon has a desk-top gray background, do not shift it by any other increment than 4, otherwise the gray pattern will be off.
Mirror: Achieves the effect of holding the marked rectangle to a mirror.
SetLabel: Stores the coordinates of the rectangle which has been marked as the label for the icon.
White, DeskTopGray, DarkGray, Black: fills in the marked rectangle with the selected color.
InvertColor: Simply inverts the black and white pixels in the marked rectangle.
The following command requires that a line be marked first. The mark a line, hold down the control key and the yellow mouse button and draw the desired line.
DrawLine: Uses a line drawing algorithm to draw the desired line.
The following commands are global commands.
UNDO: Undoes the following operations: ShiftUp, ShiftDn, ShiftLf, ShiftRt, Mirror, White, DeskTopGray, DarkGray, Black, InvertColor and DrawLine. UNDO only keeps track of one level of operations, so don't perform a series of operations and expect to get back to where you started from.
UnSetLabel: Removes the coordinates of the rectangle which had been marked as the label for the icon.
Register: Causes the icon to be registered with the Icon Registry using the name in the Icon Name window.
WhiteLabel: Sets a bit in the internal icon representation which tells the Viewers world to invert the text it paints on the icon when it labels the icon. This is useful when you have an icon which has a lot of black area and you wish to have the label painted in white on the black area..
BlackLabel: Resets a bit in the internal icon representation which tells the Viewers world to invert the text it paints on the icon when it labels the icon. This will result in black text in the label.
FetchIcon: This can be used to retrieve an icon from another icon file or to rearrange the order of the icons in the current file. Before using the Fetch Icon Button, a number must be typed into the Number window (Number[0-...]). The ordering of the icons is not always clear (i.e. - which number corresponds to the icon you want.) Immediately after loading, when the icons are displayed above the drawing board, the icon in the top left corner is #0 and the one to the right of it is #1. When the icons are displayed to the right of the drawing board, again the top left icon is #0, and the one to the right of it is again, #1.
If the FetchIcon button is pushed while depressing the Shift key, the bit array for the newly fetched icon is ORed into the current icon, without changing any of the other current icon parameters.