ICONEDIT(1) — USER COMMANDS
NAME
iconedit − create and edit small images for icons, cursors, panel items, etc.
SYNOPSIS
iconedit [ filename ]
OPTIONS
iconedit accepts the standard SunView command-line arguments; see suntools(1) for a list.
DESCRIPTION
iconedit is a standard tool provided with the SunView environment. With it you can create and edit small images for use in icons, cursors, panel items, etc. iconedit has several subwindows:
•A large drawing area or canvas (on the left).
•A small proof area for previewing a life-size version of the image being edited (at the lower right).
•A control panel showing the options available and their current state (at the center right).
•An area for status messages (at the upper right).
•An area containing instructions for the use of the mouse (above the drawing canvas).
Inside the canvas, use the left button to draw and the middle button to erase. As you draw, an enlarged version of the image appears in the canvas, while a life-sized version of the image appears in the proof area. Use the right button to undo the previous operation.
While editing a cursor image, you can try the cursor out against different backgrounds and with different raster operations by moving the cursor into the proof area.
CONTROL PANEL
The large control panel to the right of the canvas contains many items through which you can control iconedit. Some items are buttons which allow you to initiate commands, some are text fields which you type into, and some are choice items allowing you select from a range of options. Use the left button to select items. Most items also have a menu which you can invoke with the right button.
There are three text fields: the two at the top labelled “Dir:” and “File:”, and one to the right of the “abc” labelled “Fill:”. A triangular caret points to the current type-in position. Typing <return> advances the caret to the next text field; you can also move the caret to a text field by selecting the field with the left button.
Each item in the control panel is described below:
DirThe current directory.
FileThe current filename. The default is the filename given on the command line. You can request filename completion by pressing <ESC>. iconedit searches the current directory for files whose names begin with the string you entered. If the filename search locates only one file, that file will be loaded in. In addition, typing CTRL-L, CTRL-S, CTRL-B or CTRL-Q are equivalent to pressing the Load, Store, Browse, or Quit buttons, respectively.
Load(Button) Load the canvas from the file named in the File field.
Store(Button) Store the current image in the file named in the File field.
Browse
(Button) Display all the images in the current directory in a popup panel. When you select an image with the left button, it will be loaded into the canvas for editing and the browsing panel will be hidden. Pressing browse again will cause the panel to popup again (it will come up immediately if the directory and file fields have not been modified).
Quit(Button) Terminate processing. Quitting requires a confirming click of the left mouse button.
SizeAlter the canvas size. Choices are icon size (64 x 64 pixels) or cursor size (16 x 16 pixels).
GridDisplay a grid over the drawing canvas, or turn the grid off.
Clear(Button) Clear the canvas.
Fill(Button) Fill canvas with current rectangular fill pattern.
Invert(Button) Invert each pixel represented on the canvas.
Paintbrush
Select from among five painting modes. Instructions for each painting mode appear above the canvas. The painting modes are:
dotPaint a single dot at a time.
lineDraw a line. To draw a line on the canvas, point to the first endpoint of the line, and press and hold the left mouse button. While holding the button down, drag the cursor to the second endpoint of the line. Release the mouse button.
rectangle
Draw a rectangle. To draw a rectangle on the canvas, point to the first corner of the rectangle and press and hold the left mouse button. While holding the button down, drag the cursor to the diagonally opposite corner of the rectangle. Release the mouse button.
In the control panel, the Fill field to the right of the rectangle indicates the current rectangle fill pattern. Any rectangles you paint on the canvas will be filled with this pattern.
circleDraw a circle. To draw a circle on the canvas, point to the center of the circle, and press and hold the left mouse button. While holding the button down, drag the cursor to the desired edge of the circle. Release the mouse button.
In the control panel, the Fill field to the right of the circle indicates the current circle fill pattern. Any circles you paint on the canvas will be filled with this pattern.
abcInsert text. To insert text, move the painting hand to “abc” and type the desired text. Then move the cursor to the canvas and press and hold the left mouse button. A box will appear where the text is to go. Position the box as desired and release the mouse button.
In addition, you can choose the font in which to draw the text. Point at the Fill field to the right of the “abc” and either click the left mouse button to cycle through the available fonts or press and hold the right mouse button to bring up a menu of fonts.
LoadThis is the rasterop to be used when loading a file in from disk. (See the Pixrect Reference Manual for details on rasterops).
FillThis is the rasterop to be used when filling the canvas. The source for this operation is the rectangle fill pattern, and the destination is the canvas.
ProofThis is the rasterop to be used when rendering the proof image. The source for this operation is the proof image, and the destination is the proof background.
Proof background
The proof background can be changed to allow you to preview how the image will appear against a variety of patterns. The squares just above the proof area show the patterns available for use as the proof background pattern. To change the proof background, point at the desired pattern and click the left mouse button.
SEE ALSO
FILES
/usr/bin/iconedit
Sun Release 3.2 — Last change: 17 September 1985