<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN"
  "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpaint;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
]>


<book lang="&language;">

<bookinfo>
<title>The &kpaint; Handbook</title>
<authorgroup>
<author>
<firstname>Pamela</firstname>
<surname>Roberts</surname>
<affiliation>
<address><email>pamroberts@blueyonder.co.uk</email></address>
</affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS --> 
</authorgroup>

<copyright>
<year>2001</year> <year>2002</year>
<holder>Pamela Roberts</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->

<legalnotice>&FDLNotice;</legalnotice>


<date>2002-04-06</date>
<releaseinfo>0.06.02</releaseinfo>

<abstract>
<para>This document describes &kpaint; version 0.6.2 using &kde; 3.0.0</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>linux</keyword>
<keyword>drawing</keyword>
<keyword>paint</keyword>
</keywordset>

</bookinfo>

<chapter id="intro">
<title>Introduction</title>

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

</chapter>


<chapter id="using">
<title>Using &kpaint;</title>

<para>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
 <menuchoice><guimenu>Image</guimenu><guimenuitem>Resize...</guimenuitem>
</menuchoice> dialog box.
</para>

<para>Or you can load an existing image file by selecting
<menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice>
 .</para>

<para>Drawing lines or shapes is done by selecting the type of line or shape 
that you want from the Toolbar icons or the
<guimenu>Tools</guimenu> menu and using the &LMB; or &RMB; to do the
drawing. The colors used by the <mousebutton>left</mousebutton> and
 <mousebutton>right</mousebutton> 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).</para>

<para>The thickness and style of lines can be adjusted
with the <menuchoice><guimenu>Tools</guimenu><guimenuitem>Tool
Properties...</guimenuitem></menuchoice> dialog box.</para>

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

<para>If you have modified an existing image and want to save it with the same 
file name, use <menuchoice><guimenu>File</guimenu><guimenuitem>Save
</guimenuitem></menuchoice>.</para>
<para>To save a new image, or to save an existing one with a different file 
name and possibly a different image format, choose <menuchoice><guimenu>File
</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice> which will bring 
up &kde;'s common <guilabel>Save As</guilabel> dialog. Enter the new file name 
into the <guilabel>Location:</guilabel> text box and press the <guibutton>
Save</guibutton> button. The filename you enter must include a suitable 
extension to define the saved file <link linkend="ftypes">format</link>.</para>


<sect1 id="ftypes">
<title>Supported File Formats</title>
<para>&kpaint; can load and save image files with the following formats:</para>

<informaltable><tgroup cols="2">
<thead>
<row><entry>Filename extension</entry>
<entry>File format</entry></row></thead>
<tbody>

<row><entry><userinput><literal role="extension">.bmp</literal></userinput> 
&nbsp;<userinput><literal role="extension">.BMP</literal></userinput></entry>
<entry>&Microsoft; Windows pixmaps</entry></row>

<row><entry><userinput><literal role="extension">.ico</literal></userinput> 
&nbsp;<userinput><literal role="extension">.ICO</literal></userinput></entry>
<entry>&Microsoft; Windows icons</entry></row>

<row><entry><userinput><literal role="extension">.jpg</literal></userinput> 
&nbsp;<userinput><literal role="extension">.JPG</literal></userinput> 
&nbsp;<userinput><literal role="extension">.jpeg</literal></userinput> 
&nbsp;<userinput><literal role="extension">.JPEG</literal></userinput> </entry>
<entry>JPEG pictures</entry></row>

<row><entry><userinput><literal role="extension">.png</literal></userinput> 
&nbsp;<userinput><literal role="extension">.PNG</literal></userinput></entry>
<entry>PNG pictures</entry></row>

<row><entry><userinput><literal role="extension">.xbm</literal></userinput> 
&nbsp;<userinput><literal role="extension">.XBM</literal></userinput></entry>
<entry>XWindow bitmaps</entry></row>

<row><entry><userinput><literal role="extension">.xpm</literal></userinput> 
&nbsp;<userinput><literal role="extension">.XPM</literal></userinput></entry>
<entry>XWindow pixmaps</entry></row>

</tbody></tgroup></informaltable>

</sect1>
</chapter>

<chapter id="menubar">
<title>The Menubar</title>

<sect1 id="filemenu">
<title>The <guimenu>File</guimenu> Menu</title>
<para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>N</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem><para>Start a <action>new image</action>. If an image
is currently being displayed, a new instance of &kpaint; will be opened
for the new image.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>O</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> an image file.
If a image is currently being displayed, another instance of &kpaint; will be
opened to show the new one.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>S</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save</action> a modified image without changing its
name or image format. If the image has not been previously saved, &kpaint; 
will open the <guilabel>Save As</guilabel> dialog for you to enter a suitable 
file name and extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save As...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save</action> an image with a new file name.
You must give the file name a suitable extension to define the 
<link linkend="ftypes">image format</link> in which you want it to be
saved.</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Revert</guimenuitem>
</menuchoice></term>
<listitem><para><action>Cancel</action> any changes you may
have made since you last saved the image.</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>W</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem><para><action>Close</action> the current image without
quitting &kpaint;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>Q</keycap></keycombo></shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quit</action> &kpaint;.</para> </listitem>
</varlistentry>


</variablelist>
</para>
</sect1>

<sect1 id="editmenu">
<title>The <guimenu>Edit</guimenu> Menu</title>

<para><variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>X</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delete</action> the area you have selected with the
<guimenuitem>Area Select</guimenuitem> option.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>C</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copy</action> the area you have selected with the
<guimenuitem>Area Select</guimenuitem> option.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>V</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem>
</menuchoice></term>
<listitem><para><action>Paste</action> the area you have just cut or
copied into the image.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Paste Image</guimenuitem>
</menuchoice></term>
<listitem><para><action>Create a new image in a new &kpaint; window</action>
containing the area you have just cut or copied.</para> </listitem>
</varlistentry>

