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

<book lang="&language;">
<bookinfo>
<title>The &kontour; Handbook</title>
<mediaobject>
<imageobject><imagedata fileref="logo.png"/></imageobject>
<textobject><phrase>&kontour; logo</phrase></textobject>
</mediaobject>
<author>
<firstname>Hagen</firstname>
<surname>Höpfner</surname>
<affiliation>
<address><email>Hagen.Hoepfner@gmx.de</email></address>
</affiliation>
</author>
<date>1999-11-08</date>
<releaseinfo>0.07.01</releaseinfo>
<abstract>
<para>This Handbook describes &kontour; Version 0.7.1 by Kai-Uwe Sattler.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>Kontour</keyword>
</keywordset>
</bookinfo>

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

<para>The goal of the &kontour; project is to create a freely available vector-based drawing program with an interface comprable to that of Corel Draw&reg; or with Adobe Illustrator&reg;. </para>

<sect1 id="about-the-author">
<title>About the author</title>

<para>The author of &kontour; is Kai-Uwe Sattler. </para>
</sect1>

<sect1 id="history-of-kontour">
<title>History of &kontour;</title>

<para>From the official &kontour; home page:</para>

<para>"I have started this project because I am tired of switching to Windows in order to design illustrations for papers or slides with a modern drawing tool.
Now, for the Linux operating system and of course for other Unixes the Qt toolkit and the KDE project provide a perfect foundation for this kind of application." </para>

<para>Revision history: </para>

<para><itemizedlist>
<listitem>
<para>25/03/1998 first preview version released </para>
</listitem>
<listitem>
<para>21/04/1998 second preview version released </para>
</listitem>
<listitem>
<para>23/04/1998 snapshot 0.2.1 (bug fixes only) </para>
</listitem>
<listitem>
<para>02/06/1998 snapshot 0.3 released </para>
</listitem>
<listitem>
<para>10/08/1998 snapshot 0.4 released </para>
</listitem>
<listitem>
<para>28/08/1998 snapshot 0.4.1 released </para>
</listitem>
<listitem>
<para>06/11/1998 snapshot 0.5 released </para>
</listitem>
<listitem>
<para>05/01/1999 snapshot 0.6 released </para>
</listitem>
<listitem>
<para>29/01/1999 snapshot 0.6.1 (bug fixes only) </para>
</listitem>
<listitem>
<para>09/02/1999 snapshot 0.6.2 released </para>
</listitem>
<listitem>
<para>24/02/1999 snapshot 0.6.3 released </para>
</listitem>
<listitem>
<para>06/04/1999 snapshot 0.6.4 released (bug fixes only) </para>
</listitem>
<listitem>
<para>09/04/1999 snapshot 0.6.5 released (bug fixes only)</para>
</listitem>
<listitem>
<para>07/15/1999 snapshot 0.7 released</para>
</listitem>
<listitem>
<para>10/19/1999 snapshot 0.7.1 released</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="about-the-handbook">
<title>About the handbook</title>

<para>This handbook refers mainly to the "stand-alone version" of &kontour;. Special information regarding the &kontour; component of the KOffice package is not considered. However, the information presented here applies in many respects to the KOffice component also. </para>

<para>This documentation is a translation of the original German text by Hagen Höpfner.</para>

<para>The current version can be found on <ulink url="http://www.cs.uni-magdeburg.de/~hoepfner/kde.html">his home page</ulink>.</para>

<para>Original German version: Hagen Höpfner, <ulink url="mailto:Hagen.Hoepfner@gmx.de">Hagen.Hoepfner@gmx.de</ulink></para>

<para>English translation: Ben Skelton, <ulink url="mailto:skeltobc@elec.canterbury.ac.nz">skeltobc@elec.canterbury.ac.nz</ulink> and Winter Laite, <literal><ulink url="mailto:winlaite@lobo.net">winlaite@lobo.net</ulink></literal></para>
</sect1>
</chapter>

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

<sect1 id="how-to-obtain-kontour">
<title>How to obtain &kontour;</title>

<para>The most current version of &kontour; is in the CVS repository at the
<ulink url="http://www.kde.org">KDE Internet site</ulink>.</para>
</sect1>

<sect1 id="system-requirements">
<title>System Requirements</title>

<para>&kontour; is still strongly in the development phase, and often utilises the latest package versons. The required software packages themselves require some set of minimum hardware which is not repeated here.</para>

