Thomas Tanghus
Copyright © 1997 Thomas Tanghus
Copyright © 2001 Lauri Watts
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
KIconEdit is designed to help create icons for KDE using the standard icon palette.
Table of Contents
Introduction
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. | ||
| --Thomas Tanghus <tanghus@earthling.net> | ||
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.
- 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 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
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
The following functions are available from the File menu:
- File->New Window
Open a new Icon Editor window.
- File->New... (Ctrl+N)
Lets you create a new icon, either from a template or by specifying the size.
- File->Open... (Ctrl+O)
Open an existing icon file.
- File->Open Recent
Displays a list of recently opened icons to choose from.
- File->Save (Ctrl+S)
Save the currently open icon.
- File->Save as...
Save the currently open icon under a new name.
- File->Print... (Ctrl+P)
Print the icon
- File->Quit (Ctrl+W)
Close KIconEdit.
Edit
The Edit menu contains the following entries:
- Edit->Cut (Ctrl+X)
Cuts out the entire icon and put it onto the clipboard.
- Edit->Copy (Ctrl+C)
Copies the entire icon to the clipboard.
- Edit->Paste (Ctrl+V)
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.
- Edit->Select all (Ctrl+A)
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->Contents... (F1)
Invokes the KDE Help system starting at the KIconEdit help pages. (this document).
- Help->What's This? (Shift+F1)
Changes the mouse cursor to a combination arrow and question mark. Clicking on items within KIconEdit will open a help window (if one exists for the particular item) explaining the item's function.
- Help->Report Bug...
Opens the Bug report dialog where you can report a bug or request a ‘wishlist’ feature.
- Help->About KIconEdit
This will display version and author information.
- Help->About KDE
This displays the KDE version and other basic information.
Credits and Licenses
KIconEdit
Program copyright Thomas Tanghus <tanghus@kde.org>
Contributors
John Califf <jcaliff@compuzone.net>
Laurent Montel <lmontel@mandrakesoft.com>
This documentation is licensed under the terms of the GNU Free Documentation License.
This program is licensed under the terms of the GNU General Public License.
Installation
KIconEdit is part of the KDE project http://www.kde.org/.
KIconEdit can be found in the kdegraphics package on ftp://ftp.kde.org/pub/kde/, the main FTP site of the KDE project.
Compilation and Installation
In order to compile and install KIconEdit on your system, type the following in the base directory of the KIconEdit distribution:
% ./configure % make % make install
Since KIconEdit uses autoconf and automake you should have no trouble compiling it. Should you run into problems please report them to the KDE mailing lists.