Solaris Common Desktop Environment: User's Guide

Chapter 15 Using Icon Editor

Icon Editor is a tool for creating both bitmap and pixmap image files for use as icons or backdrops.

Introducing Icon Editor

Icon Editor enables you to create and edit images in two formats, described in Table 15–1.

Table 15–1 Icon Formats

Format 

Description 

File Name 

X pixmap (XPM)  

Multicolor images that include static and dynamic colors 

*.pm

X bitmap (XBM) 

Two-color images limited to a foreground and background color (used for black and white icons) 

*.bm

Figure 15–1 Icon Editor main window

Graphic

You create images by selecting drawing tools and colors, and using them in the work area. As you draw, Icon Editor displays an actual-size copy of your icon in both formats. You need to consider the two-color version of the icon even if you are drawing an image for use on color systems, because icons may revert to two colors if there are not enough free colors available on the workspace.

For information on designing icons, read the Visual Design chapter in Common Desktop Environment: Style Guide and Certification Checklist.

Startup

To start Icon Editor:

  1. Open Application Manager and display the Desktop_Apps folder therein.

    Graphic
  2. Double-click Icon Editor.

    Icon Editor starts with an empty drawing work area.

You can also start Icon Editor and have it load an icon into the work area in one of the following ways:


Note –

If the path /usr/dt/bin has not been set in your .cshrc file, then type /usr/dt/bin/dticon to run Icon Editor from the command line.


Basic Drawing Tasks

This section describes how to create and edit an icon and how to use the Icon Editor drawing tools.

To Open an Existing Icon

  1. Choose Open from the File menu.

    If you have unsaved changes, Icon Editor warns you that your changes will be lost by loading another icon. Click Cancel to cancel the Open command. Click OK if you don't want to save your changes.

  2. Type the name of the file you want to load in the Enter file name field, or select the icon file you want to load from the Files section of the Open File dialog box.

  3. Click Save.


    Note –

    When you load a file, the Output Format (in the Options menu) is automatically set to the format of the file you load.


    You can also open an existing icon by double-clicking the icon file in File Manager.

To Start a New Icon

    Choose New from the File menu.

If you have unsaved changes, Icon Editor warns you that your changes will be lost by starting a new icon. Click Cancel to cancel the New command or click OK if you don't want to save your changes.

Icon Editor clears the work area and resizes it to the default size (32x32).

If you have an icon already loaded, you can choose Clear Icon from the Edit menu to start a new icon with the same size and name as the previously loaded icon.

To Clear an Icon

  1. Save your current icon, if necessary.

  2. Choose Clear Icon from the Edit menu.

    The entire icon drawing work area is cleared.

To Draw an Image

  1. Select one of the drawing tools (listed in Table 15–2).

  2. Select a color (static color, static gray, or a dynamic color).

  3. Begin drawing with the tool you've selected.

    More details on drawing with each tool are provided below.

Drawing Tools

The drawing tools area of Icon Editor is shown in Figure 15–2.

Figure 15–2 Icon Editor drawing tools

Graphic

Table 15–2 Using the Drawing Tools

Tool 

Purpose 

Action 

Pencil 

For drawing freehand lines and individual pixels. 

Press and hold to draw freehand lines. 

Line 

For drawing straight lines. 

Press and hold to stretch the line. Release to draw the line. 

Rectangle 

For drawing solid or outlined rectangles. 

Press and hold to stretch the outline of the rectangle. Release to draw the rectangle. 

Circle 

For drawing solid or outlined circles. 

Point to where you want the center of the circle, press and hold, drag to the desired size, and release.  

Eraser 

For erasing large areas of the image. 

Press and hold; then drag over the area to erase. 

To erase individual pixels, select the Pencil tool and the Transparent color. 

Flood 

For flooding a region of one color with the selected color.  

Click any pixel within the region to be flooded. The selected pixel and all adjacent pixels of the same color are recolored with the selected color. The filled region extends in all directions, bounded only by pixels of a different color.  

Open Polygon 

For drawing connected straight lines. 

Click the starting point; then click for each segment. 

Double-click to end the last segment.  

Closed Polygon 