<para>For installation the prerequisite packages are: </para>

<para><itemizedlist>
<listitem>
<para>KDE 1.1</para>
</listitem>
<listitem>
<para>QT 1.41</para>
</listitem>
<listitem>
<para>gcc 2.8.x or egcs 1.x</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="compilation-and-installation">
<title>Compilation and Installation</title>

<para>To compile the source code for &kontour;, proceeds as follows: </para>

<para><orderedlist><listitem>
<para>Unpack the tar archives <literal>tar xfvz &kontour;.tar.gz</literal></para>
</listitem>
<listitem>
<para>Change to the source code directory <literal>cd &kontour;</literal></para>
</listitem>
<listitem>
<para>Check for required packages and create the Makefiles <literal>./configure</literal></para>
</listitem>
<listitem>
<para>Compile the source code <literal>make all</literal></para>
</listitem>
</orderedlist>
</para>

<para>If the installing user has ROOT privileges, installing &kontour; into the KDE directory tree is done by <literal>make install</literal>.</para>

<para>The following platforms were successfully tested:</para>

<para><itemizedlist>
<listitem>
<para>RedHat 5.1 (Hagen Höpfner)</para>
</listitem>
<listitem>
<para>RedHat 5.2 (Hagen Höpfner)</para>
</listitem>
<listitem>
<para>SuSE 6.0 (Hagen Höpfner) </para>
</listitem>
<listitem>
<para>SuSE 6.1 Cebit Beta (Hagen Höpfner)</para>
</listitem>
<listitem>
<para>SuSE 6.1 (Hagen Höpfner)</para>
</listitem>
<listitem>
<para>SuSE 6.2 (Joachim Ansorg)</para>
</listitem>
</itemizedlist>
</para>

<para>If you encounter problems, please direct them to Hagen.</para>
</sect1>

<sect1 id="installation-of-binary-packages">
<title>Installation of binary packages</title>

<para>The installation of precompiled packages under Linux depends on the package format used. &kontour; is available in rpm and deb package formats. For a successful installation be sure to select the package for your system. First, some definitions: </para>

<para><itemizedlist>
<listitem>
<para><literal>FILENAME</literal> = name of the package file (e.g.: <literal>&kontour;&lowbar;0.6.5-1&lowbar;i386.deb</literal>)</para>
</listitem>
<listitem>
<para><literal>PACKAGENAME</literal> = the created package name (usually  <literal>&kontour;</literal>)</para>
</listitem>
</itemizedlist>
</para>

<sect2 id="rpm">
<title>rpm</title>

<para>To install an <literal>rpm</literal> package use the command <literal>rpm -i
FILENAME</literal>.The package may be deleted later using the command <literal>rpm -e PACKAGENAME</literal>.</para>
</sect2>

<sect2 id="deb">
<title>deb</title>

<para>Similarly for <literal>deb</literal> packages, the installation command is <literal>dpkg -i FILENAME</literal> and to remove the package <literal>dpkg -r PACKAGE&lowbar;NAME</literal>.</para>

<para>In both cases ROOT privileges will almost certainly be required to install or uninstall the packages.</para>
</sect2>
</sect1>
</chapter>

<chapter id="usage">
<title>Usage</title>

<sect1 id="some-general-remarks-">
<title>Some general remarks </title>

<para>The operation of &kontour; is intuitive and easy to learn. It is very similar to other graphical programs. &kontour; uses <link linkend="shortcut">key bindings</link> which are <ulink url="http://www.kde.org/standards.html">KDE standards</ulink>.</para>

<para>Additionally pressing the CTRL key while moving the mouse constrains the movement to one in one direction or in equal amounts in both directions. For example, pressing the CTRL key while drawing a rectangle, draws a square.</para>

<para>Some functions can, of course, be used on more than one selected item at a time.</para>
</sect1>

<sect1 id="drawing-2d-primitives">
<title>Drawing 2D-Primitives</title>

<para>The procedure to draw any 2D-Primitive, consists of the following steps: </para>

<para><orderedlist><listitem>
<para>Select the type of object which can be drawn</para>
</listitem>
<listitem>
<para>Draw the object</para>
</listitem>
</orderedlist>
</para>

<para>The second step varies with each of the different 2D-Primitives. Therefore these are dealt with separately in the following where the operation is shown with the icon button to be pressed to select that function. </para>

