# The &kpaint; Handbook

## Introduction

&kpaint; is a simple bitmap drawing program that can also be used to modify existing image files and convert between image file formats.

## Using &kpaint;

When you start &kpaint; you will be presented with a blank canvas. If you are starting work on a new image make sure that the canvas is the right size first, this can be adjusted with the Image Resize... dialog box.

Or you can load an existing image file by selecting File Open... .

Drawing lines or shapes is done by selecting the type of line or shape that you want from the Toolbar icons or the Tools menu and using the &LMB; or &RMB; to do the drawing. The colors used by the left and right mouse buttons can be changed by left clicking on the small pads shown in the right hand Toolbar menu (the one showing a small version of the image).

The thickness and style of lines can be adjusted with the Tools Tool Properties... dialog box.

You can select part of the image by choosing the Area Select tool and defining the area by dragging the mouse with the &LMB; held down. Once you have done this, you can Copy or Cut the area and Paste it anywhere else or erase it by just choosing Cut You can also create a new image containing only the copied area from the original by choosing Edit Paste Image.

If you have modified an existing image and want to save it with the same file name, use File Save .

To save a new image, or to save an existing one with a different file name and possibly a different image format, choose File Save As... which will bring up &kde;'s common Save As dialog. Enter the new file name into the Location: text box and press the Save button. The filename you enter must include a suitable extension to define the saved file format.

### Supported File Formats

&kpaint; can load and save image files with the following formats:

Filename extension | File format
``.bmp`` ``.BMP`` | &Microsoft; Windows pixmaps
``.ico`` ``.ICO`` | &Microsoft; Windows icons
``.jpg`` ``.JPG`` ``.jpeg`` ``.JPEG`` | JPEG pictures
``.png`` ``.PNG`` | PNG pictures
``.xbm`` ``.XBM`` | XWindow bitmaps
``.xpm`` ``.XPM`` | XWindow pixmaps

## The Menubar

### The File Menu

&Ctrl; N File New

- Start a new image. If an image is currently being displayed, a new instance of &kpaint; will be opened for the new image.

&Ctrl; O File Open...

- Open an image file. If an image is currently being displayed, another instance of &kpaint; will be opened to show the new one.

&Ctrl; S File Save

- Save a modified image without changing its name or image format. If the image has not been previously saved, &kpaint; will open the Save As dialog for you to enter a suitable file name and extension.

File Save As...

- Save an image with a new file name. You must give the file name a suitable extension to define the image format in which you want it to be saved.

File Revert

- Cancel any changes you may have made since you last saved the image.

&Ctrl; W File Close

- Close the current image without quitting &kpaint;.

&Ctrl; Q File Quit

- Quit &kpaint;.

### The Edit Menu

&Ctrl; X Edit Cut

- Delete the area you have selected with the Area Select option.

&Ctrl; C Edit Copy

- Copy the area you have selected with the Area Select option.

&Ctrl; V Edit Paste

- Paste the area you have just cut or copied into the image.

Edit Paste Image

- Create a new image in a new &kpaint; window containing the area you have just cut or copied.

### The View Menu

View Actual Size

- View the image at its true size.

&Ctrl; + View Zoom In

- Zoom in.

&Ctrl; - View Zoom Out

- Zoom out.

View Zoom

- Zoom in or out according to the magnification value selected from a drop-down list.

### The Tools Menu

Tools Tool Properties...

- Open a dialog box that lets you select line width and style.

Tools Ellipse

- Draw an ellipse.

Tools Circle

- Draw a circle.

Tools Pen

- Use the cursor like a pen for freehand drawing.

Tools Line

- Draw a straight line.

Tools Rectangle

- Draw a rectangle.

Tools Round Angle

- Draw a rectangle with rounded corners.

Tools Spray Can

- Use the spray can.

Tools Text

- Insert text where you click the &LMB;.

Tools Area Select

- Select an area for a Cut or Copy operation.

### The Image Menu

Image Information...

- Gives you some information about the image.

Image Resize...

- Lets you change the size of the image.

Image Edit Palette...

- Lets you change the color palette, but only for certain image formats.

Image Change Color Depth...

- Lets you change the color depth (number of bits per pixel), but only for certain image formats.

### The Settings Menu

Settings Show Toolbar

- Toggle the Main Toolbar display on and off.

Settings Show Statusbar

- Toggle the Statusbar display on and off.

Settings Save Settings

- Save the Toolbar and Statusbar settings.

Settings Configure Toolbars...

- Configure the Main and Tools toolbars.

### The Help Menu

Help &kpaint; Handbook

- View this manual.

&Shift;F1 Help What's This?

- This feature is not implemented in the current version of &kpaint;.

Help Report bug...

- Use this to report any bugs you may find with &kpaint;.

Help About &kpaint;

- Use this to see the version number of &kpaint; as well as brief information about the program authors, copyright and license agreement.

Help About KDE

- To view brief information about the K Desktop Environment.

## Credits and License

&kpaint;

Program copyright 1996-2001:

- Richard J. Moore rich@kde.org (maintainer)

- Robert Williams rwilliams@jrcmaui.com

- Mario Weilguni mweilguni@kde.org

- Christian Oppel uzs84g@uni-bonn.de

- John Califf jcaliff@compuzone.net

- Laurent Montel lmontel@mandrakesoft.com

Documentation copyright 2001-2002 Pamela Roberts pamroberts@blueyonder.co.uk

&underFDL; &underGPL;

## Installation

&kpaint; is part of the K Desktop Environment (&kde;) project, details of which can be found at http://www.kde.org.

To see if a later version of &kpaint; has been released, you can take a look in http://apps.kde.com.

Most distributions will include &kpaint;, but if you want to roll your own the source code can be found in the Kdegraphics package on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project.

To compile and install &kpaint; on your system, as root type the following in the directory where you saved the &kpaint; source code:

    % ./configure
    % make
    % make install

Since &kpaint; uses autoconf and automake you should not have any trouble compiling it. But if you do run into problems please report them to the &kde; mailing lists.

&documentation.index;