</variablelist></para>
</sect1>



<sect1 id="viewmenu">
<title>The <guimenu>View</guimenu> Menu</title>

<para><variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Actual Size</guimenuitem>
</menuchoice></term>
<listitem><para><action>View the image at its true size.</action>
</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>+</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom In</guimenuitem>
</menuchoice></term>
<listitem><para><action>Zoom</action> in.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>-</keycap></keycombo></shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom Out</guimenuitem>
</menuchoice></term>
<listitem><para><action>Zoom</action> out.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Zoom</guimenuitem>
</menuchoice></term>
<listitem><para><action>Zoom</action> in or out according to the
magnification value selected from a drop-down list.</para> </listitem>
</varlistentry>

</variablelist>
</para>
</sect1>

<sect1 id="toolsmenu">
<title>The <guimenu>Tools</guimenu> Menu</title>
<para><variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Tool Properties...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open a dialog box that lets you select line width and
style.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Ellipse</guimenuitem>
</menuchoice></term>
<listitem><para><action>Draw an ellipse.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Circle</guimenuitem>
</menuchoice></term>
<listitem><para><action>Draw a circle.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Pen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Use the cursor like a pen for freehand
drawing.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Line</guimenuitem>
</menuchoice></term>
<listitem><para><action>Draw a straight line.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Rectangle</guimenuitem>
</menuchoice></term>
<listitem><para><action>Draw a rectangle.</action></para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Round Angle</guimenuitem>
</menuchoice></term>
<listitem><para><action>Draw a rectangle with rounded corners.</action></para>
</listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Spray Can</guimenuitem>
</menuchoice></term>
<listitem><para><action>Use the spray can.</action></para>
</listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Text</guimenuitem>
</menuchoice></term>
<listitem><para><action>Insert text where you click the &LMB;.</action></para>
</listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Area Select</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select an area for a Cut or Copy
operation.</action></para> </listitem> </varlistentry>

</variablelist>
</para>
</sect1>


<sect1 id="imagemenu">
<title>The <guimenu>Image</guimenu> Menu</title>

<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu>
<guimenuitem>Information...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Gives you some information about the
image</action>.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu>
<guimenuitem>Resize...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you change the size of the image</action>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu>
<guimenuitem>Edit Palette...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you change the color palette, but
only for certain image formats</action>.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Image</guimenu>
<guimenuitem>Change Color Depth...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you change the color depth (number of bits per
pixel), but only for certain image formats</action>.</para> </listitem>
</varlistentry>

</variablelist>
</para>
</sect1>

<sect1 id="settings">
<title>The <guimenu>Settings</guimenu> Menu</title>
<para><variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle the Main Toolbar display</action> on
and off.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Statusbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle the Statusbar display</action> on
and off.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Save Settings</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save the Toolbar and Statusbar
settings</action>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configure the Main and Tools
toolbars</action>.</para></listitem>
</varlistentry>


</variablelist>
</para>
</sect1>


<sect1 id="help">
<title>The <guimenu>Help</guimenu> Menu</title>

<para><variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>&kpaint; Handbook</guimenuitem>
</menuchoice></term>
<listitem><para><action>View this manual</action>.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo><keysym>Shift</keysym><keysym>F1</keysym></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>What's This?</guimenuitem>
</menuchoice></term>
<listitem><para>This feature is not implemented in the current version of 
&kpaint;.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Report bug...</guimenuitem>
</menuchoice></term>
<listitem><para>Use this to <action>report any bugs you may
find with &kpaint;</action>.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About &kpaint;</guimenuitem>
</menuchoice></term>
<listitem><para>Use this to <action>see the version number of
&kpaint; as well as brief information about the program
authors, copyright and license agreement</action>.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About KDE</guimenuitem>
</menuchoice></term>
<listitem><para>To view <action>brief information about the K Desktop
Environment</action>.</para> </listitem>
</varlistentry>

</variablelist>
</para>
</sect1>
</chapter>

<chapter id="credits">


<title>Credits and License</title>

<para>
&kpaint;
</para>
<para>
Program copyright 1996-2001:
<itemizedlist>
<listitem><para>Richard J. Moore <email>rich@kde.org</email> (maintainer)
</para></listitem>
<listitem><para>Robert Williams <email>rwilliams@jrcmaui.com</email>
</para></listitem>
<listitem><para>Mario Weilguni <email>mweilguni@kde.org</email>
</para></listitem>
<listitem><para>Christian Oppel <email>uzs84g@uni-bonn.de</email>
</para></listitem>
<listitem><para>John Califf <email>jcaliff@compuzone.net</email>
</para></listitem>
<listitem><para>Laurent Montel <email>lmontel@mandrakesoft.com</email>
</para></listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2001-2002 Pamela Roberts
<email>pamroberts@blueyonder.co.uk</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->

&underGPL;        	 <!-- GPL License -->

</chapter>


<appendix id="installation">
<title>Installation</title>

<para>
&kpaint; is part of the K Desktop Environment (&kde;) project, details of 
which can be found at
<ulink url="http://www.kde.org"> http://www.kde.org</ulink>.
</para>

<para>
To see if a later version of &kpaint; has been released, you can take a
look in <ulink
url="http://apps.kde.com">http://apps.kde.com</ulink>. </para>

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


<para>
To compile and install &kpaint; on your system, as root type the
following in the directory where you saved the &kpaint; source code:
<screen width="40">
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>
</para>

<para>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.</para>

</appendix>

&documentation.index;

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->