<sect2 id="fh">
<title>Freehand tool</title>

<para>
<mediaobject><imageobject><imagedata fileref="freehand.png" format="PNG"/></imageobject></mediaobject>
In order to draw a freehand line, one proceeds as follows:</para>

<para><orderedlist><listitem>
<para>left-click (and hold) on the canvas where the freehand line is to begin</para>
</listitem>
<listitem>
<para>draw the line by moving the mouse with the left mouse button still pressed</para>
</listitem>
<listitem>
<para>release the left mouse button when the final point of the line is reached</para>
</listitem>
</orderedlist>
</para>
</sect2>

<sect2 id="polyline-tool">
<title>Polyline tool</title>

<para><mediaobject><imageobject><imagedata fileref="line.png" format="PNG"/></imageobject></mediaobject> With this tool lines, polylines, and polygons may be drawn. </para>

<sect3 id="li">
<title>Lines</title>

<para><mediaobject><imageobject><imagedata fileref="line.png" format="PNG"/></imageobject></mediaobject> To draw a line: 
<orderedlist><listitem>
<para>left-click on the canvas at the point where the line is to start </para>
</listitem>
<listitem>
<para>release the left mouse button and draw the line by moving the mouse </para>
</listitem>
<listitem>
<para>right-click on the canvas at the point where the line is to finish.</para>
</listitem>
</orderedlist>
</para>
</sect3>

<sect3 id="pf">
<title>Polylines</title>

<para><mediaobject><imageobject><imagedata fileref="line.png" format="PNG"/></imageobject></mediaobject> A polyline is a series of connected lines. In order to draw a polyline, proceed as follows:
<orderedlist><listitem>
<para>left-click at the point where the polyline is to start</para>
</listitem>
<listitem>
<para>release the left mouse button and draw the first line</para>
</listitem>
<listitem>
<para>left-click at the point where the current line ends and the next line starts</para>
</listitem>
<listitem>
<para>release the left mouse button and draw the next line </para>
</listitem>
<listitem>
<para>continue with previous two steps until the final line is drawn, then terminate this line with a click of the right mouse button</para>
</listitem>
</orderedlist>
</para>
</sect3>

<sect3 id="gp">
<title>Polygons</title>

<para><mediaobject><imageobject><imagedata fileref="line.png" format="PNG"/></imageobject></mediaobject> To draw a polygon follow the steps in drawing polylines. To close the polygon hold down the SHIFT key while clicking the right mouse button to automatically close the polygon. A line from the last left-click to the first left click is automatically drawn. </para>
</sect3>
</sect2>

<sect2 id="be">
<title>Bezier curve tool</title>

<para><mediaobject><imageobject><imagedata fileref="bezier.png" format="PNG"/></imageobject></mediaobject> Drawing Bezier curves is often a problem, however &kontour; makes it easy. Proceed as follows: 
<orderedlist><listitem>
<para>left-click on the canvas at the point of origin of the Bezier curve  </para>
</listitem>
<listitem>
<para>determine the rise of the curve segment at this point with the help line - left-click when satisfied </para>
</listitem>
<listitem>
<para>left-click at the end point of this line segment </para>
</listitem>
<listitem>
<para>position the help line to achieve the desired rise, if further curve segments are to be drawn, left-click otherwise right-click to complete the curve</para>
</listitem>
</orderedlist>
</para>
</sect2>

<sect2 id="rectangle-tool">
<title>Rectangle tool</title>

<para><mediaobject><imageobject><imagedata fileref="rect.png" format="PNG"/></imageobject></mediaobject> In order to draw a rectangle: 
<orderedlist><listitem>
<para>left-click (and hold) on the canvas at the point where a corner point of the rectangle is to be  </para>
</listitem>
<listitem>
<para>draw the rectangle by moving the mouse while holding down the left mouse button </para>
</listitem>
<listitem>
<para>release the left mouse button to complete the rectangle</para>
</listitem>
</orderedlist>

To draw a square, press and hold down the CTRL key while drawing the rectangle. </para>
</sect2>

<sect2 id="regular-polygon-tool">
<title>Regular polygon tool</title>

<para><mediaobject><imageobject><imagedata fileref="polygon.png" format="PNG"/></imageobject></mediaobject> This tool allows the simple drawing of equilateral triangles, squares, and higher order regular polygons. It is much simpler to use this tool for drawing regular polygons than the polyline tool. The procedure here is the following: </para>

