ICONEDIT(1) — USER COMMANDS

NAME

iconedit − create and edit images for OpenWindows icons, cursors and panel items

SYNOPSIS

iconedit [ filename ] [ XView command-line arguments ]

AVAILABILITY

This command is available with the OpenWindows user environment. For information about installing OpenWindows, refer to the OpenWindows Installation and Start-Up Guide . For information about the XView command-line arguments see the XView Programming Manual .

OPTIONS

filename Contains the image.

XView command-line arguments
iconedit accepts the XView command-line arguments listed in xview(1).

DESCRIPTION

iconedit is part of the OpenWindows DeskSet. proIt requires the pixrect library for its operation. With iconedit you can create and edit small images for use in icons, cursors, panel items, etc. iconedit has several submenus. Two of the submenus are visible at startup, the Main window and the Draw pop-up menu.

Main Window

Contains the drawing area (or canvas) together with the command panel and the message area underneath the canvas. From the control panel, you have the following pull-down menus.

File

Directory Specify the directory where the image is located.

File Specify the name of the file with the image. If you are not sure of the file name, use a regular expression for the File field or leave it blank, and it switches to Browse when you press Load. If you already have an image in the canvas, it asks for confirmation before loading. You can also load a file by dragging the file icon from File Manager and dropping it into iconedit.

Load Operation:
Choose one of the operations using the abbreviated menu button.

Source (Overwrite Canvas)
Loads a file overwriting any existing information on the canvas.

Or (Union)
Loads a file transparently over another image, allowing any existing information on the canvas to show through the new file.

Xor (Exclusive Or)
Loads a file transparently over another image, turning bits that are on in both images off and leaving the other bits unchanged.

And (Intersection)
Loads a file transparently over another image, retaining only the bits that are on in both images and turning all other bits off.

Load This button loads in the file named in the Directory and File fields. Choose the raster operation to load it with.

Save Saves your current image in the file specified in the Directory and File fields. If the file exists, iconedit asks for confirmation before overwriting the file.

Browse Searches the directory specified in the Directory: field for image files with names matching the regular expression in the File field. If the File field is empty, it assumes the regular expression ∗ (search all files). If images are found, they are displayed in a pop-up, scrollable window for browsing. If no images are found, iconedit will report this in the menu area. From the browse window you can load an image by selecting it with the left mouse button. The Load operation will take into account the current load operation specified in the pop-up.

View

Grid Turns a grid on or off in the display area. One grid square is a 4x4 area of pixels.

Size Changes the size of the canvas. There are four sizes: 64x64 (icon size); 48x48; 32x32; and 16x16 (cursor size). When you switch to a smaller size, the rest of the canvas is hidden but not lost. Editing operations, however, will only affect the visible portion of the canvas. Saving will save only the visible portion of the image.

Preview Opens the preview window for previewing a life-size version of the image being edited.

Gray Shades
Ten varying gray shades are available for filling the background. Click the left mouse button on the desired shade to load it.

Fill Select one of the four raster operations available from the abbreviated menu button. The source for the raster operation is the preview image and the destination is the preview background.

Source (Overwrite Canvas)
Overwrites any existing information on the canvas.

Or (Union)
Any existing information on the canvas shows through.

Xor (Exclusive Or)
Bits in both images are turned off and any other bits are unchanged.

And (Intersection)
Only the bits that are on in both images are left on. All other bits are turned off.

Edit This menu is attached to the canvas.

Undo Undoes the last operation. Restores the canvas to the state it was in before the last Edit operation. A second Undo undoes the previous Undo.

Draw Window
Displays the options available for drawing. To draw in black, use the left mouse button; to draw in white (erase), use the middle mouse button. As you draw, an enlarged version of the image appears in the canvas while a life size version of the image appears in the control panel as well as in the preview window.

Mode Choose one of the following modes. The gray shade selected in the Fill pop-up and the operation selected from the Operation pop-up will be used.

Dot Paints a single dot at a time.

Line Draws a line. Point to the first endpoint and press and hold the left (or middle) button. Drag to another endpoint and release the button to draw the line.

Rectangle Draws a rectangle. Press the mouse button (left or middle) at one corner of the desired rectangle. Drag to the opposite corner and release. For different rectangle shades, select the desired shade from the Fill menu.

Circle Draws a circle. Press the mouse button at the center and drag to the edge and release the button. For different shades, select the desired shade from the Fill menu.

Oval Draws an oval. Press the mouse button at the center of the oval and drag to the edge of the enclosing rectangle. For different shades, select the desired shade from the Fill menu.

Region Select the desired rectangular region by pressing the left (or middle) mouse button at one corner, drag it to the opposite corner, and release. A boundary box shows you the selection. After specifying the region, choose the move operation desired from the Draw window.

Text Writes text on the image. Pops up the Text window that has a field for typing the string to be added to the icon. Once you press either the left or middle mouse button, a box appears. Position the box where the text is desired and release the mouse button. It also has a menu of available fonts and their sizes. To switch fonts, select from the menus provided. To change the set of available fonts, edit the file .iconedit. A default .iconedit file can be found in $OPENWINHOME/bin/xview. You may copy this default file into your home directory and edit it. The format is explained in the default file.

Operation:

Source (Overwrite Canvas)
Overwrites any existing information on the canvas.

Or (Union)
Any existing information on the canvas shows through.

Xor (Exclusive Or)
Bits in both images are turned off and any other bits are unchanged.

And (Intersection)
Only the bits that are on in both images are left on. All other bits are turned off.

Move Shows eight arrows that indicate the ways of moving your image. If you have selected region from the draw menu, only the specified region is affected by the move operation. If region is not selected, the entire image is moved.

Invert Invert all pixels on the canvas. Toggles from Off to On or vice versa.

Clear Clears the canvas.