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.
SEE ALSO
sunview.1
[a manual with the abbreviation PIXRCT]
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97