<para><orderedlist><listitem>
<para>left-double click on the regular polygon tool button </para>
</listitem>
<listitem>
<para>a dialog opens where the polygon parameters are set 
<inlinemediaobject><imageobject><imagedata fileref="polygon-setup.png" format="PNG"/></imageobject></inlinemediaobject>
</para>
</listitem>
<listitem>
<para>make the appropriate adjustments </para>
</listitem>
<listitem>
<para>left-click the OK button when finished  </para>
</listitem>
<listitem>
<para>left-click (and hold) on the canvas at the point of origin * </para>
</listitem>
<listitem>
<para>scale the polygon to the desired size by moving the mouse while holding down the left mouse button </para>
</listitem>
<listitem>
<para>release the left mouse button when the desired size is achieved</para>
</listitem>
</orderedlist>

* In this case the point of origin should only be used as a guide. For precise alignment of the polygon use the selection tool.</para>
</sect2>

<sect2 id="el">
<title>Ellipse tool</title>

<para><mediaobject><imageobject><imagedata fileref="ellipse.png" format="PNG"/></imageobject></mediaobject> In order to draw an ellipse, proceed as follows: 
<orderedlist><listitem>
<para>left-click (and hold) on one corner point of the bounding box * of the ellipse</para>
</listitem>
<listitem>
<para>draw the ellipse by moving the mouse while holding down the left mouse button </para>
</listitem>
<listitem>
<para>release the left mouse button when the ellipse is the desired size</para>
</listitem>
</orderedlist>

If a circle is to be drawn instead of an ellipse, hold the CTRL key down while drawing the ellipse. </para>

<para>* The bounding box of the ellipse is a rectangle which is just big enough to contain the ellipse - the edges of the rectangle are tangents (parallel to the x- and y-axes) of the ellipse. </para>
</sect2>

<sect2 id="text-tool">
<title>Text tool</title>

<para><mediaobject><imageobject><imagedata fileref="text.png" format="PNG"/></imageobject></mediaobject> This tool adds text to your &kontour; drawing. The steps are are follows: 
<orderedlist><listitem>
<para> left-click on the canvas where the text is to begin </para>
</listitem>
<listitem>
<para> type the text</para>
</listitem>
</orderedlist>

The input is continued until a new tool is selected, or a new point on the canvas is chosen to place more text by step 1.  </para>
</sect2>
</sect1>

<sect1 id="transformation-of-2d-primitives">
<title>Transformation of 2D-Primitives</title>

<para>&kontour; offers tools that allow the easy modification of drawn primitives, such as scaling, rotating, and shifting tools. This section describes how to perform these transformations. </para>

<sect2 id="rotation">
<title>Rotation</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> Rotation here describes the rotation of an object about a centre point. Proceed as follows: 
<orderedlist><listitem>
<para>left-click on the object to be rotated. The selection frame appears around the object. Left-click again and the transformation frame appears. </para>
</listitem>
<listitem>
<para>left-click (and hold) over one of the corner arrows and rotate the object by moving the mouse while holding down the left mouse button.</para>
</listitem>
<listitem>
<para>release the mouse button</para>
</listitem>
</orderedlist>
</para>
</sect2>

<sect2 id="scaling">
<title>Scaling</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> Scaling an object allows the user to increase or reduce the size of an object. To scale an object:
<orderedlist><listitem>
<para>left-click on the object to be scaled---the selection frame appears.  </para>
</listitem>
<listitem>
<para>left-click (and hold) on a point in the selection frame in the direction the object is to be scaled. </para>
</listitem>
<listitem>
<para>scale the object by moving the mouse with the left button held down. </para>
</listitem>
<listitem>
<para>release the mouse button.</para>
</listitem>
</orderedlist>

Proportional scaling can be done by holding down the CTRL key in the third step.  </para>
</sect2>

<sect2 id="shifting">
<title>Shifting</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> To shift an object proceed as follows: 
<orderedlist><listitem>
<para>left-click on the object to be shifted </para>
</listitem>
<listitem>
<para>with the left mouse button pressed move the mouse to reposition the object</para>
</listitem>
<listitem>
<para>release the left mouse button</para>
</listitem>
</orderedlist>

If you hold down the CTRL key while shifting, the object will be shifted horizontally or vertically only.</para>
</sect2>

