# The KDE Icon Editor Documentation

Thomas
Tanghus

    tanghus@earthling.net

08/08/1998
0.03.00

This Handbook describes The KDE Icon Editor Version 0.3.0

KDE
KIconEdit
icon

## Introduction

The KDE Icon Editor 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.

`Thomas Tanghus` tanghus@earthling.net.

## Installation

### How to obtain the Icon Editor

The KDE Icon Editor can be found on ftp://ftp.kde.org/pub/kde/unstable/apps/graphics, the main ftp site of the KDE project or at my homepage.

### Requirements

In order to successfully compile the icon editor, you need kdelibs-1.0 or the latest versions of `libkdecore`, `libkdeui`, `libkfile` and `libkfm`. All required libraries as well as The KDE Icon Editor itself can be found on ftp://ftp.kde.org/pub/kde/.

### Compilation and installation

In order to compile and install the KDE Icon Editor on your system, type the following in the base directory of the Icon Editor distribution:

    % ./configure
    % make
    % make install

Since the Icon Editor uses `autoconf` and `automake` you should have not trouble compiling it. Should you run into problems please report them to the KDE mailing lists.

### Configuration

## 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 grid and statusbar.

### Main toolbar

New File

  Create a new ikon. 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 ikon from scratch or from a template (templates requires kdelibs > 1.0).

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 (req. kdelibs > 1.0)

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

Filled ellipse

  Almost the same 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 Menu Entries

### File

The following functions are available from the file menu:

New Window

  Open a new Icon Editor window.

New ...

  Lets you create a new Icon either from a template or by specifying the size.

Open

  Open an existing icon file.

Save

  Save the currently open icon.

Save as

  Save the currently open icon under a new name.

Print

  Print the icon

Close

  Close the icon Editor window.

Exit

  Close all Icon Editor windows opened ( by this instance ),

### Edit

The Edit menu contains the following entries:

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).

Clear

  Clear the grid and fill it with transparent color.

Select all

  Marks the entire icon as selected.

### View

Zoom in

Zoom out

Zoom factor

  Zoom to a predefined zoom factor

### Tools

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

Filled ellipse

  Almost the same 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).

### Options

Toggle grid

  Toggle grid on/off.

### Help

From this menu user can show information about The Icon Editor.