unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

ICONEDIT(1)                 General Commands Manual                ICONEDIT(1)



NAME
       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  sun-
       view(1) for a list.

AVAILABILITY
       This command is available with the SunView User's software installation
       option.  Refer to 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:

              o  A large drawing area or canvas (on the left).

              o  A small proof area for previewing a life-size version of  the
                 image being edited (at the lower right).

              o  A  control panel showing the options available and their cur-
                 rent state (at the center right).

              o  An area for status messages (at the upper right).

              o  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  dif-
       ferent  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 addi-
              tion, 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  direc-
              tory 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 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 desti-
              nation 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)

                                2 October 1989                     ICONEDIT(1)