# The &kpaint; Handbook

Pamela
Roberts

    pam.roberts@btinternet.com

2001
Pamela Roberts
&FDLNotice;
2001-07-27
0.05.01

This document describes &kpaint; version 0.5.1

KDE
linux
drawing
paint

## 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 New Canvas Size dialog box. Use this to define the picture size in pixels if you are starting a new drawing. If you are going to edit an existing image, either accept the default size or press the Cancel button.

An existing image file can be loaded with the File Open option.

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

The thickness and style of lines and how shapes are filled can be adjusted with the Tools Tool properties... option.

To save your drawing use the File Save or File Save As... options, giving the file name a .bmp, .gif, .jpg, .xpm, .xbm or .pnm extension to define the format in which you want it to be saved.

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 the area and Paste it anywhere else. Or you create a new image containing only the copied area by choosing Edit Paste image.

## The Menubar

### The File Menu

Ctrl N File New

  Start a new drawing. If a drawing is currently being displayed, a new instance of &kpaint; will be opened to show the new drawing.

Ctrl O File Open...

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

Ctrl S File Save

  Save a modified drawing without changing its name. If the drawing has not been previously saved, &kpaint; will prompt you for a name. You must give the file name a .bmp, .gif, .jpg, .xpm, .xbm or .pnm extension to define the format in which you want it to be saved.

File Save As...

  Save a drawing with a new file name. You must give the file name a .bmp, .gif, .jpg, .xpm, .xbm or .pnm extension to define the format in which you want it to be saved.

File Revert

  Cancel any changes you may have made.

Ctrl W File Close

  Close the current drawing 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 drawing.

Edit Paste image

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

### The View Menu

Ctrl Shift+ 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.

Tools Paste

  Paste a previously Cut or Copied area to where you next click the &LMB;.

### The Image Menu

Image Information...

  Gives you some information about the drawing.

Image Resize...

  Lets you change the size of the drawing.

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

F1 Help Contents

  View this manual.

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 Pamela Roberts pam.roberts@btinternet.com

&underFDL;

&underGPL;

## Installation

&kpaint; is part of the &kde; 2 project, details of which can be found at http://www.kde.org.

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 see if a later version of &kpaint; has been released, you can take a look in http://apps.kde.com.

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;