<sect2 id="modifying-an-object">
<title>Modifying an object</title>

<para><mediaobject><imageobject><imagedata fileref="point.png" format="PNG"/></imageobject></mediaobject> In the previous sections the transformations of whole objects were presented. We now turn our attention to the manipulation of individual sections of objects. NOTE: Before the object can be modified the object must be selected using the selection tool. </para>

<sect3 id="moving-points">
<title>Moving points</title>

<para><mediaobject><imageobject><imagedata fileref="movepoint.png" format="PNG"/></imageobject></mediaobject> For shifting individual points in a object: 
<orderedlist><listitem>
<para>left-click (and hold) on the point to be shifted </para>
</listitem>
<listitem>
<para>with the left mouse button held move the mouse to reposition the point </para>
</listitem>
<listitem>
<para>release the mouse button</para>
</listitem>
</orderedlist>
</para>
</sect3>

<sect3 id="adding-points">
<title>Adding points</title>

<para><mediaobject><imageobject><imagedata fileref="newpoint.png" format="PNG"/></imageobject></mediaobject> This tool adds control points to an object. To add a point left-click on the object at the point where the new control point is desired. </para>
</sect3>

<sect3 id="removing-points">
<title>Removing points</title>

<para><mediaobject><imageobject><imagedata fileref="rmpoint.png" format="PNG"/></imageobject></mediaobject> With this tool one can delete control points from an object---simply left-click on the point to be deleted. </para>
</sect3>

<sect3 id="filling-objects">
<title>Filling objects</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> To fill an object with a color select the object and left-click on the desired color in the color palette. If the required color is not in the palette or a pattern fill is required, proceed as follows: 
<orderedlist><listitem>
<para>select the object to be filled.</para>
</listitem>
<listitem>
<para>right-click on the object---a popup menu appears. </para>
</listitem>
<listitem>
<para>select the "Properties" menu entry. </para>
</listitem>
<listitem>
<para>select the "Fill" tab in the dialog. </para>
</listitem>
<listitem>
<para>choose to fill with a solid color, a pattern, or a gradient color.</para>
</listitem>
</orderedlist>

NOTE: Remember to choose a color by clicking the colored buttons in the dialog else it might appear that there is no fill. </para>
</sect3>
</sect2>
</sect1>

<sect1 id="positioning-objects">
<title>Positioning objects</title>

<para>&kontour; offers many ways to assist in the positioning of objects.  </para>

<sect2 id="grid">
<title>Grid</title>

<para>The grid is an aid allowing the user to work on a drawing precisely. Grid behaviour can be controlled by three functions (parentheses show the menu entries used to access the fuctions): 
<orderedlist><listitem>
<para>Show Grid (View -&gt; Show Grid), show the grid in the drawing. </para>
</listitem>
<listitem>
<para>Align to Grid (Layout -&gt; Align to Grid), objects now snap to the grid.</para>
</listitem>
<listitem>
<para>Grid setup (Layout -&gt; Grid), setup the grid.</para>
</listitem>
</orderedlist>

The first and second functions can be performed during the setup of the grid distances by toggling the buttons in the Grid Setup dialog. </para>
</sect2>

<sect2 id="helplines">
<title>Helplines</title>

<para>Helplines provide a further mechanism to the Grid when precise drawing is required. The advantage of using helplines is that the distance between individual helplines can be varied. The proceedure for Helpline use is identical to the Grid.</para>
</sect2>

<sect2 id="aligning-objects">
<title>Aligning objects</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> This function allows objects to be aligned with respect to each other and/or the page. For example a group of objects can be aligned such that their left edges are all in line or such that they are evenly distributed throughout the page. Select the object(s) to be Aligned and right-click, select "Align" from the menu and the following dialog appears:</para>

<mediaobject><imageobject><imagedata fileref="align" format="PNG"/></imageobject></mediaobject>

<para>NOTE: At the time of writing not all functionality of "Align" has been implemented. It is hoped that further functionality will be added soon. </para>
</sect2>

<sect2 id="aligning-text-along-a-path">
<title>Aligning text along a path</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> If the path is already drawn, then one proceeds as follows:
<orderedlist><listitem>
<para>select the text to be aligned </para>
</listitem>
<listitem>
<para>choose "Text along Path" from the arrange menu </para>
</listitem>
<listitem>
<para>select the object to be used as the path with a left-click (the right mouse button cancels).</para>
</listitem>
</orderedlist>
</para>

