Icon Editor is a tool for creating both bitmap and pixmap image files for use as icons or backdrops. Icon Editor enables you to create and edit images in two 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

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 the Style Guide and Checklist. Open the Personal Applications subpanel and click the Icon Editor control.startingIcon EditorIcon Editor starting Icon Editor starts with an empty drawing work area.Icon Editorcontrol Front PanelIcon Editor control You can also start Icon Editor and have it load an icon into the work area in one of the following ways:opening iconIcon Editor opening icon for editing In a File Manager view, locate the icon file and double-click on it to open it. (The default action for pixmap and bitmap files runs Icon Editor and loads the file.) Icon Editorstarting from File Manager File Managerstarting Icon Editor from Drop an icon file on the Icon Editor control in the Personal Applications subpanel.dropping icon file Click the Application Manager control in the Front Panel, then open Desktop_Apps and double-click on Icon Editor. Icon Editorstarting from Application ManagerApplication Manager starting Icon Editor from Type the following command in a Terminal window: Terminalstarting Icon Editor from Icon Editorstarting from Terminal dticon -f filename & This section describes how to create and edit an icon and how to use the Icon Editor drawing tools. iconsopening existing 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. 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. Click Open. 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. Icon Editorstarting a new icon startingnew 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. Save your current icon, if necessary. Choose Clear Icon from the Edit menu. The entire icon drawing work area is cleared.iconsclearing loaded drawing icon image iconsdrawing image Select one of the drawing tools (listed in ). Select a color (static color, static gray, or a dynamic color). Begin drawing with the tool you've selected. More details on drawing with each tool are provided below. The drawing tools area of Icon Editor is shown in . Icon Editordrawing tools <$startrange>drawing tools for Icon Editor <$startrange>

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.Icon Editordrawing toolsdrawing tools for Icon Editor Select the check box to automatically draw filled-in shapes. Deselect the check box to return the tools to drawing outlines. drawing icon imageundo Choose Undo from the Edit menu. Only the single, most recent change can be undone. 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:namesfor icon files <$startrange> iconsnaming <$startrange> 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). ( ) 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.namesfor icon files <$endrange> iconsnaming <$endrange> lists the recommended sizes—in pixels, width x height—for creating new icons for use in CDE. Icons can be up to 256x256. iconssize conventions for sizes of icons Resolution 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 Icon Editorsaving icon iconssaving savingicons Choose an output format from the Options menu: iconsoutput format XBM for two-color X bitmap format XPM for multicolor X pixmap format (the default) 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. 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. Icon Editorsaving icon with new name iconssaving with new name savingicons with new name Choose Save As from the File menu. Type (or select) the file name under which you want to save the icon file. Click Save. If the file already exists, you will need to click OK in the warning dialog box to overwrite the existing file. Icons in the desktop use a palette of 22 colors: iconscolor usage for colorfor icons Eight static grays Eight static colors: red, blue, green, cyan, magenta, yellow, black, and white Five dynamic colors: Foreground, Background, TopShadow, BottomShadow, and Select A transparent “color” that allows the background to show through 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.dynamic colors for icons 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. TopShadowBottomShadow 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.icons color usage for <$endrange>colorfor icons <$endrange> 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: Cut, copy or move it Resize (scale) it Flip it (horizontally or vertically) Rotate it (right or left) selectingan area of an icon iconsselecting an area of Click the Selection tool (next to the eraser). Drag a box around the area you want to select. When an area is selected, a box flashes around the selected area. cutting a region of an icon iconscutting a region of Select the area of the icon you want to cut using the Selection tool. 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. copyinga region of an icon iconscopying a region of Select the area of the icon you want to copy using the Selection tool. Choose Copy from the Edit menu. Choose Paste from the Edit menu. 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. movinga region of an icon iconsmoving a region of Select the area of the icon you want to move using the Selection tool. Choose Cut from the Edit menu. Choose Paste from the Edit menu. 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 cut. rotating part of an icon iconsrotating part of Select the area of the icon you want to rotate using the Selection tool. Choose Rotate then Left or Rotate then Right from the Edit menu. Position the outline where you want to paste the rotated area, and then click. Flipping an area creates a pixel-for-pixel mirror image of the selected area. flipping part of an iconiconsflipping part ofSelect the area of the icon you want to flip using the Selection tool. Choose Flip then Vertical or Flip then Horizontal from the Edit menu. You can resize the entire icon or a region of the icon. Choose Resize Icon from the Edit menu. Icon Editor displays a dialog box that prompts for the new size. Edit the current width and height to specify the new size. Click OK.resizing iconsicons resizing 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. resizinga region of an icon iconsresizing a region of Select the area of the icon you want to resize using the Selection tool. Choose Scale from the Edit menu. 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. Position the outline where you want to paste the scaled copy, and then click. 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. hotspot in an icon iconshotspot You can only have one hotspot in an icon. Choose Add Hotspot from the Edit menu. Click the pixel where you want the hotspot. hotspot in an icon iconshotspot Choose Delete Hotspot from the Edit menu. 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. capturing region of display grabbingregion of display displaycapturing region of Save your current icon, if necessary. Choose Grab Screen Image from the Edit menu. Drag a box around the portion of the workspace you want to capture (press mouse button 1, drag, and release). Capturing a region of the display could cause the icon to use up some of the available colors on the desktop. You can change the view of an icon in the Icon Editor work area by changing the magnification or using a grid. gridin Icon Editor Icon Editorhiding grid in hidingIcon Editor grid grabbingregion of display displaycapturing region of 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. capturing region of display grabbingregion of display displaycapturing region of Choose Magnification from the Options menu. Choose the Magnification level you want from the submenu.iconschanging magnification ofmagnification of icons