For drawing connected straight lines, where the first line and last line are connected to form a closed polygon. 

Click the starting point; then click for each segment. 

Double-click to end the last segment. 

Ellipse 

For drawing solid or outlined ovals. 

Press and hold, drag to the desired size and shape, and release. 

Selection 

For selecting an area to work on. Several commands in the Edit menu require an area to be selected. 

Point to the corner pixel of the region to be selected, press and hold, drag to the desired region, and release.  

Fill Solids 

For changing the rectangle, circle, ellipse, and closed polygon tools to draw filled-in shapes instead of outlines.

Select the check box to automatically draw filled-in shapes. Deselect the check box to return the tools to drawing outlines. 

To Undo a Drawing Operation

    Choose Undo from the Edit menu.

Only the single, most recent change can be undone.

Saving Icon Files

When saving icon files, you must use the appropriate file-name suffix. There are two suffixes appended to the base name of the icon, one for size and one for format. Many icon names are in these general forms:

basename.size.format
 basename.format

The basename is the image name used to reference the image.

size is a single letter indicating the standard size of the icon: l for large (48x48 pixels), m for medium (32x32), s for small (24x24), or t for tiny (16x16). (Icon Size Conventions) If your icon is not a standard size, you can omit this letter.

format is pm for X pixmaps (the color icon format) or bm for X bitmaps (the monochrome icon format).

If you save an icon in XBM format that has transparent color in it, an icon mask file is also saved. The icon mask file is named basename.size_m.format. If you move the icon you saved to another folder, you must also move the mask file.

For example, suppose you specify an icon named mail for a file type you've written. If you have a color display and have set the File Manager preferences to use tiny icons, the assumed icon name is mail.t.pm. If it had transparent color and you saved it in XBM format, two files would be created: mail.t.bm and mail.t_m.bm.

Icon Size Conventions

Table 15–3 lists the recommended sizes—in pixels, width x height—for creating new icons for use in CDE. Icons can be up to 256x256.

Table 15–3 Icon Size Recommendations

Usage 

High 

Medium 

Low 

File Manager (Large) 

32x32 

32x32 

32x32 

File Manager (Small) 

16x16 

16x16 

16x16 

Application Manager (Large) 

32x32 

32x32 

32x32 

Application Manager (Small) 

16x16 

16x16 

16x16 

Front Panel 

48x48 

48x48 

32x32 

Front Panel subpanels 

32x32 

32x32 

16x16 

Minimized windows 

48x48 

48x48 

32x32 

Workspace 

32x32 

32x32 

32x32 

To Save the Icon

  1. Choose an output format from the Options menu:

    • XBM for two-color X bitmap format

    • XPM for multicolor X pixmap format (the default)

  2. Choose Save from the File menu.

    If the icon is unnamed or you choose Save As, Icon Editor prompts you for a file name. Type the name and then click Save.


    Note –

    If you save an icon in XBM format that has transparent color in it, an icon mask file is also saved. The icon mask file is named basename.size_m.format. If you move the icon you saved to another folder, you must also move the mask file.


To Save the Icon with a New Name

  1. Choose Save As from the File menu.

  2. Type (or select) the file name under which you want to save the icon file.

  3. Click Save.

    If the file already exists, you will need to click OK in the warning dialog box to overwrite the existing file.

Color Usage

Icons in the desktop use a palette of 22 colors:

These colors are the default colors in Icon Editor. This set of colors provides a reasonable palette with which to create icons. This limited palette was chosen to maximize the attractiveness and readability of icons without using an unnecessary number of colors.

The dynamic colors represent the colors used to display the application on which your icon will appear. If your icon appears in File Manager, File Manager determines what the background color is. Dynamic colors are useful for icons that you want to change color as different color palettes are selected in Style Manager. Dynamic colors are also useful if the icon will be used in more than one place and you want it to use the colors of the application where it appears.

TopShadow and BottomShadow can be used for drawing a shadow under your icon. You can use these colors to make the icon appear to be etched into the surface. This is only recommended for Front Panel style icons.

The transparent color is useful for creating icons that have the illusion of being nonrectangular, since it allows the color behind the icon to show through. If your icon does not fill the entire bounding box, you should fill the unused area with the transparent color.