<para>The following Objects can be used as Paths:
<itemizedlist>
<listitem>
<para><link linkend="fh">Freehand lines</link></para>
</listitem>
<listitem>
<para><link linkend="li">Lines</link>, 
<link linkend="pf">Polylines</link>, 
<link linkend="gp">Polygons</link> </para>
</listitem>
<listitem>
<para><link linkend="be">Bezier curves </link></para>
</listitem>
<listitem>
<para><link linkend="el">Ellipses</link></para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="grouping-of-objects">
<title>Grouping of Objects:</title>

<para>Individual objects can be grouped together. This is useful of one wants to assemble complex drawings from individual objects and then treat these compound objects as one object. Objects are grouped as follows 
<orderedlist><listitem>
<para>select the objects to be grouped. Multiple objects can be selected by enclosing them inside a selection box by using the selection tool and/or selecting objects while holding down the SHIFT key. </para>
</listitem>
<listitem>
<para>choose "Group" from the "Arrange" menu.</para>
</listitem>
</orderedlist>

A grouped object can be separated into it's constituent objects by selecting the group and choosing "Ungroup" from the "Arrange" menu. </para>
</sect2>
</sect1>

<sect1 id="the-layer-concept">
<title>The Layer Concept</title>

<sect2 id="what-are-layers">
<title>What are layers?</title>

<para>Layers may be thought of as sheets of transparent paper with different pieces of the overall drawing on each. Together the layers form the overall drawing, but each layer may be edited independantly of the others. Layers are controlled via the Layers dialog (View -&gt; Layers...). Each layer has three characteristics represented by the eye, pen, and printer icons respectively: </para>

<para><itemizedlist>
<listitem>
<para>Visible: allows the in/visible.</para>
</listitem>
<listitem>
<para>Editable: determines whether changes may be made to the layer. </para>
</listitem>
<listitem>
<para>printable: allows the layer to be printed.</para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2 id="working-with-layers">
<title>Working with layers</title>
	<para></para>
</sect2>
</sect1>

<sect1 id="working-with-files">
<title>Working with Files</title>

<sect2 id="saving-files">
<title>Saving Files</title>

<para>There are two main ways to save a file, either via the "File" menu item, or by clicking on the Diskette icon in the list of icons. If you've just created the drawing you're working on, and haven't saved it yet, you will be taken taken to a dialog where you can choose a name. This will happen regardless of which of the two methods you choose.</para>

<mediaobject><imageobject><imagedata fileref="save_dialog.png" format="PNG"/></imageobject></mediaobject>

<para>If the file already has a name, it will be used unless you select the menu item "Save As".
You should ALWAYS use the file extension <literal>.kil</literal>. This is the only way to ensure that &kontour; doesn't run into problems when it tries to find the file again.</para>
</sect2>

<sect2 id="loading-files">
<title>Loading Files</title>

<para>Just as in saving files, there are two ways to load them. You can click on the corresponding icon from the list, or you can use the "Open" item from the "File" menu. Either way brings you to the "Open" dialog.</para>

<mediaobject><imageobject><imagedata fileref="open_dialog.png" format="PNG"/></imageobject></mediaobject>

<para>Since this dialog form conforms to the KDE standard, we won't go into the workings of every button. If you've selected the file you want to open a preview appears on the right side of the dialog box. Now you can load it by double-clicking the file name, or by clicking on the "OK" button.</para>
</sect2>

<sect2 id="importing-and-exporting-files">
<title>Importing and Exporting Files</title>

<para>Regrettably, perhaps, one measure of a program's worth seems to be how many other programs' formats it supports. This does, however, afford a degree of flexibility to a piece of software; such import and export filters are necessary. &kontour; can import a number of file formats:
<itemizedlist>
<listitem>
<para>&kontour; Drawings (.kil)</para>
</listitem>
<listitem>
<para>XFig Drawings (.fig)</para>
</listitem>
<listitem>
<para>Windows Metafiles (.wmf) </para>
</listitem>
<listitem>
<para>GIF Images (.gif)</para>
</listitem>
<listitem>
<para>JPEG Images (.jpg)</para>
</listitem>
<listitem>
<para>PNG Images (.png)</para>
</listitem>
<listitem>
<para>X11 Bitmaps </para>
</listitem>
<listitem>
<para>X11 Pixmaps (.xpm)</para>
</listitem>
</itemizedlist>

