<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//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-09-09</date> <releaseinfo>0.06.02</releaseinfo> <abstract> <para>This document describes &kpaint; version 0.6.2</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> <userinput><literal role="extension">.BMP</literal></userinput></entry> <entry>&Microsoft; Windows pixmaps</entry></row> <row><entry><userinput><literal role="extension">.ico</literal></userinput> <userinput><literal role="extension">.ICO</literal></userinput></entry> <entry>&Microsoft; Windows icons</entry></row> <row><entry><userinput><literal role="extension">.jpg</literal></userinput> <userinput><literal role="extension">.JPG</literal></userinput> <userinput><literal role="extension">.jpeg</literal></userinput> <userinput><literal role="extension">.JPEG</literal></userinput> </entry> <entry>JPEG pictures</entry></row> <row><entry><userinput><literal role="extension">.png</literal></userinput> <userinput><literal role="extension">.PNG</literal></userinput></entry> <entry>PNG pictures</entry></row> <row><entry><userinput><literal role="extension">.xbm</literal></userinput> <userinput><literal role="extension">.XBM</literal></userinput></entry> <entry>XWindow bitmaps</entry></row> <row><entry><userinput><literal role="extension">.xpm</literal></userinput> <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">&Ctrl; <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">&Ctrl; <keycap>O</keycap></keycombo></shortcut> <guimenu>File</guimenu> <guimenuitem>Open...</guimenuitem> </menuchoice></term> <listitem><para><action>Open</action> an image file. If an 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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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">&Ctrl; <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>&Shift;<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: -->