# The &kiconedit; Manual

## Introduction

> Thomas Tanghus tanghus@earthling.net

> &kiconedit; is designed to help create icons for &kde; using the standard icon palette.

> I hope you will find this program somehow useful and I would appreciate any suggestions and comments.

## Onscreen Fundamentals

In this section will be briefly described the Icon Editor user interface.

The Icon Editor window is separated in four areas: main toolbar, tools toolbar, the grid and statusbar.

### Main toolbar

New Window

- Open a new window.

New File

- Create a new icon. If the current file has been modified you will be asked if you want to save the changes. After that a dialog will open where you can choose to create the icon from scratch or from a template.

Open...

- Open an existing icon file.

Save

- Save the currently open icon.

Print

- Print the icon.

Cut

- Cuts out the entire icon and put it onto the clipboard.

Copy

- Copies the entire icon to the clipboard.

Paste

- Paste the contents of the clipboard as a new image (if the clipboard contains a valid icon).

Resize

- Resize icon to width X height.

Gray scale

- Gray scale the icon image. This may create colors not conformant to the &kde; icon palette.

Zoom in

Zoom out

Zoom factor

- Zoom to predefined zoom factor.

Toggle grid

- Toggle grid on/off.

New Icon Editor

- Open a new Icon Editor window.

### Tools toolbar

This toolbar contains the tools you can use to manipulate the icon.

Find color

- Doesn't change the icon but changes the current drawcolor to the color clicked on.

Freehand

- Draw free hand.

Select

- Select (mark) a part of the icon.

Line

- Draw a line.

Rectangle

- Draw a rectangle.

Filled rectangle

- Draw a filled rectangle.

Circle

- Draw a circle.

Filled circle

- Draw a filled circle.

Ellipse

- Draw an ellipse

Filled ellipse

- Draw a filled ellipse (almost the same thing as drawing a circle.)

Spray

- Draws a randow dotted pattern like a spraycan.

Flood fill

- Fill an area with the current color.

Eraser

- Draw transparent (invisible).

### Grid

The grid is where you manipulate the icon contents.

### Statusbar

The status bar keeps you informed of current operations. From left to right, it tells you the x,y coordinates of the pixel you are working on, the size of the current canvas, the zoom factor, and the current number of colors in the icon.

## The Menu Entries

### File

The following functions are available from the File menu:

File New Window

- Open a new Icon Editor window.

&Ctrl;N File New...

- Lets you create a new icon, either from a template or by specifying the size.

&Ctrl;O File Open...

- Open an existing icon file.

File Open Recent

- Displays a list of recently opened icons to choose from.

&Ctrl;S File Save

- Save the currently open icon.

File Save as...

- Save the currently open icon under a new name.

&Ctrl;P File Print...

- Print the icon

&Ctrl;W File Quit

- Close &kiconedit;.

### Edit

The Edit menu contains the following entries:

&Ctrl;X Edit Cut

- Cuts out the entire icon and put it onto the clipboard.

&Ctrl;C Edit Copy

- Copies the entire icon to the clipboard.

&Ctrl;V Edit Paste

- Paste the contents of the clipboard (if the clipboard contains a valid icon).

Edit Paste as New

- Paste the contents of the clipboard as a new image (if the clipboard contains a valid icon).

Edit Clear

- Clear the grid and fill it with transparent color.

&Ctrl;A Edit Select all

- Marks the entire icon as selected.

### Icon

Icon Resize

- Opens a dialog where you can change the size of the icon.

Icon Grayscale

- Gray scale the icon image. This may create colors not conformant to the &kde; icon palette.

### View

View Zoom in

- Magnify the view of the icon.

View Zoom out

- Shrink the view icon to a smaller screen size

View Zoom factor

- Zoom to a predefined zoom factor

### Tools

Tools Freehand

- Draw free hand.

Tools Rectangle

- Draw a rectangle.

Tools Filled Rectangle

- Draw a filled rectangle.

Tools Circle

- Draw a circle.

Tools Filled Circle

- Draw a filled circle.

Tools Ellipse

- Draw an ellipse

Tools Filled Ellipse

- Draw a filled ellipse (almost the same thing as drawing a circle.)

Tools Spray

- Draws a random dotted pattern like a spraycan.

Tools Flood fill

- Fill an area with the current color.

Tools Line

- Draw a line.

Tools Eraser (Transparent)

- Draw transparent (invisible).

### Options

Options Configure

- Opens the &kiconedit; configuration dialog, described separately.

Options Show Grid

- Toggle on and off the grid.

Options Show Toolbar

- Toggle on and off the display of the toolbar.

Options Show drawing tools

- Toggle on and off the display of the drawing tools.

Options Show Statusbar

- Toggle on and off the display of the status bar.

Options Save options

- Save the current state of the &kiconedit; options.

### Help

&help.menu.documentation;

## Credits and Licenses

&kiconedit;

Program copyright Thomas Tanghus tanghus@kde.org

## Contributors

- John Califf jcaliff@compuzone.net

- Laurent Montel lmontel@mandrakesoft.com

&underFDL; &underGPL;

## Installation

### How to obtain &kiconedit;

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;