# The KFLog Handbook

## Introduction

Please report any problems or feature requests to the KFLog mailing list. If You consider to join the developer-team, please feel free to contact us.

## Using KFLog

### The Mainwindow

When You start KFLog, the mainwindow appears. By default, it is divided into three parts. On the left You see the map (see the chapter Requirements for further information on how to optain and install mapfiles). On the right You can see the mapcontrol-panel at the bottom and the dataview-panel at the top.

Mainwindow of &kapp; Screenshot

All panels can be un-docked or hidden. When You close KFLog, the current state of all panels will be saved, and it will be restored, when You open the program the next time.

#### The Map-Panel

#### The Mapcontrol-Panel

To move the map, You can either use the arrow-buttons in the mapcontrol-panel, which move the map by the half of the width of the currently displayed area, or just click into the map using the middle mouse button to center the map to the point where You have clicked. If You have configured a home-site in the configuration-dialog, You can use the home-icon in the control-panel to easily center the map onto Your home-site.

Zooming is done via the slider in the control-panel. You can also use the zoomin- and zoomout-buttons in the toolbar and the view-menu. The control-panel show the width and the height of the displayed area measured in km. The scale-number gives the height of one pixel of the map measured in meter.

#### The Dataview

The dataview is used to display several data about a loaded flight or a task. When a flight is loaded, the panel shows the name of the pilot, the type and the id of the glider and the date of the flight. The task is given below, showing the name and position of the waypoints and the time, when the waypoints have been reached. In addition, You can see the distance between the points and the total distance of the task.

When You click on the name of one waypoint, the map will be centered and zoomed to that point.

### Configuration-Dialog

#### Identity

In this page, You can enter the name and position of Your homesite. The position is used to center the map using the home-icon in the map-control-panel.

#### Paths

In the path-page You can enter the default paths for the IGC-files, task and waypointlists, as well as for the mapfiles. Normaly, You only have to configure the first three paths.

#### Map-Scales

Here You can configure several scale-values used in KFLog. The value given right of the slider gives the height a pixel will have, when the map is displayed in the selected scale, measured in meters.

In the upper box, You can set the upper and lower scale-borders. Zooming the map is only possible between these two borders.

The scales set in the lower box are used to handle the drawing of the map. The three borders determine, which map-elements are displayed how. "Switch Scale" is used to select either big or small icons for the airfields and airports.

#### Map-Elements

In the page "Map-Elements" You can configure, how the map-elements should be displayed in the map or the printout. This configuration is done for each scale-border.

## Command Reference

### The main KFLog window

#### The File Menu

Ctrl o File Open flight

- Opens an existing IGC-file

Ctrl w File Close flight

- Closed all opened flights

Ctrl p File Print

- Prints the map

File Print flight

- Prints information about the currently loaded flight

Ctrl q File Quit

- Quits $kapp;

#### The View Menu

Ctrl+ View Zoom in

- Zooms into the map

Ctrl- View Zoom in

- Zooms out of the map

F5 View Redraw map

- Redraws the current map

F6 View Center to task

- Centers and zooms the map, so that the complete task can be seen

F7 View Center to flight

- Centers and zooms the map, so that the complete flighttrack can be seen

Ctrl Home View Center to homesite

- Centers the map to the configured homesite

View Move map

- Submenu with eight entries to move the map

#### The Flight Menu

Ctrl e Flight Evaluation

- Opens the evaluation-dialog

Flight ???

- ???

#### The Settings Menu

Settings Show Toolbar

- Shows or hides the toolbar

Settings Show Menubar

- Shows or hides the menubar

Settings Keybindings

- Opens a dialog to configure the keybindings

Settings Configure Toolbar

- Opens a dialog to configure the toolbar

Settings COnfigure $kapp;

- Opens a dialog to configure $kapp; (see the chapter Configuration-Dialog)

Settings Show Dataview

- Shows or hides the dataview-panel

Settings Show Mapcontrol

- Shows or hides the mapcontrol-panel

Settings Show Map

- Shows or hides the map-panel

## Developer's Guide to KFLog

Programming &kflog; plugins is a joy to behold. Just read through the next 66 pages of API's to learn how!

## Questions and Answers

&reporting.bugs; &updating.documentation;

My Mouse doesn't work. How do I quit &kapp;?

You silly goose! Check out the Commands Section for the answer.

Why can't I twiddle my documents?

You can only twiddle your documents if you have the foobar.lib installed.

## Credits and License

&kapp;

Program copyright 1997 John Q. Hacker jqh@kde.org

Contributors:

- Konqui the KDE Dragon konqui@kde.org

- Tux the Linux Penguin tux@linux.org

Documentation copyright 1999 George N. Ugnacious gnu@kde.org

&underFDL; &underGPL; &underBSDLicense; &underArtisticLicense; &underX11License;

## Installation

### How to obtain Doctest

&kflog; is part of the KDE project http://www.kde.org. &kflog; can be found in the kdeutils package on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project.

### Requirements

In order to successfully use &kflog;, you need KDE 1.1. Foobar.lib is required in order to support the advanced &kflog; features. &kflog; uses about 5 megs of memory to run, but this may vary depending on your platform and configuration.

All required libraries as well as &kflog; itself can be found on The &kflog; home page.

You can find a list of changes at http://apps.kde.org/kapp.

### Compilation and Installation

In order to compile and install KApp on your system, type the following in the base directory of the Icon Editor distribution:

    % ./configure
    % make
    % make install

Since KApp uses autoconf and automake you should have not trouble compiling it. Should you run into problems please report them to the KDE mailing lists.

### Configuration

Don't forget to tell your system to start the `dtd` dicer-toaster daemon first, or KApp won't work !

&documentation.index;