Advanced Drawing Tasks

After you become familiar with the basic drawing facilities in Icon Editor, you may want to try some more advanced operations. Many of these operations require you to first select an area of the icon. This is done using the Selection tool (next to the eraser).

When an area of the icon is selected, you can:

To Select an Area of the Icon

  1. Click the Selection tool (next to the eraser).

  2. Drag a box around the area you want to select.

    When an area is selected, a box flashes around the selected area.

To Cut a Region of the Icon

  1. Select the area of the icon you want to cut using the Selection tool.

  2. Choose Cut from the Edit menu.

    When you cut a portion of an icon, the exposed area becomes transparent (that is, filled in with the Transparent color).

    Note that after cutting a region, you can paste it back into the icon by choosing Paste from the Edit menu.

To Copy a Region of the Icon

  1. Select the area of the icon you want to copy using the Selection tool.

  2. Choose Copy from the Edit menu.

  3. Choose Paste from the Edit menu.

  4. Position the outline where you want to paste the copy, and then click.

    You may repeat steps 3 and 4 as many times as you like to paste multiple copies of the region you copied.

To Move a Region of the Icon

  1. Select the area of the icon you want to move using the Selection tool.

  2. Choose Cut from the Edit menu.

  3. Choose Paste from the Edit menu.

  4. Position the outline where you want to paste the area, and then click.

    You may repeat steps 3 and 4 as many times as you like to paste multiple copies of the region you cut.

To Rotate Part of the Icon

  1. Select the area of the icon you want to rotate using the Selection tool.

  2. Choose Rotate then Left or Rotate then Right from the Edit menu.

  3. Position the outline where you want to paste the rotated area, and then click.

To Flip (Mirror) Part of the Icon

Flipping an area creates a pixel-for-pixel mirror image of the selected area.

  1. Select the area of the icon you want to flip using the Selection tool.

  2. Choose Flip then Vertical or Flip then Horizontal from the Edit menu.

Resizing Icons

You can resize the entire icon or a region of the icon.

To Resize the Current Icon

  1. Choose Resize Icon from the Edit menu.

    Icon Editor displays a dialog box that prompts for the new size.

  2. Edit the current width and height to specify the new size.

  3. Click OK.


    Note –

    If you make the icon smaller, the right and bottom edges are clipped off. If you make the icon larger, the existing image remains in the upper left of the icon.


To Resize (Scale) a Region of the Icon

  1. Select the area of the icon you want to resize using the Selection tool.

  2. Choose Scale from the Edit menu.

  3. Drag a box that defines the size and shape that you want the scaled image to be.

    The size of the box is shown in the upper right area. This determines how the selected portion of the image will be scaled; it does not determine where to place the results.

  4. Position the outline where you want to paste the scaled copy, and then click.

Hotspots

Bitmap images (XBM format) can be used as special mouse pointer shapes. A hotspot marks a single pixel within the image that is the true point of the mouse pointer.

To Add a Hotspot

You can only have one hotspot in an icon.

  1. Choose Add Hotspot from the Edit menu.

  2. Click the pixel where you want the hotspot.

To Delete a Hotspot

    Choose Delete Hotspot from the Edit menu.

Screen Captures

You can copy any area from any part of the screen into the Icon Editor. You can copy (“grab”) a text or graphic that is displayed and load it into the Icon Editor work area.

To Capture (Grab) a Region of the Display

  1. Save your current icon, if necessary.

  2. Choose Grab Screen Image from the Edit menu.

  3. Drag a box around the portion of the workspace you want to capture (press mouse button 1, drag, and release).


Note –

Capturing a region of the display could cause the icon to use up some of the available colors on the desktop.


Modifying the View of an Icon

You can change the view of an icon in the Icon Editor work area by changing the magnification or using a grid.

To Hide the Grid

    Choose Visible Grid from the Options menu.

This will hide the grid. Choose Visible Grid from the Options menu again to display the grid. The grid is displayed by default.

To Change the Magnification of an Icon

  1. Choose Magnification from the Options menu.

  2. Choose the Magnification level you want from the submenu.