&kontour; can export files in the following formats:
<itemizedlist>
<listitem>
<para>GIF Images (.gif)</para>
</listitem>
<listitem>
<para>X11 Pixmaps (.xpm) </para>
</listitem>
<listitem>
<para>Encapsulated Postscript (.eps) </para>
</listitem>
<listitem>
<para>PPM Images (.ppm)</para>
</listitem>
</itemizedlist>
</para>

<sect3 id="importing">
<title>Importing</title>

<para>Importing objects into a &kontour; drawing doesn't work quite the same for all formats,
unfortunately. You will find most of the import filters in the "Edit" menu under "Insert".
The submenu item "Clipart" lets you insert <literal>.wmf</literal> files.The filters for
pixel-oriented images are under the submenu item "Bitmap". To import XFig drawings
or another &kontour; drawing, you have to use the "Import" item from the "File" menu.
Dialogs are similar to those for opening files.</para>
</sect3>

<sect3 id="exporting">
<title>Exporting</title>

<para>Via the "File" menu and the item "Export" you reach the following Dialog:</para>

<mediaobject><imageobject><imagedata fileref="export.png" format="PNG"/></imageobject></mediaobject>

<para>This is very similar to the dialog for saving files. The only difference is the fact that you can choose what format to save the file in.</para>
</sect3>
</sect2>

<sect2 id="printing-files">
<title>Printing Files</title>
	<para></para>
</sect2>
</sect1>

<sect1 id="undo--redo">
<title>Undo / Redo</title>

<para>Previous operations in the drawing can be undone easily by using "Undo" from the "Edit" menu. If the undone step is then wanted again in the drawing this can be achieved by using "Redo". &kontour; remembers all steps made to a drawing from when it was started. One should consider, however, that Undo and Redo steps work on operations in the order in which they were performed on the drawing.</para>
</sect1>

<sect1 id="zoom-tool">
<title>Zoom tool</title>

<para><mediaobject><imageobject><imagedata fileref="zoom.png" format="PNG"/></imageobject></mediaobject> Zooming can be performed in two ways. The simplest is to use the drop down box in the main bar to select the required magnification level whose default value is 100&percnt;. The second method is to use the magnifying glass in the tool bar. Left-clicking on the canvas with the zoom tool increases the magnification to the next level. The magnification levels are:</para>

<para><itemizedlist>
<listitem>
<para>50&percnt; </para>
</listitem>
<listitem>
<para>100&percnt; </para>
</listitem>
<listitem>
<para>150&percnt; </para>
</listitem>
<listitem>
<para>200&percnt; </para>
</listitem>
<listitem>
<para>400&percnt; </para>
</listitem>
<listitem>
<para>600&percnt; </para>
</listitem>
<listitem>
<para>800&percnt; </para>
</listitem>
<listitem>
<para>1000&percnt;</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="handling-colours">
<title>Handling colors</title>

<para><mediaobject><imageobject><imagedata fileref="pfeil.png" format="PNG"/></imageobject></mediaobject> The colour handling process in &kontour; is very simple. Generally, a left-click on a colour in the colour palette changes the fill colour of the selected object(s); a right-click changes the outline colour (or the text colour) of the selected object(s). If the desired colour is not in the colour palette, then proceed as follows: </para>

<para><orderedlist><listitem>
<para>select the object whose colour is to be changed.</para>
</listitem>
<listitem>
<para>right-click on the object and choose "Properties" from the menu. </para>
</listitem>
<listitem>
<para>choose to change the fill colour or the outline colour from the dialog. </para>
</listitem>
<listitem>
<para>press the colour button and the following dialog is displayed: 
<inlinemediaobject><imageobject><imagedata fileref="colour.png" format="PNG"/></imageobject></inlinemediaobject>
</para>
</listitem>
<listitem>
<para>left-click in the multi-coloured window and select the desired colour by moving the mouse.  </para>
</listitem>
<listitem>
<para>release the left mouse button. </para>
</listitem>
<listitem>
<para>left-click (and hold) on the small triangle next to the shaded-grey window to the right of the multi-coloured window.</para>
</listitem>
<listitem>
<para>select the desired brightness by moving the mouse up and down. </para>
</listitem>
<listitem>
<para>release the left mouse button. </para>
</listitem>
<listitem>
<para>the colour may be saved in the Custom Colour palette by clicking in one of the custom colour squares and pressing the Add to Custom Colors button (this is optional). </para>
</listitem>
<listitem>
<para>press OK.</para>
</listitem>
</orderedlist>

