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.