./_Man_SunOS_4.1.3_html/html1/iconedit.1.html

Manual page for ICONEDIT(1)

iconedit - create and edit images for SunView icons, cursors and panel items

SYNOPSIS

iconedit [ filename ]

OPTIONS

iconedit accepts the standard SunView command-line arguments; see sunview.1 for a list.

AVAILABILITY

This command is available with the SunView User's software installation option. Refer to [a manual with the abbreviation INSTALL] for information on how to install optional software.

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 labeled Dir: and File:, and one to the right of the abc labeled 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:

Dir: The current directory.
File: The 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 confirmation.
Size: Alter the canvas size. Choices are icon size (64 x 64 pixels) or cursor size (16 x 16 pixels).
Grid: Display 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:

dot: Paint a single dot at a time.
line: Draw 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.
circle: Draw 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.
abc: Insert 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.

Load: This is the rasterop to be used when loading a file in from disk. (See the [a manual with the abbreviation PIXRCT] for details on rasterops).
Fill: This 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.
Proof: This 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.

ENVIRONMENT

The environment variables LC_CTYPE, LANG, and LC_default control the character classification throughout iconedit. On entry to iconedit, these environment variables are checked in the following order: LC_CTYPE, LANG, and LC_default. When a valid value is found, remaining environment variables for character classification are ignored. For example, a new setting for LANG does not override the current valid character classification rules of LC_CTYPE. When none of the values is valid, the shell character classification defaults to the POSIX.1 ``C'' locale.