Alternatively HSV and RGB values can be entered directly into the dialog by clicking in the appropriate field, typing the value, then pressing the ENTER key. </para>
</sect1>

<sect1 id="changing-the-standard-parameters">
<title>Changing the standard parameters</title>

<sect2 id="global-parameters">
<title>Global parameters</title>

<sect3 id="page-layout">
<title>Page layout</title>
	  <para></para>
</sect3>

<sect3 id="units">
<title>Units</title>
	  <para></para>
</sect3>
</sect2>

<sect2 id="default-drawing-parameters">
<title>Default drawing parameters</title>

<para>Default drawing parameters such as fill colour, line thickness and style can be set by changing parameters with no object selected. These parameters will be saved and used next time &kontour; is started. </para>
</sect2>
</sect1>
</chapter>

<chapter id="frequently-asked-questions">
<title>Frequently Asked Questions</title>

<para><variablelist>
<varlistentry>
<term>Question:</term>
<listitem>
<para>How can I use EPS files, which were exported from &kontour;, in LATEX?</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Answer:</term>
<listitem>
<para>This is possible using the <emphasis>clip</emphasis> option (<literal>\epsfig&lcub;file=graphics.eps, width=9cm, clip= &rcub;</literal>)</para>
<para></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Question:</term>
<listitem>
<para>How can I import ASCII text into a &kontour; document?</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Answer:</term>
<listitem>
<para>The importing of text is performed by copying/pasting. Copy the text from (as an example) a text editor. In &kontour; select Paste from the File menu, and position the text as desired.</para>
<para></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Question:</term>
<listitem>
<para>I can't find the &kontour; package in my SuSE distro!</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Answer:</term>
<listitem>
<para>SuSE didn't compile the different packages as separate applications. Use the complete package.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</chapter>

<chapter id="appendix">
<title>Appendix</title>

<sect1 id="shortcut">
<title>Key bindings</title>

<para>Some functions can be applied to several selected objects. This is noted by "selected objects" in the "Meaning" column. </para>

<para><screen>Key:            Meaning:
-------------	----------
CTRL-A		Align selected object(s) 
CTRL-PageDown 	Move selected object(s) back one
CTRL-PageUp 	Move selected object(s) forward one
CTRL-C 		Copy selected object(s)
CTRL-D 		Duplicate selected object(s) 
CTRL-G 		Group selected objects
CTRL-N 		Create a new drawing 
CTRL-O 		Open a new drawing 
CTRL-P 		Print 
CTRL-Q 		Quit &kontour;
CTRL-S 		Save current drawing
CTRL-U 		Ungroup selected objects 
CTRL-V 		Paste copied object from clipboard 
CTRL-W 		Cut the selected object(s)
CTRL-X 		Close the current drawing
CTRL-Y 		Toggle Align to Grid 
CTRL-Z 		Undo
DEL 		Delete selected object(s) 
F1 		Help
SHIFT-PageDown	Move selected object(s) to the back 
SHIFT-PageUp	Move selected object(s) to the front
</screen>
</para>
</sect1>

<sect1 id="to-do">
<title>TO DO</title>

<sect2 id="handbook">
<title>Handbook</title>

<para>There is surely much more than can and should be improved upon in this handbook. Here is a short list: 
<itemizedlist>
<listitem>
<para>Correct spelling and grammar ;-)</para>
</listitem>
<listitem>
<para>Aligning to objects </para>
</listitem>
<listitem>
<para>Layers </para>
</listitem>
<listitem>
<para>Printing</para>
</listitem>
</itemizedlist>

Suggestions and errors concerning this handbook in general should be directed toward <ulink url="mailto:Hagen.Hoepfner@gmx.de">Hagen</ulink>. Matters regarding the English translation can be sent to <ulink url="mailto:skeltobc@elec.canterbury.ac.nz">Ben</ulink>. </para>
</sect2>
</sect1>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>&kontour; is Copyright 1998-99 Kai-Uwe Sattler, kus@iti.cs.uni-magdeburg.de

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
</screen>
</para>
</chapter>
&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->

