<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kpl "<application>Kpl</application>">
  <!ENTITY kappname "&kpl;">
  <!ENTITY package "kde-module">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title>Das &kpl;-Handbuch</title>

<authorgroup>
<author>
<personname>
<firstname>Werner</firstname>
<surname>Stille</surname>
</personname>
<email>stille@uni-freiburg.de</email>
</author>
</authorgroup>

<copyright>
<year>2011</year>
<holder>Werner Stille</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2011-06-14</date>
<releaseinfo>4.0</releaseinfo>

<abstract>
<para>
&kpl; ist ein Programm zur zwei- und dreidimensionalen grafischen Darstellung
von Datensätzen und Funktionen.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Kpl</keyword>
<keyword>plot</keyword>
<keyword>parameter fit</keyword>
</keywordset>

</bookinfo>

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

<para>
&kpl; ist ein Programm zur zwei- und dreidimensionalen grafischen Darstellung
von Datensätzen und Funktionen. Außerdem können mehrdimensionale nichtlineare
Parameteranpassungen von Funktionen an Datensätze mittels des
Levenberg-Marquardt-Algorithmus durchgeführt werden. Auch allgemeine lineare
Parameteranpassungen sind möglich. Eine
<acronym>D-Bus</acronym>-Schnittstelle ermöglicht die Steuerung von &kpl; durch
andere Anwendungen oder Skripte.</para>
<para>
Alle Einstellungen, die zur vollständigen Beschreibung der Darstellung nötig
sind, können in Plotdateien gespeichert werden. Diese Dateien sowie
Datendateien können mittels Befehlszeilenparameter, Dateimenü und
Drag-and-Drop-Technik zum Einlesen ausgewählt werden.</para>
<para>
Automatische Skalierung und Normierung machen eine einfache grafische
Darstellung von Daten möglich. Auch Parameteranpassungen können automatisch
ausgeführt werden.</para>
<para>
Die Einstellungen einer Darstellung können über Dialoge zum Bearbeiten der
Plotbestandteile verändert werden. Hinzugefügte Datensätze und Funktionen
können sowohl im gleichen als auch in weiteren Datenfenstern dargestellt
werden.</para>

<sect1 id="kpl-revhistory">
<title>&kpl;-Versionsgeschichte</title>
<para>
<itemizedlist>

<listitem>
<para>Version 4.0 (14. Juni 2011)</para>
<itemizedlist>
 <listitem><para>Version für KDE 4</para></listitem>
 <listitem><para>K-Menüeintrag in Kategorie Lernprogramme/Mathematik
 verschoben</para></listitem>
 <listitem><para>Statuszeile zeigt Informationen über Bestandteil unter dem
 Mauszeiger an</para></listitem>
 <listitem><para>Koordinaten im Pfeil-Dialog können nun als solche der Spitze,
 der Mitte oder des Endes angegeben werden</para></listitem>
 <listitem><para>Auswahlfeld für zweispitzig im Pfeil-Dialog</para></listitem>
 <listitem><para>Bildbestandteile können rotiert werden</para></listitem>
 <listitem><para>Parameterdateien dürfen Leerzeilen und Kommentarzeilen
 (beginnend mit #) enthalten</para></listitem>
 <listitem><para>Parameterdateien mit mehr als einer Spalte werden korrekt
 geladen</para></listitem>
 <listitem><para>Bestandteilliste kann nun an das Hauptfenster angedockt
 werden</para></listitem>
 <listitem><para>Ausschneiden, Kopieren und Einfügen von Bestandteilen möglich,
 auch zwischen unterschiedlichen Instanzen von &kpl;</para></listitem>
 <listitem><para>Als Typ für exportierte Dateien kann Encapsulated PostScript
 oder PostScript gewählt werden</para></listitem>
 <listitem><para>PostScript-Vorschau nutzt das PostScript-Dateien aktuell
 zugeordnete Programm</para></listitem>
 <listitem><para><acronym>D-Bus</acronym>-Schnittstelle</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 3.3 (28. Dezember 2005)</para>
<itemizedlist>
 <listitem><para>Mehrere Spline-Bestandteile können simultan an den
 gleichen Feldbestandteil angepasst werden</para></listitem>
 <listitem><para>x- und y-Werte von Feld-, Funktions- und Spline-Bestandteilen
 können verschoben werden</para></listitem>
 <listitem><para>Quadrat-Auswahlfeld im Dialog Rechteck, Kreis-Auswahlfeld
 im Dialog Ellipse, Kreisbogen-Auswahlfeld im Dialog Bogen</para></listitem>
 <listitem><para>In der Bestandteilliste  werden farbige Symbol-Pixmaps
 angezeigt</para></listitem>
 <listitem><para>In der Bestandteilliste  wird der Text von Legenden- und
 Text-Bestandteilen angezeigt</para></listitem>
 <listitem><para>Knöpfe des Dialogs Bestandteile sind deaktiviert, wenn
 ihre Aktionen nicht angewendet werden können</para></listitem>
 <listitem><para>Relative Symbolgröße kann in den Autoplot-Einstellungen
 voreingestellt werden</para></listitem>
 <listitem><para>Benachrichtigungen über fertiggestellte Plots und
 Parameteranpassungen können eingestellt werden</para></listitem>
 <listitem><para>Benötigt KDE 3.x</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 3.2 (7. Februar 2004)</para>
<itemizedlist>
 <listitem><para>Mustergefüllte Flächen gegeben durch Felder, Funktionen,
 Splines, Rechtecke oder Ellipsen</para></listitem>
 <listitem><para>Neuer Bestandteil zum Einbetten von
 EPS-Bilddateien</para></listitem>
 <listitem><para>Neuer Maßstabsbestandteil</para></listitem>
 <listitem><para>Neue DCOP-Funktionen für Bild- und
  Maßstabs-Bestandteile</para></listitem>
 <listitem><para>PostScript-Vorschau</para></listitem>
 <listitem><para>Option zum Drucken von
  PostScript-Ausgabedateien</para></listitem>
 <listitem><para>Rahmenbestandteile können in der Baumansicht geschlossen
  gehalten werden</para></listitem>
 <listitem><para>x- oder y-Spalte kann als Argument der Fehlermodellfunktion
 für Parameteranpassungen gewählt werden</para></listitem>
 <listitem><para>Punkt oder Komma kann als Dezimalsymbol von Datendateien
  gewählt werden (benötigt KDE 3.1)</para></listitem>
 <listitem><para>Kontext-Menü für sichtbare Bestandteile</para></listitem>
 <listitem><para>NaN (not a number) und inf (infinity) in Datendateien werden
  in Plots ignoriert</para></listitem>
 <listitem><para>K-Menüeintrag zur Kategorie Büroprogramme
  verschoben</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 3.1 (2. April 2003)</para>
<itemizedlist>
 <listitem><para>Nullstellensuche für Funktionen und
  Spline-Interpolationen</para></listitem>
 <listitem><para>Bestandteile können durch Drag and Drop innerhalb der
  Bestandteilliste verschoben werden</para></listitem>
 <listitem><para>Neue oder kopierte Bestandteile können vor dem aktuellen
  Bestandteil eingefügt werden</para></listitem>
 <listitem><para>Darstellung kann mit mittlerer Maustaste neu skaliert
  werden</para></listitem>
 <listitem><para>Format- und Genauigkeitseinstellungen wirken nun auf
  Funktionsbereichseingaben</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 3.0 (30. September 2002)</para>
<itemizedlist>
 <listitem><para>Version für KDE 3</para></listitem>
 <listitem><para>Neue Bestandteile für 3D-Oberflächenplots von Datensätzen
  und Funktionen</para></listitem>
 <listitem><para>Neuer Bestandteil für glättende
  Spline-Interpolation</para></listitem>
 <listitem><para>Neuer Dekorationsbestandteil: Bogen</para></listitem>
 <listitem><para>Rechteck- und Ellipsenbestandteile können gedreht
  werden</para></listitem>
 <listitem><para>Neue DCOP-Funktionen für 3D-,
  Spline- und Bogen-Bestandteile</para></listitem>
 <listitem><para>Autoskalierung berücksichtigt nur die Bereiche aktiver
  Bestandteile</para></listitem>
 <listitem><para>Symbolgröße kann für jeden Feld-, Funktions-, Spline- oder
  Legendenbestandteil individuell eingestellt werden</para></listitem>
 <listitem><para>Kombobox zur Auswahl verschiedener
  Standard-Seitenformate</para></listitem>
 <listitem><para>x- und y-Achsen können jeweils auf beiden Seiten dargestellt
  werden</para></listitem>
 <listitem><para>Erste Zahlen an x- und y-Achsen müssen nicht am linken
  bzw. unteren Rand liegen</para></listitem>
 <listitem><para>Parameteranpassungen bei sehr kleinen
  und sehr großen Datenwerten verbessert</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 2.3.0 (12. Oktober 2001)</para>
<itemizedlist>
 <listitem><para>Benötigt KDE 2.2</para></listitem>
 <listitem><para>Residuen von Parameteranpassungen können grafisch
  angezeigt werden</para></listitem>
 <listitem><para>Felder können optional innerhalb von Plotdateien gespeichert
  werden</para></listitem>
 <listitem><para>Trennzeichen für exportierte Dateien mit Funktionswerten
  und Parametern kann eingestellt werden</para></listitem>
 <listitem><para>Parameter von Funktionsbestandteilen können direkt
  angewendet werden</para></listitem>
 <listitem><para>Neue DCOP-Funktion: activateItem()</para></listitem>
 <listitem><para>Verbesserte Auswahl und Aktivierung im Dialog Bestandteile</para></listitem>
 <listitem><para>Gemäß KDE Standard verbesserte Dialoge</para></listitem>
 <listitem><para>Rückgabetyp boolescher DCOP-Funktionen zur Vermeidung
  von Problemen zu int geändert</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 2.2 (22. Mai 2001)</para>
<itemizedlist>
 <listitem><para>Daten- und Plotdateien können wahlweise zur aktuellen
  Darstellung hinzugefügt werden</para></listitem>
 <listitem><para>Neue Dekorationsbestandteile: Text, Linie,
  Pfeil, Rechteck, Ellipse</para></listitem>
 <listitem><para>Position von Bestandteilen kann durch Ziehen mit der Maus
  geändert werden</para></listitem>
 <listitem><para>Knopf für Neu laden im Dialog Feld</para></listitem>
 <listitem><para>Leerzeilen in Datendateien werden ignoriert</para></listitem>
 <listitem><para>x- und y-Achse können alternativ oben bzw. rechts
  plaziert werden</para></listitem>
 <listitem><para>Japanische Übersetzung</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 2.1.1 (27. Januar 2001)</para>
<itemizedlist>
 <listitem><para>Bug fixes</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 2.1 (22. Januar 2001)</para>
<itemizedlist>
 <listitem><para>DCOP-Schnittstelle</para></listitem>
 <listitem><para>Logarithmische Skalierung</para></listitem>
 <listitem><para>Nur modifizierte Dateien werden periodisch neu
  geladen</para></listitem>
 <listitem><para>Position der Werkzeugleiste wird in der Konfigurationsdatei
  gesichert</para></listitem>
 <listitem><para>Verbesserter Dialog Neuer Bestandteil</para></listitem>
 <listitem><para>Neue Feld- und Funktionsbestandteile übernehmen die
  Normierungsfaktoren vorhergehender Bestandteile</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 2.0 (21. November 2000)</para>
<itemizedlist>
 <listitem><para>Benötigt KDE 2.0, optimiert für KDE 2.0</para></listitem>
 <listitem><para>Menüpunkt Werkzeugleisten einrichten im Menü
  Einstellungen</para></listitem>
 <listitem><para>Menüpunkt Absolute Pfade speichern im Menü Einstellungen
  </para></listitem>
 <listitem><para>Verbesserte Prüfung von Fließkommaeingaben
  </para></listitem>
 <listitem><para>Spinboxen im Feld-Dialog werden aktualisiert
  </para></listitem>
 <listitem><para>Unicode-Text in .plo-Dateien (Wandeln Sie Ihre alten
  .plo-Dateien nach UTF8 um, wenn nicht-ASCII-Zeichen enthalten sind)
  </para></listitem>
 <listitem><para>Größe der Dialogfenster kann verändert werden
  </para></listitem>
 <listitem><para>Polnische Übersetzung</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 1.2 (10. August 2000)</para>
<itemizedlist>
 <listitem><para>Rückgängigmachen und Wiederherstellen von Änderungen
  </para></listitem>
 <listitem><para>Paket für KDE 2 beta erhältlich</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 1.1 (5. Mai 2000)</para>
<itemizedlist>
 <listitem><para>Mehrdimensionale Parameteranpassung</para></listitem>
 <listitem><para>Verbesserter Dialog zur Parameteranpassung
  </para></listitem>
 <listitem><para>Erhöhte Druckauflösung</para></listitem>
 <listitem><para>Wahlweise hoch- und querformatige PostScript-Ausgabe
  </para></listitem>
 <listitem><para>Mehr Beispiele</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 1.0 (21. Februar 2000)</para>
<itemizedlist>
 <listitem><para>Druckknöpfe zum Öffnen des Symbolauswahldialogs zeigen
  aktuelles Symbol</para></listitem>
 <listitem><para>Verbesserte Internationalisierung</para></listitem>
 <listitem><para>Erweiterte Hilfe</para></listitem>
 <listitem><para>Mehr Beispiele</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 0.4 (14. Januar 2000)</para>
<itemizedlist>
 <listitem><para>Allgemeine lineare Parameteranpassung</para></listitem>
 <listitem><para>Langdauernde Parameteranpassungen können durch Benutzer
  abgebrochen werden</para></listitem>
 <listitem><para>Ausgabeformat für Parameterdateien und Dialogfenster kann
  geändert werden</para></listitem>
 <listitem><para>Ausgabeformat der Statuszeile wird entsprechend der
  Bildschirmauflösung gewählt</para></listitem>
 <listitem><para>Dialog Bestandteile ist nun nichtmodal</para></listitem>
 <listitem><para>Mehrere Eingabedateien bei Befehlszeilenaufruf und bei
  Drag-and-Drop möglich</para></listitem>
 <listitem><para>Sowohl KDE- als auch Qt-Drag-and-Drop-Protokoll
  unterstützt</para></listitem>
 <listitem><para>Session-Management</para></listitem>
 <listitem><para>Funktionswertepuffer für schnelleres Zeichnen
  </para></listitem>
 <listitem><para>Mehr Beispielfunktionen</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 0.3 (28. September 1999)</para>
<itemizedlist>
 <listitem><para>Plotbestandteile können zum (zeitweisen) Verstecken
  deaktiviert werden</para></listitem>
 <listitem><para>Reihenfolge der Plotbestandteile kann einfach geändert
  werden</para></listitem>
 <listitem><para>Verbessertes Lesen der Plotdateien mittels KSimpleConfig
  </para></listitem>
 <listitem><para>Neue Plotdateien speichern den Aktivierungszustand der
  Bestandteile</para></listitem>
 <listitem><para>Verbessertes Erkennen von .plo-Dateien am Dateinamen
  </para></listitem>
 <listitem><para>Keine Mehrfachauswahl zur Parameteranpassung nötig, wenn
  nur eine Funktion und ein Feld vorhanden sind</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 0.2 (29. Juli 1999)</para>
<itemizedlist>
 <listitem><para>Benötigt KDE 1.1</para></listitem>
 <listitem><para>Powered by KDevelop</para></listitem>
 <listitem><para>Nichtlineare Parameteranpassung</para></listitem>
 <listitem><para>Positionen von Menü- und Werkzeugleiste werden in der
  Konfigurationsdatei gesichert</para></listitem>
 <listitem><para>Menüs mit Icons</para></listitem>
 <listitem><para>Kurzhilfe in der Statuszeile</para></listitem>
 <listitem><para>Menüpunkt Schließen im Menü Datei</para></listitem>
 <listitem><para>Menüpunkt Zuletzt geöffnet im Menü Datei</para></listitem>
 <listitem><para>Ein-/Ausschalten der Warnung bei ungesicherten Änderungen
  </para></listitem>
 <listitem><para>Menüpunkte und Werkzeug-Icons für Vergrößern und
  Verkleinern</para></listitem>
 <listitem><para>Menüpunkt Tastenbelegungen im Menü Einstellungen
  </para></listitem>
 <listitem><para>Kontextmenü</para></listitem>
 <listitem><para>Verbesserter Bildaufbau mittels pixmap-Puffer
  </para></listitem>
 <listitem><para>Funktionsparameter können separat in ASCII-Dateien
  gespeichert werden</para></listitem>
 <listitem><para>Funktionswerte können in Form von ASCII-Dateien
  exportiert werden</para></listitem>
 <listitem><para>Optionale Anzeige des Funktionsquelltexts in
  Parameterdialogen</para></listitem>
 <listitem><para>Optionale Berechnung der Bounding Box für PostScript-Dateien
  (mit Hilfe von Ghostscript)</para></listitem>
 <listitem><para>MimeType für kpl-Plotdateien</para></listitem>
</itemizedlist>
</listitem>

<listitem>
<para>Version 0.1 (13. April 1999, erste Version)</para>
</listitem>

</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="using-kpl">
<title>Benutzung von &kpl;</title>

<sect1 id="command-line-options">
<title>Befehlszeilenoptionen</title>

<sect2 id="specify-files">
<title>Angabe von Dateien</title>

<para>
Beim Aufruf von &kpl; von der Befehlszeile können zum Öffnen die Namen einer
oder mehrerer Plot- oder Datendateien (entweder lokale Dateinamen oder URLs)
übergeben werden:
<cmdsynopsis>
<command>kpl</command>
<arg rep="repeat"><replaceable>Datei</replaceable></arg>
</cmdsynopsis>
</para>
<para>
Im Fall von mehr als einer angegebenen Datei und aktivierter Option
<guilabel>Dateien hinzufügen</guilabel> in den
<link linkend="settings">Grundeinstellungen</link> werden alle
Dateien in einem Fenster angezeigt, andernfalls wird für jede Datei ein neues
Fenster geöffnet.</para>
<para>
Wenn <guilabel>Autofit</guilabel> in den
<link linkend="settings">Grundeinstellungen</link> aktiviert ist, erfolgt bei einer
Datendatei auch die Parameteranpassung an eine Funktion und deren Darstellung
unmittelbar.</para>
</sect2>

<sect2>
<title>Weitere Befehlszeilenoptionen</title>

<para>Die folgenden Hilfe-Befehlszeilenoptionen sind verfügbar:</para>
<variablelist>
<varlistentry>
<term><command>kpl <option>--help</option></command></term>
<listitem><para>Hilfe zu verfügbaren Optionen anzeigen</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--help-qt</option></command></term>
<listitem><para>Spezielle Optionen zu Qt anzeigen</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--help-kde</option></command></term>
<listitem><para>Spezielle Optionen zu KDE anzeigen</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--help-all</option></command></term>
<listitem><para>Alle Optionen anzeigen</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--author</option></command></term>
<listitem><para>Autoren-Information anzeigen</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--version</option></command></term>
<listitem><para>Versionsinformation anzeigen, auch verfügbar durch <command>kpl <option>-v</option></command>
</para></listitem>
</varlistentry>

<varlistentry>
<term><command>kpl <option>--license</option></command></term>
<listitem><para>Lizenz-Informationen anzeigen
</para></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="dolphin">
<title>Start über Dolphin</title>

<para>
&kpl; kann zur Anzeige einer Plotdatei durch Anklicken ihres Symbols in einem
Dolphin-Dateimanagerfenster oder durch Auswahl dieser Aktion in ihrem
Kontextmenü gestartet werden.</para>
</sect1>

<sect1 id="items">
<title>Bestandteile</title>

<para>
Wenn bereits Bestandteile einer grafischen Darstellung vorhanden sind, wird
ihre Liste als Baumansicht im Dockfenster <guilabel>Bestandteile</guilabel>
angezeigt. Das Fenster kann an jede Seite des &kpl;-Haupfensters angedockt
werden. Es kann auch als separates Fenster vom Hauptfenster abgekoppelt werden.
Wenn das Fenster geöffnet bleibt, zeigt es Änderungen in der Bestandteilliste
an.</para>
<para>Dabei sind bei einem <guilabel>Rahmen</guilabel>, einem
<guilabel>Bogen</guilabel>, einem <guilabel>Rechteck</guilabel> und einer
<guilabel>Ellipse</guilabel> Position und Größe des Rahmens angegeben, bei
einem <guilabel>Feld</guilabel> der Name der Datendatei sowie die
Spaltenindizes für x- und y-Werte, bei einem <guilabel>3D-Feld</guilabel> der
Name der Datendatei, bei einer <guilabel>Funktion</guilabel> und einer
<guilabel>3D-Funktion</guilabel> der Name der
<foreignphrase lang="en">shared library</foreignphrase> und der der Funktion,
bei einer <guilabel>parametrischen Funktion</guilabel> die Namen der
<foreignphrase lang="en">shared libraries</foreignphrase> und die der
Funktionen für x(t) und y(t), bei einem <guilabel>Spline</guilabel> der Grad
des Polynoms, bei einer <guilabel>Legende</guilabel> und einem
<guilabel>Text</guilabel> der Text und die Position, bei einem
<guilabel>Maßstab</guilabel> die Orientierung und die Position, bei einer
<guilabel>Linie</guilabel> und einem <guilabel>Pfeil</guilabel> Position und
Richtung. Bei einem <guilabel>Feld</guilabel>, einer
<guilabel>Funktion</guilabel> oder <guilabel>parametrischen Funktion</guilabel>
und einer <guilabel>Legende</guilabel> wird außerdem das Plotsymbol in der
gewählten Farbe angezeigt. Farben werden auch für Bogen-, Rechteck-, Ellipsen-,
Linien-, Pfeil- und Maßstabsbestandteile angezeigt.</para>
<para>
Die Baumansicht zeigt Bestandteile des Typs Rahmen eine Hierachieebene höher
als die anderen Bestandteile. Diese anderen Bestandteile, die in der Liste
einem Rahmen folgen, werden innerhalb des Rahmens dargestellt. Die Reihe von
einem Rahmen zugeordneten Bestandteilen endet, wenn ein anderer Rahmen folgt.
Bestandteile ohne Rahmen, d. h. solche, die nicht auf einen Rahmen folgen,
werden ohne Rahmen dargestellt. Funktions- und Datenwerte werden dann in cm
interpretiert. 3D-Felder und 3D-Funktionen beinhalten die Funktion von Rahmen
und benötigen deshalb keinen zusätzlichen Rahmenbestandteil; ihnen können auch
weitere Bestandteile zugeordnet sein. Die Position eines Bestandteils
innnerhalb der Liste kann mit der Maus mittels
<link linkend="drag-and-drop">Drag and Drop</link> geändert werden.</para>
<para>
Jedem Bestandteil ist ein Auswahlfeld vorangestellt, daß seinen
Aktivierungszustand anzeigt. Aktivierte Bestandteile werden grafisch
dargestellt, deaktivierte versteckt. Der Zustand kann durch Anklicken des
Auswahlfelds mit der linken Maustaste oder über das Kontextmenü geändert
werden, das nach Anklicken eines Bestandteils mit der rechten Maustaste
erscheint.</para>
<para>Ein Bestandteil kann ohne Änderung seines Zustands durch Anklicken rechts
neben dem Auswahlfeld ausgewählt werden. Mehrere Bestandteile kann durch
Anklicken bei gedrückter <keycap>Strg</keycap>-Taste ausgewählt werden.
Verschiedene Aktionen für ausgewählte Bestandteile finden sich im Menü
<link linkend="edit-menu">Bearbeiten</link>.</para>
<para>
In der Baumansicht können Rahmenbestandteile durch Anklicken des Pfeilsymbols
geschlossen werden um die zugehörigen Bestandteile zur Verbesserung der
Übersichtlichkeit zu verstecken. Das Öffnen zum Anzeigen der zugehörigen
Bestandteile geschieht durch erneutes Anklicken des Pfeilsymbols. Der
entsprechende Zustand der Rahmenbestandteile wird in den Plotdateien
gespeichert.</para>

</sect1>

<sect1 id="drag-and-drop">
<title>Drag and Drop</title>
<para>
&kpl; unterstützt das Drag-and-Drop-Protokoll von Qt. Das bedeutet, daß Sie
eine oder mehrere Plot- oder Datendateien öffnen können, indem Sie ihre Symbole
mit der Maus auf das Datenfenster von &kpl; oder auf das Dockfenster
<link linkend="items">Items</link> mit der Liste der Bestandteile ziehen.
Datendateien werden dabei an der Dateierweiterung
<literal role="extension">.dat</literal>, Plotdateien an der Dateierweiterung
<literal role="extension">.plo</literal> erkannt. Neben lokalen Dateien können
auf diese Weise auch URLs übergeben werden.</para>
<para>
Im Fall von mehr als einer übergegebenen Datei und aktivierter Option
<guilabel>Dateien hinzufügen</guilabel> in den
<link linkend="settings">Grundeinstellungen</link> werden alle Dateien in einem
Fenster angezeigt, andernfalls wird für jede Datei ein neues Fenster
geöffnet.</para>
<para>
Drag and Drop kann auch zum Verschieben und Kopieren von Bestandteilen
innerhalb der Bestandteilliste benutzt werden. Zum Verschieben muß die
<keycap>Umschalt</keycap>-Taste beim Loslassen der Maustaste gedrückt
sein.</para>
<para>
Auch das Kopieren von Bestandteilen zu einer anderen Instanz von &kpl; kann
durch Loslassen von selektierten Bestandteilen auf der Bestandteilliste oder
dem Datenfenster dieser Instanz erfolgen.</para>
</sect1>

<sect1 id="positioning">
<title>Positionierung mit der Maus</title>
<para>
Zusätzlich zur Eingabe über die Dialoge unterstützt &kpl; die Anderung der
Position von Rahmen-, 3D-Feld-, 3D-Funktions-, Legenden-, Text-, Linien-,
Pfeil-, Bogen-, Rechteck-, Ellipsen-, Maßstabs- und Bildbestandteilen durch
Ziehen mit der Maus.</para>
<para>
Um einen Bestandteil zu bewegen, muß seine Fläche mit der linken Maustaste
angeklickt werden. Beim Bewegen der Maus bei gedrückter linker Maustaste wird
die aktuelle Position durch ein gestricheltes Rechteck markiert und zusätzlich
in der Statuszeile angezeigt. Die Darstellung wird nach Loslassen der Maustaste
entsprechend der neuen Position aktualisiert.</para>
<para>
Das Bewegen eines Rahmenbestandteils bewirkt auch entsprechende
Positionsänderungen aller seiner zugehörigen Bestandteile.</para>
<para>
Mehrere Bestandteile können zum gleichzeitigen Positionieren durch Anklicken
bei gedrückter Taste <keycap>Strg</keycap> ausgewählt werden.</para>
</sect1>

<sect1 id="scaling">
<title>Skalierung mit der Maus</title>
<para>
Zusätzlich zum Weg über den Dialog <link linkend="frame">Rahmen</link> kann
eine angezeigte 2D-Darstellung mit einem Rahmenbestandteil bequem mit Hilfe der
Maus neu skaliert werden. Dazu wird eine Ecke eines Rechtecks durch Drücken der
mittleren Maustaste festgelegt. Dann wird durch diagonales Bewegen der Maus ein
Rechteck aufgezogen. Seine endgültige Größe wird durch den Punkt definiert, an
dem die Maustaste losgelassen wird. Die Koordinaten der Ecken in Dateneinheiten
werden dann mit Hilfe der Autoskalierung von Kpl auf entprechende
Skalierungswerte des Rahmenbestandteils gerundet und die Darstellung wird neu
angezeigt.</para>
<para>
Die Bereiche für die x-Achsen von Funktions- und Spline-Bestandteilen werden
entsprechend verändert; die Schrittweite der x-Werte wird auf 0 gesetzt
(entsprechend einer automatischen Teilung der Bereiche in 100
Intervalle).</para>
</sect1>

<sect1 id="statusbar">
<title>Statuszeile</title>

<para>
In der Statuszeile am unteren Rand des &kpl;-Fensters werden rechts die
horizontale und vertikale Position des Mauszeigers in cm angezeigt, bei
Positionen im Datenbereich einer 2D-Darstellung zusätzlich in Dateneinheiten.
Beim Ändern der Position von Bestandteilen durch Ziehen mit der Maus wird
deren aktuelle Position angezeigt.</para>
<para>
Außerdem werden Informationen über den aktuell unter dem Mauszeiger
befindlichen Bestandteil angezeigt, einschließlich seiner Position in der Liste
(z-Wert).</para>
<para>
Links neben diesen Positionsfeldern wird der Status der Option
<guilabel>Dateien hinzufügen</guilabel> aus den
<link linkend="settings">Grundeinstellungen</link> angezeigt.</para>
<para>
Ganz links erscheint die Kurzhilfe zu den verschiedenen Aktionen.</para>
</sect1>

</chapter>

<chapter id="commands">
<title>Befehlsreferenz</title>

<sect1 id="file-menu">
<title>Das Menü Datei</title>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem><accel>N</accel>eu</guimenuitem>
</menuchoice></term>
<listitem><para><action>Erzeugt einen neuen leeren Plot.</action>
</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem>Pl<accel>o</accel>tdatei öffnen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet eine oder mehrere existierende
 Plotdateien.</action></para>
<para>
In einer Plotdatei sind alle Einstellungen einer grafischen Darstellung im
INI-Stil gespeichert.</para>
<para>
Im Fall von mehr als einer ausgewählten Datei und aktivierter Option
<guilabel>Dateien hinzufügen</guilabel> in den
<link linkend="settings">Grundeinstellungen</link> werden alle Dateien in einem
Fenster angezeigt, andernfalls wird für jede Datei ein neues Fenster
geöffnet.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Da<accel>t</accel>endatei öffnen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet eine oder mehrere existierende Datendateien.
</action></para>
<para>
Die Zahlenwerte müssen in Form von Zeilen und Spalten einer Textdatei
vorliegen. Innerhalb einer Zeile können Zahlenwerte durch Kommas, Tabulator-
oder Leerzeichen voneinander separiert sein.</para>
<para>
Als Dezimalzeichen kann im Dialog Punkt oder Komma gewählt werden.</para>
<para>
Kommentarzeilen müssen mit dem Zeichen <keycap>#</keycap> beginnen.</para>
<para>
Die Anzahl von Zeilen und Spalten wird von &kpl; erkannt. Leerzeilen
werden ignoriert.</para>
<para>
Nach Einlesen der Datei erfolgt unmittelbar deren Darstellung als 2D-Grafik
entsprechend den über die
<link linkend="autoplot">Autoplot-Einstellungen</link> gesetzten Werten.</para>
<para>
Im Fall von mehr als einer ausgewählten Datei und aktivierter Option
<guilabel>Dateien hinzufügen</guilabel> in den
<link linkend="settings">Grundeinstellungen</link> werden alle Dateien in einem
Fenster angezeigt, andernfalls wird für jede Datei ein neues Fenster
geöffnet.</para>
<para>
Das Einlesen von Datendateien überschreibt eine gegebenfalls vorher
dargestellte Grafik, wenn die Einstellung
<guilabel>Dateien hinzufügen</guilabel> deaktiviert ist. Soll eine Datendatei
zusätzlich in eine bestehende grafische Darstellung aufgenommen werden, ist
stattdessen die Einstellung <guilabel>Dateien hinzufügen</guilabel> zu
aktivieren oder über
<link linkend="edit-menu"><guimenuitem>Neuer Bestandteil</guimenuitem></link>
ein neuer Feldbestandteil zu erstellen,</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Zu<accel>l</accel>etzt geöffnete Dateien</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet ein Untermenü zur Auswahl einer von bis zu zehn
kürzlich geöffneten Plot- oder Datendateien.
</action></para>
<para>
Im Fall der aktivierter Einstellung <guilabel>Dateien hinzufügen</guilabel>
wird die Datei gegebenenfalls einer aktuellen Darstellung hinzugefügt,
andernfalls wird die aktuelle Darstellung ersetzt.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem>S<accel>p</accel>eichern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Speichert erzeugte bzw. geänderte Plotdatei.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Speichern <accel>u</accel>nter</guimenuitem>
</menuchoice></term>
<listitem><para><action>Erlaubt das Abspeichern einer Darstellung unter einem
anderen Dateinamen.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>P</keycap></keycombo></shortcut>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem><accel>D</accel>rucken</guimenuitem>
</menuchoice></term>
<listitem><para><action>Gibt die grafische Darstellung auf einen aus einer
Liste zu wählenden Drucker oder in eine Datei aus.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guisubmenu>PostScript-<accel>A</accel>usgabe</guisubmenu>
</menuchoice></term>
<listitem><para><action>Speichert die grafische Darstellung als
PostScript-Datei im
</action> <guimenuitem><accel>H</accel>ochformat</guimenuitem> oder im
<guimenuitem><accel>Q</accel>uerformat</guimenuitem>.</para>
<para>
Wenn die Option <guilabel>Interne PS-Kodierung benutzen</guilabel> in den
<link linkend="basic">Grundeinstellungen</link> ausgewählt ist, erzeugt &kpl;
leicht zu bearbeitende Dateien.</para>
<para>
Die Ausgabe kann als PostScript (PS) oder Encapsulated PostScript (EPS)
erfolgen. Letzteres erlaubt das Importieren der Grafiken in anderen
Anwendungen. Die Bounding Box wird exakt berechnet, wenn
<guimenuitem>PS Bounding Box berechnen</guimenuitem> in den
<link linkend="basic">Grundeinstellungen</link> aktiviert ist.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guisubmenu>PostScript-<accel>V</accel>orschau</guisubmenu>
</menuchoice></term>
<listitem><para><action>Erzeugt eine temporäre PostScript-Datei im
</action> <guimenuitem><accel>H</accel>ochformat</guimenuitem> oder im
<guimenuitem><accel>Q</accel>uerformat</guimenuitem> und zeigt sie durch Aufruf
des PostScript-Dateien aktuell zugeordneten Programms an. Dies erlaubt den
Ausdruck der PostScript-Ausgabe ohne dauerhaftes Anlegen einer
PostScript-Datei.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Neues <accel>F</accel>enster</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet eine neue Instanz von &kpl;.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>D</accel>atei</guimenu>
<guimenuitem>Fenste<accel>r</accel> schließen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Schließt das Fenster.</action> Wenn das geschlossene
Fenster die letzte geöffnete Instanz war, wird &kpl; beendet.
</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Q</keycap></keycombo></shortcut>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem>B<accel>e</accel>enden</guimenuitem>
</menuchoice></term>
<listitem><para><action>Beendet &kpl;.</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="edit-menu">
<title>Das Menü Bearbeiten</title>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>R</accel>ückgängig</guimenuitem>
</menuchoice></term>
<listitem><para><action>Macht letzte Änderung der Darstellung
rückgängig.</action> Bis zu 1000 Zustände sind gespeichert.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>Umschalt</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>W</accel>iedererstellen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Stellt letzte </action>
<guimenuitem><accel>R</accel>ückgängig</guimenuitem> gemachte Änderung wieder
her.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>X</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>A</accel>usschneiden</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt</action> ausgewählte Bestandteile von
der Bestandteilliste in die Zwischenablage.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>C</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>K</accel>opieren</guimenuitem>
</menuchoice></term>
<listitem><para><action>Kopiert</action> ausgewählte Bestandteile der
Bestandteilliste in die Zwischenablage.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>V</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>E</accel>infügen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Fügt</action> in der Zwischenablage gespeicherte
Bestandteile oder eine Plotdatei vor dem ausgewähltem Bestandteil der Liste
ein, oder, wenn kein Bestandteil ausgewählt ist, am Ende der Liste
an.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>N</accel>euer Bestandteil</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet das Dialogfenster <link linkend="newitem">Neuer
Bestandteil</link></action> zur Auswahl eines neuen Bestandteils, der vor dem
ausgewählten Bestandteil der Liste eingefügt wird, oder, wenn kein Bestandteil
ausgewählt ist, ans Ende der Liste angefügt wird.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>F2</keycap>
</shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>B</accel>earbeiten</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet ein Dialogfenster zum Bearbeiten</action> des
ausgewählten Bestandteils.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem>An<accel>p</accel>assen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet ein Dialogfenster zur Durchführung von
Anpassungen</action> von Funktionen oder Splines an Datensätze von
Feldbestandteilen. Bei Auswahl von einer oder mehrerer Funktionen und einem
oder mehrerer Felder wird der Dialog
<link linkend="fit">Parameteranpassung</link> zur Durchführung einer
(mehrdimensionalen) Parameteranpassung der Funktion(en) an den Datensatz bzw.
die Datensätze der Feldern geöffnet. Enthält die Bestandteilliste genau eine
Funktion und ein Feld, so ist keine Mehrfachauswahl nötig und der Dialog wird
zur Durchführung einer eindimensionalen Parameteranpassung geöffnet.
Andernfalls müssen Sie eine gleiche Anzahl von Funktionen und Feldern
auswählen. Im Fall von mehrdimensionaler Anpassung wird die erste ausgewählte
Funktion in der Liste an den ersten ausgewählten Datensatz in der Liste
angepasst und so fort. Bei Auswahl von einem oder mehreren Splines und eines
Felds öffnet der Druckknopf den Dialog
<link linkend="spline-fit">Glättende Spline-Anpassung</link> zur Durchführung
einer (glättenden) Spline-Anpassung an den Datensatz des
Feldes.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>Entf</keycap>
</shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>L</accel>öschen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Löscht</action> ausgewählte  Bestandteile.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><guimenu><accel>B</accel>earbeiten</guimenu>
<guimenuitem><accel>A</accel>ktiv</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ändert den Aktivierungszustand des ausgewählten
Bestandteils. Aktivierte Bestandteile werden grafisch dargestellt, deaktivierte
versteckt.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Pfeil hoch</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem>Nach <accel>o</accel>ben</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt den ausgewählten Bestandteil in der Liste
nach oben.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Pfeil runter</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem>Nach <accel>u</accel>nten</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt den ausgewählten Bestandteil in der Liste
nach unten.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu>
<guimenuitem><accel>Z</accel>um Anfang</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt den ausgewählten Bestandteil an den Anfang
der Liste.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu>
<guimenuitem>Zu<accel>m</accel> Ende</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt den ausgewählten Bestandteil ans Ende der
Liste.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>B</accel>estandteile</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet das Dockfenster </action>
<link linkend="items">Bestandteile</link> (wenn nicht bereits geöffnet), das
die Liste der Bestandteile der grafischen Darstellung
enthält.</para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="view-menu">
<title>Das Menü Ansicht</title>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Plus</keycap></keycombo></shortcut>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem>Ver<accel>g</accel>rößern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Vergrößert um 20 %.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Minus</keycap></keycombo></shortcut>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem>Ver<accel>k</accel>leinern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verkleinert um 20 %.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem><accel>Z</accel>oom</guimenuitem>
</menuchoice></term>
<listitem><para><action>Hier kann der Vergrößerungsfaktor der
Bildschirmdarstellung eingestellt werden.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem>Anzeige <accel>a</accel>uffrischen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Hierdurch wird die aktuelle Daten- oder Plotdatei neu
eingelesen und dargestellt.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem><accel>P</accel>eriodisch neu laden</guimenuitem>
</menuchoice></term>
<listitem><para><action>Hier kann periodisches Aktualisieren der Darstellung
von Plot- und Datendateien aktiviert werden.</action> Auch das
Aktualisierungsintervall kann eingestellt werden.</para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="settings-menu">
<title>Das Menü Einstellungen</title>

<para>
<variablelist>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem><accel>W</accel>erkzeugleiste anzeigen
</guimenuitem></menuchoice></term>
<listitem><para><action>Hiermit wird die Anzeige der Werkzeugleiste ein- und
ausgeschaltet.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem><accel>S</accel>tatuszeile anzeigen
</guimenuitem></menuchoice></term>
<listitem><para><action>Hiermit wird die Anzeige der Statuszeile ein- und
ausgeschaltet.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>Funktions<accel>q</accel>uelltext anzeigen
</guimenuitem></menuchoice></term>
<listitem><para><action>Hierdurch kann die Anzeige der Quelltextdateien der
Funktionen in den Dialogen für Funktionsparameter ein- und ausgeschaltet
werden.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>Einfg</keycap></shortcut>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem><accel>D</accel>ateien hinzufügen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Hierdurch kann das Hinzufügen von Plot- und
Datendateien zu existierenden Darstellungen beziehungsweise deren Überschreiben
ein- und ausgeschaltet werden. Die aktuelle Einstellung wird in der Statuszeile
angezeigt.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>PS <accel>B</accel>ounding Box berechnen
</guimenuitem></menuchoice></term>
<listitem><para><action>Hierdurch kann das Berechnen der Bounding Box für
erzeugte PostScript-Dateien ein- und ausgeschaltet werden.</action> Die
Berechnung benötigt <application>GhostScript</application> und geht von einem
für alle Teile des Plots genügend groß eingestelltem
<guilabel>Seitenformat</guilabel> auf der Seite
<link linkend="basic">Grundeinstellungen</link> im Einstellungsdialog von &kpl;
aus. Ohne Berechnung wird die Bounding Box entsprechend diesem Seitenformat
gesetzt.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>Abso<accel>l</accel>ute Pfade speichern
</guimenuitem></menuchoice></term>
<listitem><para><action>Hier kann das Speichern von absoluten Pfaden der Daten-
und Bibliotheksdateien in Plotdateien ein- und ausgeschaltet werden.</action>
Im eingeschalteten Fall werden die Pfade immer absolut gespeichert. Dies ist
die Standardeinstellung, kompatibel zu älteren Versionen von &kpl;. Im
ausgeschalteten Fall werden, wenn möglich, Pfade relativ zur Plotdatei
gespeichert. Diese Einstellung erlaubt das Verschieben von Verzeichniszweigen,
die die Plotdatei und alle von ihr benötigten Dateien
enthalten.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>Warnung bei <accel>u</accel>ngesicherten
Änderungen</guimenuitem></menuchoice></term>
<listitem><para><action>Hierdurch kann die Anzeige der Warnung bei
ungesicherten Änderungen ein- und ausgeschaltet
werden.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem><accel>K</accel>urzbefehle festlegen
</guimenuitem></menuchoice></term>
<listitem><para><action>Öffnet den Dialog </action>
<guilabel>Kurzbefehle festlegen</guilabel>, in dem die Kurzbefehle für die
Aktionen von &kpl; geändert werden können.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>Werk<accel>z</accel>eugleisten einrichten
</guimenuitem></menuchoice></term>
<listitem><para><action>Öffnet den Dialog </action>
<guilabel>Werkzeugleisten einrichten</guilabel>, in dem die in der
Werkzeugleiste verfügbaren Aktionen geändert werden können. </para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem><accel>B</accel>enachrichtigungen festlegen
</guimenuitem></menuchoice></term>
<listitem><para><action>Öffnet das Dialogfenster </action>
<guilabel>Benachrichtigungen festlegen</guilabel>, in dem Benachrichtigungen
über fertiggestellte Plots und Parameteranpassungen festgelegt werden
können.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>E</accel>instellungen</guimenu><guimenuitem>Kpl  ein<accel>r</accel>ichten
</guimenuitem></menuchoice></term>
<listitem><para><action>Öffnet das Dialogfenster </action>
<link linkend="settings">Einrichten</link>. Auf der Seite
<link linkend="basic">Grundeinstellungen</link> können Voreinstellungen für die
Darstellungsgröße und die Farben sowie das Ausgabeformat für Funktionsparameter
in Dateien und Dialogen vorgenommen werden. Auch die Umschalteinstellungen des
Menüs <guilabel>Einstellungen</guilabel> können hier auf ein Mal vorgenommen
werden.</para>
<para>Die Seite <link linkend="autoplot">Autoplot-Einstellungen</link> enthält
die Einstellungen für die automatisch skalierte Darstellung von eingelesenen
2D-Datendateien.</para>
<para>Die Seite <link linkend="autofit">Autofit-Einstellungen</link> enthält
die Einstellungen für die automatische Parameteranpassung von Funktionen an
2D-Datensätze aus Dateien.</para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="help-menu">
<title>Das Menü Hilfe</title>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut><keycap>F1</keycap></shortcut>
<guimenu><accel>H</accel>ilfe</guimenu><guimenuitem>
<accel>H</accel>andbuch zu Kpl</guimenuitem>
</menuchoice></term>
<listitem><para><action>Hier steht die Hilfe für &kpl; zur
Verfügung.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu><guimenuitem>
Probleme oder Wünsche be<accel>r</accel>ichten</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet einen Dialog zum Erstellen eines Problemberichts
an den Autor von &kpl;.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu><guimenuitem>
<accel>S</accel>prache der Anwendung umschalten</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet einen Dialog zur Auswahl der für &kpl; zu
verwendenden Sprache.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu><guimenuitem><accel>Ü</accel>ber Kpl</guimenuitem>
</menuchoice></term>
<listitem><para><action>Zeigt wichtige Informationen zu &kpl; an.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>H</accel>ilfe</guimenu><guimenuitem>Über <accel>K</accel>DE</guimenuitem>
</menuchoice></term>
<listitem><para><action>Zeigt wichtige Informationen zu KDE an.
</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect1>

<sect1 id="context-menu">
<title>Kontextmenüs</title>

<sect2><title>Bestandteil</title>

<para>
Das Anklicken des Bereichs eines Bestandteils in der Darstellung oder in der
Bestandteilliste mit der rechten Maustaste läßt ein Kontextmenü mit zugehörigen
Aktionen (auch im Menü <link linkend="edit-menu">Bearbeiten</link> auswählbar)
erscheinen:</para>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>X</keycap></keycombo></shortcut>
<guimenuitem><accel>A</accel>usschneiden</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verschiebt</action> den Bestandteil von der
Bestandteilliste in die Zwischenablage.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>C</keycap></keycombo></shortcut>
<guimenuitem><accel>K</accel>opieren</guimenuitem>
</menuchoice></term>
<listitem><para><action>Kopiert</action> den Bestandteil in die
Zwischenablage.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>V</keycap></keycombo></shortcut>
<guimenuitem><accel>E</accel>infügen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Fügt</action> in der Zwischenablage gespeicherte
Bestandteile vor dem Bestandteil in die Liste ein.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenuitem><accel>N</accel>euer Bestandteil</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet das Dialogfenster
<link linkend="newitem">Neuer Bestandteil</link></action> zur Auswahl eines
neuen Bestandteils, der vor dem Bestandteil in die Liste eingefügt
wird.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>F2</keycap>
</shortcut>
<guimenuitem><accel>B</accel>earbeiten</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet ein Dialogfenster zum Bearbeiten</action> des
Bestandteils.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>Entf</keycap>
</shortcut>
<guimenuitem><accel>L</accel>öschen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Löscht</action> den  Bestandteil.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenuitem><accel>A</accel>ktiv</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ändert den Aktivierungszustand des Bestandteils.
Aktivierte Bestandteile werden grafisch dargestellt, deaktivierte
versteckt.</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

<sect2><title>Allgemein</title>

<para>
Anklicken der leeren Teile des Datenfensters oder der Bestandteilliste mit
der rechten Maustaste läßt ein Kontextmenü mit den wichtigsten Aktionen
erscheinen:</para>

<para>
<variablelist>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenuitem><accel>N</accel>eu</guimenuitem>
</menuchoice></term>
<listitem><para><action>Erzeugt eine neue Plotdatei.</action>
</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenuitem>Pl<accel>o</accel>tdatei öffnen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet eine oder mehrere existierende
Plotdateien.</action></para>
</listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenuitem>Da<accel>t</accel>endatei öffnen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet eine oder mehrere existierende
Datendateien.</action></para>
</listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenuitem>S<accel>p</accel>eichern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Speichert aktuelle Plotdatei.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenuitem>Speichern <accel>u</accel>nter</guimenuitem>
</menuchoice></term>
<listitem><para><action>Erlaubt das Abspeichern einer Darstellung in einer
neuen Plotdatei.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>P</keycap></keycombo></shortcut>
<guimenuitem><accel>D</accel>rucken</guimenuitem>
</menuchoice></term>
<listitem><para><action>Druckt die Darstellung aus.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guisubmenu>PostScript-<accel>A</accel>usgabe</guisubmenu>
</menuchoice></term>
<listitem><para><action>Speichert die grafische Darstellung als
PostScript-Datei im
</action> <guimenuitem><accel>H</accel>ochformat</guimenuitem> oder im
<guimenuitem><accel>Q</accel>uerformat</guimenuitem>.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Strg</keycap>
<keycap>V</keycap></keycombo></shortcut>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>E</accel>infügen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Fügt</action> in der Zwischenablage gespeicherte
Bestandteile vor dem ausgewähltem Bestandteil der Liste ein, oder, wenn kein
Bestandteil ausgewählt ist, am Ende der Liste an.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>N</accel>euer Bestandteil</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet das Dialogfenster <link linkend="newitem">Neuer
Bestandteil</link></action> zur Auswahl eines neuen Bestandteils, der vor dem
ausgewählten Bestandteil der Liste eingefügt wird, oder, wenn kein Bestandteil
ausgewählt ist, ans Ende der Liste angefügt wird.</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice>
<guimenuitem><accel>B</accel>estandteile</guimenuitem>
</menuchoice></term>
<listitem><para><action>Öffnet das Dockfenster </action>
<link linkend="items">Bestandteile</link> (wenn nicht bereits
geöffnet).</para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Plus</keycap></keycombo></shortcut>
<guimenuitem>Ver<accel>g</accel>rößern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Vergrößert um 20 %.</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Strg</keycap><keycap>Minus</keycap></keycombo></shortcut>
<guimenuitem>Ver<accel>k</accel>leinern</guimenuitem>
</menuchoice></term>
<listitem><para><action>Verkleinert um 20 %.
</action></para></listitem>
</varlistentry>

<varlistentry><term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
<guimenuitem>Anzeige <accel>a</accel>uffrischen</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lädt aktuelle Datei neu und frischt die Anzeige
auf.</action></para></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

</sect1>

<sect1 id="keybindings">
<title>Tastenzuordnungen</title>

<para>
Viele der Tastenzuordnungen können über das Menü
<link linkend="settings-menu">Einstellungen</link> geändert werden.
Standardgemäß sind folgende Zuordnungen eingestellt:</para>

<informaltable pgwide="1"><tgroup cols="2">

<thead>
<row>
<entry>Tastenzuordnung</entry>
<entry>Aktion</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>N</keycap></keycombo></entry>
<entry><action>Erzeugt eine neue Plotdatei.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>O</keycap></keycombo></entry>
<entry><action>Öffnet eine existierende Plotdatei.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>S</keycap></keycombo></entry>
<entry><action>Speichert aktuelle Plotdatei.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>W</keycap></keycombo></entry>
<entry><action>Schließt aktuelle Plotdatei.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>P</keycap></keycombo></entry>
<entry><action>Druckt die Darstellung aus.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Q</keycap></keycombo></entry>
<entry><action>Beendet &kpl;.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Z</keycap></keycombo></entry>
<entry><action>Macht letzte Anderung rückgängig.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Umschalt</keycap>
<keycap>Z</keycap></keycombo></entry>
<entry><action>Stellt Zustand vor Rückgängigmachen wieder her.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>X</keycap></keycombo></entry>
<entry><action>Verschiebt ausgewählte Bestandteile von
der Bestandteilliste in die Zwischenablage.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>C</keycap></keycombo></entry>
<entry><action>Kopiert ausgewählte Bestandteile von
der Bestandteilliste in die Zwischenablage.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>V</keycap></keycombo></entry>
<entry><action>Fügt in der Zwischenablage gespeicherte
Bestandteile vor dem ausgewähltem Bestandteil der Liste ein, oder, wenn kein
Bestandteil ausgewählt ist, am Ende der Liste an.</action></entry>
</row>

<row>
<entry><keycombo><keycap>F2</keycap></keycombo></entry>
<entry><action>Öffnet ein Dialogfenster zum Bearbeiten des
ausgewählten Bestandteils.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Entf</keycap></keycombo></entry>
<entry><action>Löscht ausgewählte  Bestandteile.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Pfeil hoch</keycap></keycombo></entry>
<entry><action>Verschiebt den ausgewählten Bestandteil in der Liste nach oben.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Pfeil runter</keycap></keycombo></entry>
<entry><action>Verschiebt den ausgewählten Bestandteil in der Liste nach unten.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Plus</keycap></keycombo></entry>
<entry><action>Vergrößert um 20 %.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Minus</keycap></keycombo></entry>
<entry><action>Verkleinert um 20 %.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>F5</keycap></keycombo></entry>
<entry><action>Lädt aktuelle Datei neu und frischt die Anzeige auf.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Einfg</keycap></keycombo></entry>
<entry><action>Schaltet das Hinzufügen von Plot- und Datendateien zu
 existierenden Darstellungen beziehungsweise deren Überschreiben ein- und aus.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>F1</keycap></keycombo></entry>
<entry><action>Öffnet das &kpl;-Handbuch.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Pfeil links</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster nach links.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Pfeil rechts</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster nach rechts.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Pfeil unten</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster nach unten.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Pfeil oben</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster nach oben.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Bild auf</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster eine Bildhöhe nach oben.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Bild ab</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster eine Bildhöhe nach unten.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Umschalt</keycap><keycap>Bild auf</keycap>
</keycombo></entry>
<entry><action>Verschiebt Fenster eine Bildbreite nach links.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Umschalt</keycap><keycap>Bild ab</keycap>
</keycombo></entry>
<entry><action>Verschiebt Fenster eine Bildbreite nach rechts.
</action></entry>
</row>

<row>
<entry><keycombo><keycap>Pos 1</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster an unteren Bildrand.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Ende</keycap></keycombo></entry>
<entry><action>Verschiebt Fenster an oberen Bildrand.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Pos 1</keycap>
</keycombo></entry>
<entry><action>Verschiebt Fenster an linken Bildrand.</action></entry>
</row>

<row>
<entry><keycombo><keycap>Strg</keycap><keycap>Ende</keycap>
</keycombo></entry>
<entry><action>Verschiebt Fenster an rechten Bildrand.</action></entry>
</row>

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

<sect1 id="toolbar">
<title>Werkzeugleiste</title>

<para>
Die Werkzeugleiste kann über das Menü
<link linkend="settings-menu">Einstellungen</link> konfiguriert werden.
Standardgemäß enthält sie die folgenden Knöpfe:</para>

<informaltable pgwide="1"><tgroup cols="3">

<thead>
<row>
<entry>Symbol</entry>
<entry>Text</entry>
<entry>Aktion</entry>
</row>
</thead>

<tbody>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-new.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Neu</entry>
<entry><action>Erzeugt eine neue Plotdatei.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-open.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Plotdatei öffnen</entry>
<entry><action>Öffnet eine existierende Plotdatei.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-open.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Datendatei öffnen</entry>
<entry><action>Öffnet eine existierende Datendatei.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-save.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Speichern</entry>
<entry><action>Speichert aktuelle Plotdatei.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-print.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Drucken</entry>
<entry><action>Druckt die Darstellung aus.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="edit-undo.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Rückgängig</entry>
<entry><action>Macht letzte Anderung rückgängig.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="edit-redo.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Wiederherstellen</entry>
<entry><action>Stellt Zustand vor Rückgängigmachen wieder her.
</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="list-add.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Neuer Bestandteil</entry>
<entry><action>Öffnet das Dialogfenster <link linkend="newitem">Neuer
Bestandteil</link></action> zur Auswahl eines neuen Bestandteils.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="document-edit.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Bearbeiten</entry>
<entry><action>Öffnet ein Dialogfenster zum Bearbeiten</action> des
ausgewählten Bestandteils.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="configure.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Anpassen</entry>
<entry><action>Öffnet ein Dialogfenster zur Durchführung von
Parameter- oder Spline-Anpassungen.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="list-remove.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Löschen</entry>
<entry><action>Löscht</action> ausgewählte  Bestandteile.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="go-up.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Nach oben</entry>
<entry><action>Verschiebt den ausgewählten Bestandteil in der Liste nach
oben.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="go-down.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Nach unten</entry>
<entry><action>Verschiebt den ausgewählten Bestandteil in der Liste nach
unten.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="zoom-in.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Vergrößern</entry>
<entry><action>Vergrößert um 20 %.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="zoom-out.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Verkleinern</entry>
<entry><action>Verkleinert um 20 %.</action></entry>
</row>

<row>
<entry><inlinemediaobject><imageobject>
<imagedata fileref="view-refresh.png" format="PNG"/>
</imageobject></inlinemediaobject></entry>
<entry>Anzeige auffrischen</entry>
<entry><action>Lädt aktuelle Datei neu und frischt die Anzeige auf.
</action></entry>
</row>

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

</chapter>

<chapter id="dialogs">
<title>Die Dialoge</title>

<sect1 id="newitem">
<title>Neuer Bestandteil</title>
<anchor id="sec-newitem"/>

<para>
Über die Druckknöpfe <guibutton>Rahmen</guibutton>,
<guibutton>Feld</guibutton>, <guibutton>Funktion</guibutton>,
<guibutton>Parametrische Funktion</guibutton>,
<guibutton>Spline</guibutton>, <guibutton>3D-Feld</guibutton>,
<guibutton>3D-Funktion</guibutton>, <guibutton>Bild</guibutton>,
<guibutton>Legende</guibutton>, <guibutton>Text</guibutton>,
<guibutton>Linie</guibutton>, <guibutton>Pfeil</guibutton>,
<guibutton>Bogen</guibutton>, <guibutton>Rechteck</guibutton>,
<guibutton>Ellipse</guibutton> und <guibutton>Maßstab</guibutton> kann der Typ
des neuen Bestandteils gewählt werden.</para>
<para>
Skalierbare Bestandteile wie Felder und Funktionen übernehmen die
Normierungsfaktoren des letzten vorangehenden, zum gleichen Rahmen gehörenden
Bestandteils.</para>
<para>
Nach Auswahl des Typs wird das entsprechende Dialogfenster für die
Einstellungen des neuen Bestandteils angezeigt.</para>
<para>
Das Dialogfenster kann ohne Auswahl mit dem Druckknopf
<guibutton>Abbrechen</guibutton> verlassen werden.</para>

</sect1>

<sect1 id="frame">
<title>Rahmen</title>
<anchor id="sec-frame"/>

<para>
Hier können die Einstellungen für Rahmen und Beschriftung der Darstellung
vorgenommen werden.</para>
<para>
In der Gruppe <guilabel>Achsenmodus</guilabel> kann gewählt werden, ob die
Darstellung nur einen Rahmen um das Datenfenster oder zusätzlich Tickmarken an
den linken und unteren Seiten des Rahmens oder ein Gitter erhält. Tickmarken
und Gitter können mit Zahlenwerten beschriftet werden.</para>
<para>
In der Gruppe <guilabel>Farben</guilabel> werden die Farben für den Rahmen und
das Gitter bzw. die Tickmarken festgelegt. Die Auswahl erfolgt über das
Dialogfenster <guilabel>Farbe auswählen</guilabel>, das über die farbigen
Drucknöpfe erreicht werden kann.</para>
<para>
Über die Gruppe <guilabel>Automatik</guilabel> kann die Skalierung der
Darstellung bequem automatisch durch Betätigen des Druckknopfs
<guibutton>Autoskalierung</guibutton> erfolgen, wenn bereits in weiteren
Bestandteilen der Darstellung Datensätze oder Funktionen festgelegt sind. Bei
aktiviertem Auswahlfeld <guilabel>Normierung</guilabel> werden dabei außerdem
automatisch Zehnerpotenzen bestimmt, mit denen sehr große oder sehr kleine
Zahlenwerte in der Darstellung multipliziert erscheinen. Diese
Normierungsfaktoren werden, wenn sie verschieden von 1 sind, in die
Beschriftung der Achsen übernommen.</para>
<para>
In der Gruppe <guilabel>Fenster</guilabel> können Lage und Größe des
Datenfensters festgelegt werden.</para>
<para>
In der Gruppe <guilabel>Skalierung</guilabel> kann die Darstellung durch Angabe
der Datenkoordinaten für die linke untere und die rechte obere Ecke des
Datenfensters skaliert werden. Die Einstellungen können auch über den
Druckknopf <guibutton>Autoskalierung</guibutton> automatisch vorgenommen
werden. Die Skalierung kann individuell für die Achsen durch Auswahl von
<guilabel>log</guilabel> auf logarithmisch gesetzt werden.</para>
<para>
In der Gruppe <guilabel>Achsen</guilabel> können die Abstände
<guilabel>xtic</guilabel> und <guilabel>ytic</guilabel> von Tickmarken bzw.
Gitterlinien festgelegt werden. Mit <guilabel>xoff</guilabel> und
<guilabel>yoff</guilabel> können Abstände zwischen den ersten beschrifteten
Ticks und dem jeweiligen Skalenanfang eingestellt werden. Bei der Wahl von
Achsen mit Ticks können zwischen den großen gegebenenfalls beschrifteten Ticks
kleine Ticks gezeichnet werden. Die Zahl der Intervalle, in die der Abstand
zwischen zwei großen Ticks unterteilt wird, können über
<guilabel>mticx</guilabel> und <guilabel>mticy</guilabel> eingestellt werden.
Bei Wahl von beschrifteten Achsenmodi kann die Zahl der Nachkommastellen über
<guilabel>ndigx</guilabel> und <guilabel>ndigy</guilabel> eingestellt werden.
Werte von -1 führen dabei zur Unterdrückung der Dezimalpunktausgabe. Die
Einstellungen können auch über den Druckknopf
<guibutton>Autoskalierung</guibutton> automatisch vorgenommen werden, wenn
bereits in weiteren Bestandteilen der Darstellung Datensätze oder Funktionen
festgelegt sind.</para>
<para>
Im Falle logarithmischer Skalierung haben die Einstellungen eine teilweise
andere Bedeutung. <guilabel>ndigx</guilabel> und <guilabel>ndigy</guilabel>
können nicht eingestellt werden; die Zahl der Nachkommastellen wird
automatisch bestimmt. Die Werte von <guilabel>xtic</guilabel> und
<guilabel>ytic</guilabel> geben die Faktoren zwischen erstem und zweitem großen
Tick vor und werden auf 2, 5 oder 10 gerundet. Immer zehn kleine Ticks pro
Dekade werden gezeichnet, wenn <guilabel>mticx</guilabel> bzw.
<guilabel>mticy</guilabel> auf größer als 1 gestellt sind. Im Unterschied zu
linearer Skalierung werden diese als Gitterlinien gezeichnet, wenn ein
Gitterachsenmodus ausgewählt ist. Die Autonormierungsoption bei Autoskalierung
wird im Fall logarithmischer Skalierung ausgeschaltet.</para>
<para>
In der Gruppe <guilabel>Beschriftung</guilabel> kann Text für die
Achsenbeschriftungen und eine Kopfzeile festgelegt werden. Text mit
Sonderzeichen gibt man am bequemsten über das Dialogfenster
<link linkend="edit-text">Text editieren</link> ein, das über die Drucknöpfe
rechts neben den Eingabefeldern erreicht werden kann. Eine Einstellung von
Zehnerexponenten für die gegebenfalls in die Beschriftung eingefügten
Normierungsfaktoren kann mit <guilabel>iex</guilabel> und
<guilabel>iey</guilabel> hier auch manuell erfolgen. Die Platzierung der
x-Achsenbeschriftung kann durch Auswahl von <guilabel>Unten</guilabel> und
<guilabel>Oben</guilabel> eingestellt werden, die der y-Achsenbeschriftung
durch Auswahl von <guilabel>Links</guilabel> und
<guilabel>Rechts</guilabel>.</para>
<para>
Im Feld <guilabel>Symbolgröße</guilabel> kann die relative Größe von
Zeichensätzen und Plotsymbolen sowie die relative Breite von Linien (bezogen
auf die Breite des Datenfensters) festgelegt werden. Die Einstellung von
100&nbsp;% entspricht dabei dem Normalwert. Zusätzlich kann in den
Einstellungsdialogen der entsprechenden Bestandteile noch ein individueller
Größenfaktor eingestellt werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>
<para>
</para>

</sect1>

<sect1 id="array">
<title>Feld</title>
<anchor id="sec-array"/>

<para>
Im Dialogfenster <guilabel>Feld</guilabel> können die Einstellungen für den
Datensatz aus einer Datendatei vorgenommen werden.</para>
<para>
Der Druckknopf <guibutton>...</guibutton> öffnet einen Dialog zur Auswahl einer
Datendatei. Das Dezimalsymbol zum Lesen der Datei kann in diesem Dialog
ausgewählt werden. Der Pfad der Datei wird im Feld
<guibutton>Datei</guibutton> links neben dem Druckknopf angezeigt. Der Knopf
mit dem Symbol für Auffrischen kann zum erneuten Laden einer Datendatei nach
einer Änderung ihres Inhalts benutzt werden. Die Auswahl einer Datei führt zur
automatischen Bestimmung geeigneter Werte für die nachstehend beschriebenen
Einstellungen.</para>
<para>
Durch Auswahl von <guilabel>Interne Daten</guilabel> können die Daten innerhalb
der Plotdatei gespeichert werden. Aus Effektivitätsgründen sollte dies nicht
mit zu großen Datensätzen geschehen. Nur die zur Anzeige eingestellten Spalten
werden abgespeichert. Interne Daten können über
<guibutton>Bearbeiten</guibutton> eingegeben und verändert werden. Bei Abwahl
von <guilabel>Interne Daten</guilabel> wird ein Dateiauswahldialog geöffnet,
über den eine separate Datendatei zum (Re)exportieren ausgewählt werden
kann.</para>
<para>
In <guilabel>x-Spalte</guilabel> und <guilabel>y-Spalte</guilabel> können die
Spalten für Abszissen- und Ordinatenwerte ausgewählt werden. 0 entspricht dabei
der ersten Spalte.</para>
<para>
Bei aktiviertem Auswahlfeld <guilabel>Fehlerbalken</guilabel> wird die als
<guilabel>Fehlerspalte</guilabel> angegebene Spalte zur Darstellung von
Fehlerbalken herangezogen. Diese Spalte wird gegebenenfalls auch bei
Parameteranpassungen von Funktionen an die Datensätze zur Gewichtung der Daten
herangezogen.</para>
<para>
Als <guilabel>Startindex</guilabel> wird der Zeilenindex für den ersten
darzustellenden Datenpunkt angegeben. 0 entspricht dabei der ersten Zeile in
der Datendatei (Kommentarzeilen werden nicht gezählt). Zusammen mit der
<guilabel>Anzahl Punkte</guilabel> wird die darzustellende Portion der Datei
ausgewählt.</para>
<para>
Die x- und y-Werte können in der Darstellung durch Eingabe von Werten für
<guilabel>x-Verschiebung</guilabel> und <guilabel>y-Verschiebung</guilabel>
verschoben werden.</para>
<para>
Es können manuell Faktoren für <guilabel>x-Normierung</guilabel> und
<guilabel>y-Normierung</guilabel> angegeben werden. Diese können auch über das
Dialogfenster <link linkend="frame">Rahmen</link> mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden.</para>
<para>
Zur Darstellung der Daten können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt.</para>
<para>
Die <guilabel>Größe</guilabel> der Linien bzw. Symbole kann als zusätzlicher
individueller Faktor zu der globalen Einstellung des zugehörigen
Rahmenbestandteils festgelegt werden.</para>
<para>
Die <guilabel>Farbe</guilabel> der Linien bzw. Symbole wird über das
Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das über den
farbigen Druckknopf geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch Linien oder Symbole, das durch die Punkte des Feldes gegebene
Polygon vollständig mit einer Farbe oder mit einer Schraffur gefüllt
werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="func">
<title>Funktion</title>
<anchor id="sec-func"/>

<para>
Im Dialogfenster <guilabel>Funktion</guilabel> können die Einstellungen für
Funktionsplots vorgenommen werden.</para>
<para>
In der Gruppe <guilabel>y(x)</guilabel> kann unter
<guilabel>Bibliothek</guilabel> der Pfad der
<foreignphrase lang="en">shared library</foreignphrase> eingetragen werden, die
die gewünschte Funktion enthält. Der Druckknopf rechts neben dem Eingabefeld
öffnet dazu einen Dateiauswahldialog.</para>
<para>
Der Name der <guilabel>Funktion</guilabel> kann in einem weiteren Feld
angegeben werden. Befindet sich im gleichen Verzeichnis wie die
<foreignphrase lang="en">shared library</foreignphrase> auch eine
Moduldefinitionsdatei gleichen Namens mit der Dateierweiterung
<literal role="extension">.def</literal>, so kann über den Druckknopf rechts
neben dem Eingabefeld das Dialogfenster <guilabel>Funktionen</guilabel>
geöffnet werden, in dem die Funktion aus einer Liste ausgewählt werden
kann.</para>
<para>
Über den Druckknopf <guibutton>Bearbeiten</guibutton> kann das Dialogfenster
<guilabel>Parameter</guilabel> geöffnet werden, in dem Zahlenwerte für maximal
20 Parameter der Funktion eingegeben werden können. Bei aktivierter Einstellung
<guimenuitem>Funktionsquelltext anzeigen</guimenuitem> im Menü
<link linkend="settings-menu">Einstellungen</link> und Vorhandensein einer C-
bzw. C++-Quelltextdatei gleichen Namens wie die
<foreignphrase lang="en">shared library</foreignphrase> und der
Dateierweiterung <literal role="extension">.c</literal> bzw.
<literal role="extension">.cpp</literal> im gleichen Verzeichnis wird deren
Inhalt rechts neben den Parametern angezeigt. Über den Druckknopf
<guibutton>Laden</guibutton> kann ein Dateiauswahlfenster geöffnet werden, mit
dem die Parameter aus einer Textdatei (pro Zeile ein Parameter) eingelesen
werden können. Über den Druckknopf <guibutton>Speichern</guibutton> kann ein
Dateiauswahlfenster geöffnet werden, mit dem die Parameter in einer Textdatei
gespeichert werden können.</para>
<para>
In den Feldern <guilabel>xmin</guilabel> und <guilabel>xmax</guilabel> können
die Grenzen für das Funktionsargument eingegeben werden. Das Feld
<guilabel>&Delta;x</guilabel> legt die Schrittweite für das Funktionsargument
fest. Ein Wert von Null führt dabei zur automatischen Teilung des Bereichs von
xmin bis xmax in 100 Intervalle.</para>
<para>
Die x- und y-Werte können in der Darstellung durch Eingabe von Werten für
<guilabel>x-Verschiebung</guilabel> und <guilabel>y-Verschiebung</guilabel>
verschoben werden.</para>
<para>
Es können manuell Faktoren für <guilabel>x-Normierung</guilabel> und
<guilabel>y-Normierung</guilabel> angegeben werden. Diese können auch über das
<link linkend="frame">Rahmen</link> mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden.</para>
<para>
Zur Darstellung der Funktion können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt.</para>
<para>
Die <guilabel>Größe</guilabel> der Linien bzw. Symbole kann als zusätzlicher
individueller Faktor zu der globalen Einstellung des zugehörigen
Rahmenbestandteils festgelegt werden.</para>
<para>
Die <guilabel>Farbe</guilabel> der Linien bzw. Symbole wird über das
Dialogfenster Farbauswahl eingestellt, das über den farbigen Druckknopf
geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch Linien oder Symbole, das durch die Punkte der Funktion
gegebene Polygon vollständig mit einer Farbe oder mit einer Schraffur gefüllt
werden.</para>
<para>
Der Dialog <link linkend="roots">Wurzeln</link> zum Auffinden von Nullstellen
der Funktion oder ihrer Ableitungen kann über den Druckknopf
<guibutton>Wurzeln</guibutton> geöffnet werden.</para>
<para>
Eine Wertetabelle der Funktion kann über den Druckknopf
<guibutton>Exportieren</guibutton> als Datendatei exportiert werden. Dazu wird
ein Dateiauswahldialog geöffnet.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="parfunc">
<title>Parametrische Funktion</title>
<anchor id="sec-parfunc"/>

<para>
Im Dialogfenster <guilabel>Parametrische Funktion</guilabel> können die
Einstellungen für Plots parametrischer Funktionen vorgenommen
werden.</para>
<para>
In den Gruppen <guilabel>x(t)</guilabel> und <guilabel>y(t)</guilabel>
können auf gleiche Weise die Funktionseinstellungen für die Abszissen- bzw.
Ordinatenfunktion vorgenommen werden.</para>
<para>
Unter <guilabel>Bibliothek</guilabel> können die Pfade der
<foreignphrase lang="en">shared libraries</foreignphrase> eingetragen werden,
die die gewünschten Funktion enthalten. Die Druckknöpfe rechts neben den
Eingabefeldern öffnen dazu einen Dateiauswahldialog.</para>
<para>
Die Namen der jeweiligen <guilabel>Funktion</guilabel> für x(t) bzw. y(t)
können in weiteren Feldern angegeben werden. Befindet sich im gleichen
Verzeichnis wie die zugehörige
<foreignphrase lang="en">shared library</foreignphrase> auch eine
Moduldefinitionsdatei gleichen Namens mit der Dateierweiterung
<literal role="extension">.def</literal>, so kann über die Druckknöpfe rechts
neben den Eingabefeldern das Dialogfenster <guilabel>Funktionen</guilabel>
geöffnet werden, in dem die jeweilige Funktion aus einer Liste ausgewählt
werden kann.</para>
<para>
Über die Druckknöpfe <guibutton>Bearbeiten</guibutton> kann das Dialogfenster
<guilabel>Parameter</guilabel> geöffnet werden, in dem Zahlenwerte für maximal
20 Parameter der jeweiligen Funktion eingegeben werden können. Bei aktivierter
Einstellung <guimenuitem>Funktionsquelltext anzeigen</guimenuitem> im Menü
Einstellungen und Vorhandensein einer C- bzw. C++-Quelltextdatei gleichen
Namens wie die <foreignphrase lang="en">shared library</foreignphrase> und der
Dateierweiterung <literal role="extension">.c</literal> bzw.
<literal role="extension">.cpp</literal> im gleichen Verzeichnis wird deren
Inhalt rechts neben den Parametern angezeigt. Über die Druckknöpfe
<guibutton>Laden</guibutton> kann ein Dateiauswahlfenster geöffnet werden, mit
dem die Parameter aus einer Textdatei (pro Zeile ein Parameter) eingelesen
werden können. Über die Druckknöpfe <guibutton>Speichern</guibutton> kann ein
Dateiauswahlfenster geöffnet werden, mit dem die Parameter in einer Textdatei
gespeichert werden können.</para>
<para>
In den Feldern <guilabel>tmin</guilabel> und <guilabel>tmax</guilabel> können
die Grenzen für das gemeinsame Funktionsargument t eingegeben werden. Das Feld
<guilabel>&Delta;t</guilabel> legt die Schrittweite für das Funktionsargument
fest. Ein Wert von Null führt dabei zur automatischen Teilung des Bereichs von
tmin bis tmax in 100 Intervalle.</para>
<para>
Die x- und y-Werte können in der Darstellung durch Eingabe von Werten für
<guilabel>x-Verschiebung</guilabel> und <guilabel>y-Verschiebung</guilabel>
verschoben werden.</para>
<para>
Es können manuell Faktoren für <guilabel>x-Normierung</guilabel> und
<guilabel>y-Normierung</guilabel> angegeben werden. Diese können auch über das
Dialogfenster <link linkend="frame">Rahmen</link> mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden.</para>
<para>
Zur Darstellung der Funktionen können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt.</para>
<para>
Die <guilabel>Größe</guilabel> der Linien bzw. Symbole kann als zusätzlicher
individueller Faktor zu der globalen Einstellung des zugehörigen
Rahmenbestandteils festgelegt werden.</para>
<para>
Die <guilabel>Farbe</guilabel> der Linien bzw. Symbole wird über das
Dialogfenster Farbauswahl eingestellt, das über den farbigen Druckknopf
geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch Linien oder Symbole, das durch die Punkte der Funktion
gegebene Polygon vollständig mit einer Farbe oder mit einer Schraffur gefüllt
werden.</para>
<para>
Eine Wertetabelle der Funktionen kann über den Druckknopf
<guibutton>Exportieren</guibutton> als Datendatei exportiert werden. Dazu wird
ein Dateiauswahldialog geöffnet.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="spline">
<title>Glättender Spline</title>
<anchor id="sec-spline"/>

<para>
Im Dialogfenster <guilabel>Glättender Spline</guilabel> können die
Einstellungen für Plots von glättenden Spline-Funktionen vorgenommen werden.
Die Festlegung des Grades des Splines und die Berechnung seiner Koeffizienten
entsprechend einer Anpassung an einen Datensatz eines Felds erfolgt über den
Dialog <link linkend="spline-fit">Glättende Spline-Anpassung</link>, der über
<guilabel>Anpassen</guilabel> aus dem Menü
<link linkend="edit-menu">Bearbeiten</link> aus zu erreichen ist.</para>
<para>
In der Gruppe <guilabel>Ausgabe</guilabel> kann über eine  Kombobox ausgewählt
werden, ob die Spline-Funktion selbst, eine ihrer Ableitungen oder ihr Integral
dargestellt werden soll. Im Fall eines Integrals kann zusätzlich eine
<guilabel>Untergrenze</guilabel>, d. h. der x-Wert, bei dem das Integral den
Wert Null annimmt, angegeben werden.</para>
<para>
In den Feldern <guilabel>xmin</guilabel> und <guilabel>xmax</guilabel>
können die Grenzen für das Funktionsargument eingegeben werden. Das Feld
<guilabel>&Delta;x</guilabel> legt die Schrittweite für das Funktionsargument
fest. Ein Wert von Null führt dabei zur automatischen Teilung des Bereichs von
xmin bis xmax in 100 Intervalle.</para>
<para>
Die x- und y-Werte können in der Darstellung durch Eingabe von Werten für
<guilabel>x-Verschiebung</guilabel> und <guilabel>y-Verschiebung</guilabel>
verschoben werden.</para>
<para>
Es können manuell Faktoren für <guilabel>x-Normierung</guilabel> und
<guilabel>y-Normierung</guilabel> angegeben werden. Diese können auch über das
Dialogfenster <link linkend="frame">Rahmen</link> mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden.</para>
<para>
Zur Darstellung der Funktion können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt.</para>
<para>
Die <guilabel>Größe</guilabel> der Linien bzw. Symbole kann als zusätzlicher
individueller Faktor zu der globalen Einstellung des zugehörigen
Rahmenbestandteils festgelegt werden.</para>
<para>
Die <guilabel>Farbe</guilabel> der Linien bzw. Symbole wird über das
Dialogfenster Farbauswahl eingestellt, das über den farbigen Druckknopf
geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch Linien oder Symbole, das durch die Punkte der Spline-Funktion
gegebene Polygon vollständig mit einer Farbe oder mit einer Schraffur gefüllt
werden.</para>
<para>
Der Dialog <link linkend="roots">Wurzeln</link> zum Auffinden von Nullstellen
eines kubischen Splines oder seiner Ableitungen kann über den Druckknopf
<guibutton>Wurzeln</guibutton> geöffnet werden.</para>
<para>
Eine Tabelle der dargestellten Werte kann über den Druckknopf
<guibutton>Exportieren</guibutton> als Datendatei exportiert werden. Dazu wird
ein Dateiauswahldialog geöffnet.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="array3d">
<title>3D-Feld</title>
<anchor id="sec-array3d"/>

<para>
Im Dialogfenster <guilabel>3D-Feld</guilabel> können die Einstellungen für die
dreidimensionale Darstellung eines Datensatzes aus einer Datei vorgenommen
werden. Die Daten werden als eine über glättende Spline-Interpolation
beschriebene Fläche y(x,z) repräsentiert. Der Dialog ist auf drei Seiten
aufgeteilt.</para>

<sect2 id="array3d-p1">
<title>Feld</title>

<para>
Auf der Seite <guilabel>Feld</guilabel> kann in der Gruppe
<guilabel>Daten</guilabel> über den Auswahlknopf <guilabel>...</guilabel> ein
Dialog zur Auswahl einer Datendatei geöffnet werden. Das Dezimalsymbol zum
Lesen der Datei kann in diesem Dialog ausgewählt werden. Der aktuelle Pfad wird
links daneben angezeigt. Der Knopf an der rechten Seite kann zum erneuten Laden
einer Datendatei nach einer Änderung ihres Inhalts benutzt werden.</para>
<para>
Durch Auswahl von <guilabel>Interne Daten</guilabel> können die Daten innerhalb
der Plotdatei gespeichert werden. Aus Effektivitätsgründen sollte dies nicht
mit zu großen Datensätzen geschehen. Nur die zur Anzeige eingestellten Spalten
werden abgespeichert. Interne Daten können über
<guibutton>Bearbeiten</guibutton> eingegeben und verändert werden. Bei Abwahl
von <guilabel>Interne Daten</guilabel> wird ein Dateiauswahldialog geöffnet,
über den eine separate Datendatei zum (Re)exportieren ausgewählt werden
kann.</para>
<para>
In <guilabel>x-Spalte</guilabel>, <guilabel>y-Spalte</guilabel> und
<guilabel>z-Spalte</guilabel> können die Spalten für die Koordinaten der
dreidimensionalen Darstellung ausgewählt werden. 0 entspricht dabei der ersten
Spalte der Datei. Die Daten werden als Fläche y(x,z) dargestellt. Bei
aktiviertem Auswahlfeld <guilabel>Fehlerbalken</guilabel> wird die als
<guilabel>Fehlerspalte</guilabel> angegebene Spalte als Standardabweichung der
y-Werte zur Gewichtung bei der glättenden Spline-Interpolation herangezogen.
Der <guilabel>Glättungsfaktor</guilabel> beeinflusst die mittlere Abweichung
der Spline-Funktion von den y-Werten des Datensatzes und gibt in diesem Fall
den Faktor an, um den sich im Mittel die Abweichungen vom Fehler der Daten
unterscheiden sollen. Ein Wert von 0 führt zu einem nichtglättenden Spline. In
diesem Fall müssen die x- und z-Koordinaten des Datensatzes auf Gitterplätze
fallen; im Fall eines glättenden Splines können die Koordinaten frei in der
x,z-Ebene plaziert sein. Ist das Feld <guilabel>Fehlerbalken</guilabel> nicht
aktiviert, wird der Wert des Glättungsfaktors direkt als konstante
Standardabweichung der y-Werte herangezogen.</para>
<para>
Als <guilabel>Startindex</guilabel> wird der Zeilenindex für den ersten der zur
Berechnung der Fläche y(x,z) herangezogenen Datenpunkte angegeben. 0 entspricht
dabei der ersten Zeile in der Datendatei (Kommentarzeilen werden nicht
gezählt). Zusammen mit der <guilabel>Anzahl Punkte</guilabel> wird die zur
Berechnung der Fläche genutzte Portion der Datei ausgewählt. Mit
<guilabel>xmin</guilabel>, <guilabel>xmax</guilabel>,
<guilabel>zmin</guilabel> und <guilabel>zmax</guilabel> werden die Grenzen für
den dargestellten Bereich der Fläche y(x,z) und die x- und z-Achse festgelegt.
Die Schrittweiten <guilabel>&Delta;x</guilabel> und
<guilabel>&Delta;z</guilabel> bestimmen die Abstände des Liniennetzes der
Flächendarstellung. Werte von 0 führen dabei zur automatischen Teilung des
jeweiligen Bereichs in 40 Intervalle. Mit <guilabel>ymin</guilabel> und
<guilabel>ymax</guilabel> werden die Grenzen der y-Achse festgelegt. Die
Skalierung jeder Achse kann individuell durch Auswahl von
<guilabel>log</guilabel> auf logarithmisch eingestellt werden.</para>

</sect2>

<sect2 id="array3d-p2">
<title>Skalierung</title>

<para>
Auf der Seite <guilabel>Skalierung</guilabel> kann in der Gruppe
<guilabel>Fenster</guilabel> der rechteckige Bereich in cm eingestellt werden,
in dem die 3D-Darstellung angezeigt wird und um den gegebenfalls ein Rahmen
gezeichnet wird.</para>
<para>
In der Gruppe <guilabel>Bezugspunkt</guilabel> können die Abstände des
Mittelpunkts der von x- und z-Achse bei ymin aufgespannten Fläche vom linken
und unteren Rand des Fensters in cm angegeben werden.</para>
<para>
In der Gruppe <guilabel>3D-Box</guilabel> können die Längen der x-, y- und
z-Achse der 3D-Darstellung in cm angegeben werden.</para>
<para>
Die <guilabel>Drehung</guilabel> des Koordinatensystems kann über die zwei
Winkel <guilabel>phi</guilabel> und <guilabel>theta</guilabel> angegeben
werden. Der Wert von <guilabel>phi</guilabel> gibt dabei die Drehung um die
y-Achse an; der Wert von <guilabel>theta</guilabel> die Neigung der y-Achse
nach vorne.</para>
<para>
In der Gruppe <guilabel>Achsen</guilabel> können mit <guilabel>xtic</guilabel>,
<guilabel>ytic</guilabel> und <guilabel>ztic</guilabel> die Abstände von großen
(gegebenfalls beschrifteten) Tickmarken eingestellt werden. Die Zahl der
Intervalle, in die diese Abstände durch kleine Tickmarken unterteilt werden,
wird über <guilabel>mticx</guilabel>, <guilabel>mticy</guilabel> und
<guilabel>mticz</guilabel> festgelegt. Bei beschrifteten Achsen kann die Zahl
der Nachkommastellen über <guilabel>ndigx</guilabel>,
<guilabel>ndigy</guilabel> und <guilabel>ndigz</guilabel> eingestellt werden.
Werte von -1 führen dabei zur Unterdrückung der Dezimalpunktausgabe.</para>
<para>
Es können manuell Faktoren für <guilabel>Normierung</guilabel> der x-, y- und
z-Achse angegeben werden. Diese können auch mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden. Die
Autoskalierung bestimmt weiterhin für den duch <guilabel>Startindex</guilabel>
und <guilabel>Anzahl Punkte</guilabel> ausgewählten Bereich des Datensatzes die
Grenzen der Achsen, die Abstände der großen Tickmarken, die Zahl der Intervalle
zwischen den großen Tickmarken, die Zahl der Nachkommastellen der Beschriftung,
den <guilabel>Bezugspunkt</guilabel> der 3D-Darstellung und die Länge der
Achsen.</para>

</sect2>

<sect2 id="array3d-p3">
<title>Darstellung</title>

<para>
Auf der Seite <guilabel>Darstellung</guilabel> kann in der Gruppe
<guilabel>Achsenmodus</guilabel> eingestellt werden, ob Tickmarken mit oder
ohne Beschriftung gezeichnet werden.</para>
<para>
In der Gruppe <guilabel>3D-Modus</guilabel> kann festgelegt werden, ob die
Darstellung der Fläche y(x,z) als Linien in x- oder z-Richtung oder als Netz
von Linien in x- und z-Richtung erfolgt.</para>
<para>
In der Gruppe <guilabel>Farben</guilabel> werden die Farben für Rahmen,
Tickmarken und die die Daten darstellende Fläche festgelegt. Die Auswahl
erfolgt über das Dialogfenster Farbauswahl, das über die farbigen Drucknöpfe
erreicht werden kann.</para>
<para>
Über <guilabel>Zeige Rahmen</guilabel> kann die Anzeige eines Rahmens um den
rechteckigen Fensterbereich des Plots eingestellt werden. Die relative
<guilabel>Linienbreite</guilabel> der Netzlinien der Fläche y(x,z) kann bezogen
auf die Breite des Datenfensters festgelegt werden. Die Einstellung von
100&nbsp;% entspricht dabei dem Normalwert.</para>
<para>
Eine Tabelle der Werte der dargestellten Fläche kann über den Druckknopf
<guibutton>Exportieren</guibutton> als Datendatei exportiert werden. Dazu wird
ein Dateiauswahldialog geöffnet.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect2>

</sect1>

<sect1 id="func3d">
<title>3D-Funktion</title>
<anchor id="sec-func3d"/>

<para>
Im Dialogfenster <guilabel>3D-Funktion</guilabel> können die Einstellungen für
die dreidimensionale Darstellung einer Funktion y(x,z) zweier unabhängiger
Variablen vorgenommen werden. Der Dialog ist auf drei Seiten aufgeteilt.</para>

<sect2 id="func3d-p1">
<title>Funktion</title>

<para>
Auf der Seite <guilabel>Funktion</guilabel> kann in der Gruppe
<guilabel>y(x,z)</guilabel> unter <guilabel>Bibliothek</guilabel> der Pfad der
<foreignphrase lang="en">shared library</foreignphrase> eingetragen werden, die
die gewünschte Funktion enthält. Der Druckknopf rechts neben dem Eingabefeld
öffnet dazu einen Dateiauswahldialog.</para>
<para>
Der Name der <guilabel>Funktion</guilabel> kann in einem weiteren Feld
angegeben werden. Befindet sich im gleichen Verzeichnis wie die
<foreignphrase lang="en">shared library</foreignphrase> auch eine
Moduldefinitionsdatei gleichen Namens mit der Dateierweiterung
<literal role="extension">.def</literal>, so kann über den Druckknopf rechts
neben dem Eingabefeld das Dialogfenster <guilabel>Funktionen</guilabel>
geöffnet werden, in dem die Funktion aus einer Liste ausgewählt werden
kann.</para>
<para>
Über den Druckknopf <guibutton>Bearbeiten</guibutton> kann das Dialogfenster
<guilabel>Parameter</guilabel> geöffnet werden, in dem Zahlenwerte für maximal
20 Parameter der Funktion eingegeben werden können. Bei aktivierter Einstellung
<guimenuitem>Funktionsquelltext anzeigen</guimenuitem> im Menü
<link linkend="settings-menu">Einstellungen</link> und Vorhandensein einer C-
bzw. C++-Quelltextdatei gleichen Namens wie die
<foreignphrase lang="en">shared library</foreignphrase> und der
Dateierweiterung <literal role="extension">.c</literal> bzw.
<literal role="extension">.cpp</literal> im gleichen Verzeichnis wird deren
Inhalt rechts neben den Parametern angezeigt. Über den Druckknopf
<guibutton>Laden</guibutton> kann ein Dateiauswahlfenster geöffnet werden, mit
dem die Parameter aus einer Textdatei (pro Zeile ein Parameter) eingelesen
werden können. Über den Druckknopf <guibutton>Speichern</guibutton> kann ein
Dateiauswahlfenster geöffnet werden, mit dem die Parameter in einer Textdatei
gespeichert werden können.</para>
<para>
In der Gruppe <guilabel>Bereich</guilabel> können in den Feldern
<guilabel>xmin</guilabel>, <guilabel>xmax</guilabel>, <guilabel>zmin</guilabel>
und <guilabel>zmax</guilabel> die Grenzen für die Funktionsargumente und die x-
und z-Achse eingegeben werden. Die Felder <guilabel>&Delta;x</guilabel> und
<guilabel>&Delta;z</guilabel> legen die Schrittweite für die Funktionsargumente
fest. Ein Wert von Null führt dabei zur automatischen Teilung des jeweiligen
Bereichs in 40 Intervalle. Mit <guilabel>ymin</guilabel> und
<guilabel>ymax</guilabel> werden die Grenzen der y-Achse festgelegt. Die
Skalierung jeder Achse kann individuell durch Auswahl von
<guilabel>log</guilabel> auf logarithmisch eingestellt werden.</para>

</sect2>

<sect2 id="func3d-p2">
<title>Skalierung</title>

<para>
Auf der Seite <guilabel>Skalierung</guilabel> kann in der Gruppe
<guilabel>Fenster</guilabel> der rechteckige Bereich in cm eingestellt werden,
in dem die 3D-Darstellung angezeigt wird und um den gegebenfalls ein Rahmen
gezeichnet wird.</para>
<para>
In der Gruppe <guilabel>Bezugspunkt</guilabel> können die Abstände des
Mittelpunkts der von x- und z-Achse bei ymin aufgespannten Fläche vom linken
und unteren Rand des Fensters in cm angegeben werden.</para>
<para>
In der Gruppe <guilabel>3D-Box</guilabel> können die Längen der x-, y- und
z-Achse der 3D-Darstellung in cm angegeben werden.</para>
<para>
Die <guilabel>Drehung</guilabel> des Koordinatensystems kann über die zwei
Winkel <guilabel>phi</guilabel> und <guilabel>theta</guilabel> angegeben
werden. Der Wert von <guilabel>phi</guilabel> gibt dabei die Drehung um die
y-Achse an; der Wert von <guilabel>theta</guilabel> die Neigung der y-Achse
nach vorne.</para>
<para>
In der Gruppe <guilabel>Achsen</guilabel> können mit <guilabel>xtic</guilabel>,
<guilabel>ytic</guilabel> und <guilabel>ztic</guilabel> die Abstände von großen
(gegebenfalls beschrifteten) Tickmarken eingestellt werden. Die Zahl der
Intervalle, in die diese Abstände durch kleine Tickmarken unterteilt werden,
wird über <guilabel>mticx</guilabel>, <guilabel>mticy</guilabel> und
<guilabel>mticz</guilabel> festgelegt. Bei beschrifteten Achsen kann die Zahl
der Nachkommastellen über <guilabel>ndigx</guilabel>,
<guilabel>ndigy</guilabel> und <guilabel>ndigz</guilabel> eingestellt werden.
Werte von -1 führen dabei zur Unterdrückung der Dezimalpunktausgabe.</para>
<para>
Es können manuell Faktoren für <guilabel>Normierung</guilabel> der x-, y- und
z-Achse angegeben werden. Diese können auch mittels
<guibutton>Autoskalierung</guibutton> bei aktivierter
<guilabel>Autonormierung</guilabel> automatisch bestimmt werden. Die
Autoskalierung bestimmt weiterhin für den duch <guilabel>Startindex</guilabel>
und <guilabel>Anzahl Punkte</guilabel> ausgewählten Bereich des Datensatzes die
Grenzen der Achsen, die Abstände der großen Tickmarken, die Zahl der Intervalle
zwischen den großen Tickmarken, die Zahl der Nachkommastellen der Beschriftung,
den <guilabel>Bezugspunkt</guilabel> der 3D-Darstellung und die Länge der
Achsen.</para>

</sect2>

<sect2 id="func3d-p3">
<title>Darstellung</title>

<para>
Auf der Seite <guilabel>Darstellung</guilabel> kann in der Gruppe
<guilabel>Achsenmodus</guilabel> eingestellt werden, ob Tickmarken mit oder
ohne Beschriftung gezeichnet werden.</para>
<para>
In der Gruppe <guilabel>3D-Modus</guilabel> kann festgelegt werden, ob die
Darstellung der Fläche y(x,z) als Linien in x- oder z-Richtung oder als Netz
von Linien in x- und z-Richtung erfolgt.</para>
<para>
In der Gruppe <guilabel>Farben</guilabel> werden die Farben für Rahmen,
Tickmarken und die die Daten darstellende Fläche festgelegt. Die Auswahl
erfolgt über das Dialogfenster Farbauswahl, das über die farbigen Drucknöpfe
erreicht werden kann.</para>
<para>
Über <guilabel>Zeige Rahmen</guilabel> kann die Anzeige eines Rahmens um den
rechteckigen Fensterbereich des Plots eingestellt werden. Die relative
<guilabel>Linienbreite</guilabel> der Netzlinien der Fläche y(x,z) kann bezogen
auf die Breite des Datenfensters festgelegt werden. Die Einstellung von
100&nbsp;% entspricht dabei dem Normalwert</para>
<para>
Eine Tabelle der Werte der dargestellten Fläche kann über den Druckknopf
<guibutton>Exportieren</guibutton> als Datendatei exportiert werden. Dazu wird
ein Dateiauswahldialog geöffnet.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect2>

</sect1>

<sect1 id="image">
<title>Bild</title>
<anchor id="sec-image"/>

<para>
Der Dialog <guilabel>Bild</guilabel> ermöglicht das Einbetten elaubt das
Einbetten einer EPS-Abbildung (Encapsulated PostScript) in die
Darstellung.</para>
<para>
Ein Dateiauswahldialog erlaubt die Angabe einer EPS-<guilabel>Datei</guilabel>.
Unter <guilabel>x0</guilabel> und <guilabel>y0</guilabel> kann die Position der
linken unteren Ecke eingestellt werden.</para>
<para>
<guilabel>x-Skalierung</guilabel> und <guilabel>y-Skalierung</guilabel>
erlauben die Angabe von horizontalen und vertikalen Skalierungsfaktoren.
Werte von 100&nbsp;% entsprechen der Originalgröße der Abbildung. Der
gleiche Skalierungsfaktor für x- und y-Richtung wird verwendet, wenn
<guilabel>Seitenverhältnis beibehalten</guilabel> ausgewählt ist.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen
gespeichert, ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="legend">
<title>Legende</title>
<anchor id="sec-legend"/>

<para>
Im Dialogfenster <guilabel>Legende</guilabel> können die Einstellungen für die
Erklärung von Linientypen und Plotsymbolen und andere Beschriftungen
vorgenommen werden.</para>
<para>
In der Gruppe <guilabel>Daten</guilabel> kann ein zu erklärendes
<guilabel>Symbol</guilabel> bzw. Linientyp ausgewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt. Die Symbolnummer -17 kann gewählt werden,
um eine Beschriftung ohne Symbol bzw. Linie zu realisieren. Die
<guilabel>Größe</guilabel> der Linien bzw. Symbole kann als zusätzlicher
individueller Faktor zu der globalen Einstellung des zugehörigen
Rahmenbestandteils festgelegt werden. Die <guilabel>Farbe</guilabel> der Linien
bzw. Symbole wird über das Dialogfenster <guilabel>Farbe auswählen</guilabel>
eingestellt, das über den farbigen Druckknopf geöffnet werden kann. Unter
<guilabel>x</guilabel> und <guilabel>y</guilabel> kann die Position des Symbols
relativ zur linken unteren Ecke des Fensters bzw. Blattes eingestellt
werden.</para>
<para>
In der Gruppe <guilabel>Beschriftung</guilabel> kann unter
<guilabel>Text</guilabel> der Beschriftungstext eingegeben werden. Text mit
Sonderzeichen gibt man am bequemsten über das Dialogfenster
<link linkend="edit-text">Text editieren</link> ein, das über den Druckknopf
rechts neben dem Eingabefeld erreicht werden kann. Im Feld
<guilabel>Größe</guilabel> kann die relative Größe der Zeichen festgelegt
werden. Die Einstellung von 100&nbsp;% entspricht dabei dem Normalwert. Die
<guilabel>Farbe</guilabel> des Textes wird über das Dialogfenster
<guilabel>Farbe auswählen</guilabel> eingestellt, das über den farbigen
Druckknopf geöffnet werden kann. Unter <guilabel>xoff</guilabel> und
<guilabel>yoff</guilabel> kann die Position des Textanfangs relativ zur
Position des Symbols angegeben werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="text">
<title>Text</title>
<anchor id="sec-text"/>

<para>
Im Dialogfenster <guilabel>Text</guilabel> können die Einstellungen für einen
Text zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Unter <guilabel>Text</guilabel> kann der Text eingegeben werden. Text mit
Sonderzeichen gibt man am bequemsten über das Dialogfenster
<link linkend="edit-text">Text editieren</link> ein, das über den Druckknopf
rechts neben dem Eingabefeld erreicht werden kann. Die
<guilabel>Richtung</guilabel> des Texts kann in Grad eingegeben werden.
Die <guilabel>Ausrichtung</guilabel> des Texts relativ zur angebenen Position
kann linksbündig, zentriert, oder rechtsbündig gewählt werden. Unter
<guilabel>x0</guilabel> und <guilabel>y0</guilabel> kann die Position des Texts
in cm eingestellt werden.</para>
<para>
Im Feld <guilabel>Größe</guilabel> kann die relative Größe der Zeichen
festgelegt werden. Die Einstellung von 100&nbsp;% entspricht dabei dem
Normalwert. Die <guilabel>Farbe</guilabel> des Texts wird über das
Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das über den
farbigen Druckknopf geöffnet werden kann.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="line">
<title>Linie</title>
<anchor id="sec-line"/>

<para>
Im Dialogfenster <guilabel>Linie</guilabel> können die Einstellungen für eine
Linie zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Die <guilabel>Richtung</guilabel> der Linie kann in Grad eingegeben werden. Mit
<guilabel>Länge</guilabel> wird die Länge der Linie in cm eingestellt. Unter
<guilabel>x0</guilabel> und <guilabel>y0</guilabel> kann die Startposition der
Linie eingestellt werden.</para>
<para>
Im Feld <guilabel>Breite</guilabel> kann die relative Breite der Linie
festgelegt werden. Die Einstellung von 100&nbsp;% entspricht dabei dem
Normalwert. Die <guilabel>Farbe</guilabel> der Linie wird über das
Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das über den
farbigen Druckknopf geöffnet werden kann.</para>
<para>
Der <guilabel>Typ</guilabel> der Linie kann am einfachsten über das
Dialogfenster <guilabel>Linien</guilabel> ausgewählt werden, das über den
Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der auch das
aktuelle Plotsymbol anzeigt.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="arrow">
<title>Pfeil</title>
<anchor id="sec-arrow"/>

<para>
Im Dialogfenster <guilabel>Pfeil</guilabel> können die Einstellungen für einen
Pfeil zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Die <guilabel>Richtung</guilabel> des Pfeils kann in Grad eingegeben werden.
Mit <guilabel>Länge</guilabel> wird die Gesamtlänge des Pfeils in cm
eingestellt. Unter <guilabel>x0</guilabel> und <guilabel>y0</guilabel> können
die <guilabel>Koordinaten</guilabel> von <guilabel>Spitze</guilabel>,
<guilabel>Mitte</guilabel> oder <guilabel>Ende</guilabel> eingestellt
werden.</para>
<para>
Im Feld <guilabel>Größe</guilabel> kann die relative Größe der Pfeilspitze
festgelegt werden. Die Einstellung von 100&nbsp;% entspricht dabei dem
Normalwert. Die <guilabel>Farbe</guilabel> des Pfeils wird über das
Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das über den
farbigen Druckknopf geöffnet werden kann.</para>
<para>
Der Pfeil kann als <guilabel>zweispitzig</guilabel> eingestellt werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="arc">
<title>Bogen</title>
<anchor id="sec-arc"/>

<para>
Im Dialogfenster <guilabel>Bogen</guilabel> können die Einstellungen für einen
Ellipsenbogen zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Die <guilabel>Breite</guilabel> und <guilabel>Höhe</guilabel> der Ellipse
können in cm eingegeben werden. Die Höhe wird gleich der Breite gesetzt, wenn
<guilabel>Kreisbogen</guilabel> aktiviert ist. Mit <guilabel>Anfang</guilabel>
und <guilabel>Länge</guilabel> können Startwinkel und Länge des Bogens in Grad
eingestellt werden. Die <guilabel>Drehung</guilabel> der Ellipse gegen die
Horizontale kann in Grad angegeben werden. Unter <guilabel>x0</guilabel> und
<guilabel>y0</guilabel> kann die Mittenposition eingestellt werden.</para>
<para>
Im Feld <guilabel>Linienbreite</guilabel> kann die relative Breite der Linie
zum Zeichnen des Bogens festgelegt werden. Die Einstellung von 100&nbsp;%
entspricht dabei dem Normalwert. Die <guilabel>Farbe</guilabel> des Bogens wird
über das Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das
über den farbigen Druckknopf geöffnet werden kann.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="rect">
<title>Rechteck</title>
<anchor id="sec-rect"/>

<para>
Im Dialogfenster <guilabel>Rechteck</guilabel> können die Einstellungen für ein
Rechteck zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Die <guilabel>Breite</guilabel> und <guilabel>Höhe</guilabel> des Rechtecks
können in cm eingegeben werden. Die Höhe wird gleich der Breite gesetzt, wenn
<guilabel>Quadrat</guilabel> aktiviert ist. Die <guilabel>Drehung</guilabel>
des Rechtecks um die linke untere Ecke gegen die Horizontale kann in Grad
angegeben werden. Unter <guilabel>x0</guilabel> und
<guilabel>y0</guilabel> kann die Position der linken unteren Ecke eingestellt
werden.</para>
<para>
Im Feld <guilabel>Linienbreite</guilabel> kann die relative Breite der Linie
zum Zeichnen des Rechtecks festgelegt werden. Die Einstellung von 100&nbsp;%
entspricht dabei dem Normalwert. Die <guilabel>Farbe</guilabel> des Rechtecks
wird über das Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt,
das über den farbigen Druckknopf geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch eine Linie, das Rechteck vollständig mit einer Farbe oder mit
einer Schraffur gefüllt werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="ellipse">
<title>Ellipse</title>
<anchor id="sec-ellipse"/>

<para>
Im Dialogfenster <guilabel>Ellipse</guilabel> können die Einstellungen für eine
Ellipse zur Dekoration der Darstellung vorgenommen werden.</para>
<para>
Die <guilabel>Breite</guilabel> und <guilabel>Höhe</guilabel> der Ellipse
können in cm eingegeben werden. Die Höhe wird gleich der Breite gesetzt, wenn
<guilabel>Kreis</guilabel> aktiviert ist. Die <guilabel>Drehung</guilabel> der
Ellipse gegen die Horizontale kann in Grad angegeben werden. Unter
<guilabel>x0</guilabel> und <guilabel>y0</guilabel> kann die Mittenposition
eingestellt werden.</para>
<para>
Im Feld <guilabel>Linienbreite</guilabel> kann die relative Breite der Linie
zum Zeichnen der Ellipse festgelegt werden. Die Einstellung von 100&nbsp;%
entspricht dabei dem Normalwert. Die <guilabel>Farbe</guilabel> der Ellipse
wird über das Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt,
das über den farbigen Druckknopf geöffnet werden kann.</para>
<para>
Durch Auswahl von einem <guilabel>Füllmuster</guilabel> kann, anstelle einer
Darstellung durch eine Linie, das Rechteck vollständig mit einer Farbe oder mit
einer Schraffur gefüllt werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="scalebar">
<title>Maßstab</title>
<anchor id="sec-scalebar"/>

<para>
Der Dialog <guilabel>Maßstab</guilabel> dient zur Darstellung eines Maßstabs
zur Anzeige einer Längenskala. Als <guilabel>Ausrichtung</guilabel> kann
<guilabel>Waagrecht</guilabel> oder <guilabel>Senkrecht</guilabel> gewählt
werden. Ein <guilabel>Text</guilabel> (gewöhnlich eine Länge, die der Maßstab
repräsentieren soll) kann angegeben werden. Die tatsächliche
<guilabel>Länge</guilabel> des Maßstabs in der Darstellung ist in cm anzugeben.
Unter <guilabel>x0</guilabel> und <guilabel>y0</guilabel> kann die Position der
linken unteren Ecke eingestellt werden.</para>
<para>
Im Feld <guilabel>Größe</guilabel> kann die relative Größe von Beschriftung und
Linienbreite festgelegt werden. Die Einstellung von 100&nbsp;% entspricht dabei
dem Normalwert. Die <guilabel>Farbe</guilabel> des Maßstabs wird über das
Dialogfenster <guilabel>Farbe auswählen</guilabel> eingestellt, das über den
farbigen Druckknopf geöffnet werden kann.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Änderungen gespeichert,
ohne das Dialogfenster zu schließen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="fit">
<title>Parameteranpassung</title>
<anchor id="sec-fit"/>

<para>
Der Dialog <guilabel>Parameteranpassung</guilabel> dient zur Durchführung einer
Parameteranpassung einer Funktion (oder mehrerer, vom gleichen Parametersatz
abhängiger Funktionen bei mehrdimensionaler Anpassung) an die gleiche Zahl von
Datensätzen. Der Dialog wird entweder durch Auswahl von
<guibutton>Anpassen</guibutton> im Menü
<link linkend="edit-menu">Bearbeiten</link> oder automatisch angezeigt, wenn
eine Datendatei geladen wird und die Einstellungen <guilabel>Autofit</guilabel>
in den <link linkend="basic">Grundeinstellungen</link> und
<guilabel>Dialog anzeigen</guilabel> in den
<link linkend="autofit">Autofit-Einstellungen</link> aktiviert sind.</para>
<para>
Anfangswerte für die Parameter können in die entsprechenden Felder eingegeben
werden. Beim Öffen des Dialogs werden die Felder mit den Werten des aktuellen
Parametersatzes der Funktion initialisiert (im Fall von mehrdimensionaler
Anpassung mit denen der ersten Funktion aus der Liste der ausgewählten
Funktionen). Durch Aktivieren der Auswahlfelder links neben den Eingabefeldern
werden die anzupassenden Parameter ausgewählt; die Werte der anderen Parameter
werden konstant gehalten. Im Fall von allgemeinen linearen Parameteranpassungen
müssen für die anzupassenden Parameter keine Anfangswerte eingegeben werden.
Die berechneten Standardabweichungen der Parameter werden rechts neben den
entsprechenden Eingabefeldern angezeigt.</para>
<para>
Die Druckknöpfe <guibutton>Laden</guibutton> und
<guibutton>Speichern</guibutton> dienen zum Laden und Speichern des aktuellen
Parametersatzes von bzw. in Textdateien. Im Unterschied zu dem bei den anderen
Parametereinstellungsdialogen verwendeten Format werden hier in einer zweiten
Spalte auch die resultierenden Standardabweichungen der Parameter
abgespeichert.</para>
<para>
Bei aktiviertem Auswahlfeld <guilabel>Nichtlineare Anpassung</guilabel> werden
nichtlineare Parameteranpassungen nach der iterativen
Levenberg-Marquardt-Methode durchgeführt. Andernfalls sind nichtiterative
allgemeine lineare Parameteranpassungen ausgewählt. In diesem Fall muß die
Funktion linear von allen anzupassenden Parametern abhängen.</para>
<para>
In der Gruppe <guilabel>Fehler der Daten</guilabel> können die Einstellungen
für die Gewichtung der Datenpunkte vorgenommen werden. Das ausgewählte
<guilabel>Feld</guilabel>, für das die Einstellungen vorgenommen werden, wird
durch seinen Dateinamen und die Indices für die x-, y- und Fehlerspalte
angezeigt. Im Fall mehrdimensionaler Anpassung kann das Feld aus der Liste mit
einer Spinbox gewählt werden, die den Listenindex anzeigt. Die Einstellungen
können dann für jedes Feld individuell vorgenommen werden.</para>

<anchor id="errormodel"/>
<para>
Bei aktiviertem Auswahlfeld <guilabel>Fehlerspalte</guilabel> wird die
entsprechende Spalte des Datensatzes, die im Dialog <guilabel>Feld</guilabel>
eingestellt ist, als Standardabweichung der y-Werte bei der Berechnung von
Chi-Quadrat herangezogen. Andernfalls wird die Standardabweichung über eine
Fehlermodellfunktion mit den x- oder y-Werten als Argument ermittelt. Diese
Funktion und ihre Parameter können in einem Dialog ausgewählt werden, der über
den Druckknopf <guibutton>Modell</guibutton> angezeigt wird. Ein einfaches
Fehlermodell könnte in der Auswahl eines Polynoms mit p1&nbsp;=&nbsp;0.01
bestehen, mit dem Resultat einer Standardabweichung von 1&nbsp;%.</para>
<para>
Die Abbruchbedingung des iterativen Algorithmus für die nichtlineare
Parameteranpassung kann durch eine Zahl
<guilabel>Maximale Iterationen</guilabel> und einen Wert für die
<guilabel>Toleranz</guilabel> gesteuert werden. Die Parameteranpassung wird
abgebrochen, wenn entweder die maximale Anzahl Iterationen erreicht ist oder
die relativen Fehler von Chi-Quadrat oder der Parameter den Toleranzwert
unterschreiten.</para>
<para>
Die Anpassung wird mittels des Druckknopfs <guibutton>Start</guibutton>
gestartet. Die im Verlauf der Iterationen erhaltenen Chi-Quadrat-Werte werden
in dem Fenster im unteren Bereich des Dialogs angezeigt. Die Anpassung kann
mittels des Druckknopfs <guibutton>Abbrechen</guibutton> beendet werden. Zum
Schluß wird der Grund des Abbruchs angezeigt, sowie die mittlere Abweichung der
y-Werte, die Zahl der Freiheitsgrade ny und die Signifikanz Q, die die
Wahrscheinlichkeit dafür angibt, daß Chi-Quadrat den erreichten Wert
überschreitet. Die Matrix der resultierenden Korrelationskoeffizienten der
Parameter kann über den Druckknopf <guibutton>Korrelationen</guibutton>
angezeigt werden.</para>
<para>
Die Residuen des Fits (die Differenzen zwischen Daten- und Funktionswerten)
können über den Druckknopf <guibutton>Residuen</guibutton> grafisch dargestellt
werden. Der in einem neuen Fenster erscheinende Plot kann dann gedruckt und als
neue Plotdatei mit intern gespeicherten Daten der Residuen gesichert
werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die Parameter zu speichern. Mit dem Druckknopf
<guibutton>Anwenden</guibutton> werden die Parameter gespeichert, ohne das
Dialogfenster zu schließen. Mit dem Druckknopf <guibutton>OK</guibutton>
werden die Parameter gespeichert und das Dialogfenster geschlossen. Im Fall
mehrdimensionaler Anpassung werden dabei die Parameter jeder ausgewählten
Funktion aktualisiert.</para>

</sect1>

<sect1 id="spline-fit">
<title>Glättende Spline-Anpassung</title>
<anchor id="sec-spline-fit"/>

<para>
Der Dialog <guilabel>Glättende Spline-Anpassung</guilabel> dient zur
Durchführung einer Anpassung einer Spline-Funktion an einen Datensatz. Der
Dialog wird durch Auswahl von <guibutton>Anpassen</guibutton> im Menü
<link linkend="edit-menu">Bearbeiten</link> angezeigt.</para>
<para>
In der Gruppe <guilabel>Spline</guilabel> können der <guilabel>Grad</guilabel>
der Spline-Funktion sowie die Grenzen <guilabel>xmin</guilabel> und
<guilabel>xmax</guilabel> des Approximationsintervalls eingestellt werden. Sie
begrenzen den Bereich, für den der Spline dargestellt werden kann und umfassen
mindestens den Bereich der x-Werte des im Dialog <guilabel>Feld</guilabel>
ausgewählten Bereichs des Datensatzes. Der <guilabel>Glättungsfaktor</guilabel>
beeinflusst die mittlere Abweichung der Spline-Funktion von den y-Werten des
Datensatzes und gibt den Faktor an, um den sich im Mittel die Abweichungen vom
Fehler der Daten unterscheiden sollen. Ein Wert von 0 führt zu einem
nichtglättenden Spline.</para>
<para>
In der Gruppe <guilabel>Fehler der Daten</guilabel> können die Einstellungen
für die Gewichtung der Datenpunkte vorgenommen werden. Das
<guilabel>Feld</guilabel>, für das die Anpassung vorgenommen wird, wird durch
seinen Dateinamen und die Indices von x-, y- und Fehlerspalte angezeigt. Bei
aktiviertem Auswahlfeld <guilabel>Fehlerspalte</guilabel> wird die
entsprechende Spalte des Datensatzes, die im Dialog <guilabel>Feld</guilabel>
eingestellt ist, als Standardabweichung der y-Werte bei der Anpassung
herangezogen. Andernfalls wird die Standardabweichung über eine
Fehlermodellfunktion mit den x- oder y-Werten als Argument ermittelt. Diese
Funktion und ihre Parameter können in einem Dialog ausgewählt werden, der über
den Druckknopf <guibutton>Modell</guibutton> angezeigt wird. Ein einfaches
Fehlermodell könnte in der Auswahl eines Polynoms mit p1&nbsp;=&nbsp;0.01
bestehen, mit dem Resultat einer Standarabweichung von 1&nbsp;%.</para>
<para>
Die Anpassung wird mittels des Druckknopfs <guibutton>Start</guibutton>
durchgeführt. Die Zahl der bei der Anpassung erhaltenen Knotenpunkte des
Splines, das resultierende Chi-Quadrat sowie die mittlere Abweichung der
y-Werte sowie gegebenenfalls eine Fehlermeldung werden in dem Fenster im
unteren Bereich des Dialogs angezeigt.</para>
<para>
Die Residuen der Anpassung (die Differenzen zwischen Daten- und
Spline-Funktionswerten) können über den Druckknopf
<guibutton>Residuen</guibutton> grafisch dargestellt werden. Der in einem neuen
Fenster erscheinende Plot kann dann gedruckt und als neue Plotdatei mit intern
gespeicherten Daten der Residuen gesichert werden.</para>
<para>
Der Dialog <link linkend="roots">Wurzeln</link> zum Auffinden von Nullstellen
eines kubischen Splines oder seiner Ableitungen kann über den Druckknopf
<guibutton>Wurzeln</guibutton> geöffnet werden.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die Spline-Koeffizienten zu speichern. Mit dem
Druckknopf <guibutton>Anwenden</guibutton> werden die Spline-Koeffizienten
gespeichert und der Plot aktualisiert, ohne das Dialogfenster zu schließen. Mit
dem Druckknopf <guibutton>OK</guibutton> werden die Spline-Koeffizienten
gespeichert und das Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="roots">
<title>Wurzeln</title>
<anchor id="sec-roots"/>

<para>
Der Dialog <guilabel>Wurzeln</guilabel> kann über den Druckknopf
<guibutton>Wurzeln</guibutton> der Dialoge <guilabel>Funktion</guilabel>,
<guilabel>Glättender Spline</guilabel> und
<guilabel>Glättende Spline-Anpassung</guilabel> geöffnet werden. Er erlaubt das
Auffinden von Nullstellen der Funktion bzw. des Splines oder der entsprechenden
Ableitungen. Im Fall einer Funktion wird dabei eine interpolierende
(nichtglättende) Spline-Darstellung genutzt, im Falle eines glättenden Splines
der aktuelle Spline, dessen Grad kubisch sein muß.</para>
<para>
Die <guilabel>Bedingung</guilabel> für die zu suchenden und anzuzeigenden
Nullstellen kann ausgewählt werden. Eine Konstante <guilabel>c</guilabel>
erlaubt das Auffinden von Punkten mit Werten des Splines oder seiner
Ableitungen ungleich Null. Der Druckknopf <guilabel>Aktualisieren</guilabel>
dient zum Aktualisieren der angezeigten Liste von Punkten nach Änderung der
Konstante <guilabel>c</guilabel>. Als <guilabel>Bedingung</guilabel> kann auch
<guilabel>Minimum</guilabel> oder <guilabel>Maximum</guilabel> eingestellt
werden. Dann werden Punkte mit einer verschwindenden ersten Ableitung und
positiver (Minimum) bzw. negativer (Maximum) zweiter Ableitung
aufgelistet.</para>
<para>
Die Liste der Punkte mit ihren x-, y-, y'- und y"-Werte kann über den
Druckknopf <guibutton>Exportieren</guibutton> in einer Textdatei gespeichert
werden. Dazu wird ein Dateiauswahldialog geöffnet.</para>
<para>
Über den Druckknopf <guibutton>Schließen</guibutton> wird das Dialogfenster
geschlossen.</para>

</sect1>

<sect1 id="edit-text">
<title>Text editieren</title>
<anchor id="sec-edit-text"/>

<para>
Im Dialogfenster <guilabel>Text editieren</guilabel> kann ein Beschriftungstext
mit hoch- und tiefgestellten Zeichen aus verschiedenen Zeichensätzen erstellt
werden.</para>
<para>
Die Wahl einer <guilabel>Schriftart</guilabel> und einer
<guilabel>Position</guilabel> bestimmt eine mit dem Zeichen <keycap>#</keycap>
eingeleitete und aus zwei weiteren Zeichen bestehende Steuersequenz im Feld
rechts neben dem Druckknopf mit dem Symbol <guilabel>&lt;</guilabel>. Durch
Betätigung des Druckknopfs wird die Sequenz (oder eine andere, manuell
eingetragene Zeichenkette) an der Cursorposition in den aktuellen Inhalt des
Texteingabefelds links neben dem Druckknopf eingefügt. Text kann manuell an
eine beliebige Stelle im Texteingabefeld eingefügt werden. Die Auswirkungen des
aktuellen Inhalts des Texteingabefensters auf das Beschriftungsbild sind sofort
im Ausgabefenster darüber sichtbar.</para>
<para>
Das Dialogfenster kann mit dem Druckknopf <guibutton>Abbrechen</guibutton>
verlassen werden, ohne die geänderten Einstellungen zu speichern. Mit dem
Druckknopf <guibutton>OK</guibutton> werden die Änderungen gespeichert und das
Dialogfenster geschlossen.</para>

</sect1>

<sect1 id="settings">
<title>Einrichten</title>
<anchor id="sec-settings"/>

<para>
Im Dialogfenster <guilabel>Einrichten</guilabel> können allgemeine
Voreinstellungen sowie die Autoplot- und Autofit-Einstellungen vorgenommen
werden. Das Dialogfenster kann mit dem Druckknopf
<guibutton>Abbrechen</guibutton> verlassen werden, ohne die geänderten
Einstellungen zu speichern. Mit <guibutton>Voreinstellungen</guibutton> können
alle Einträge im Dialog auf die Standardwerte zurückgesetzt werden. Durch
Betätigen des Druckknopfes <guibutton>Anwenden</guibutton> werden die
Änderungen angewendet, ohne den Dialog zu verlassen. Mit dem Druckknopf
<guibutton>OK</guibutton> werden die Änderungen angewendet und das
Dialogfenster geschlossen.</para>

<para>Der Dialog besteht aus drei Seiten.</para>

<sect2 id="basic">
<title>Grundeinstellungen</title>
<anchor id="sec-basic"/>

<para>
Auf der Seite <guilabel>Grundeinstellungen</guilabel> können allgemeine
Voreinstellungen vorgenommen werden.</para>
<para>
In der Gruppe <guilabel>Seitenformat</guilabel> kann die Größe der
Darstellungsseite mittels der Kombobox ausgewählt werden. Die Einstellung
<guilabel>Benutzerdefiniert</guilabel> erlaubt eigene Einstellungen für
<guilabel>Breite</guilabel> und <guilabel>Höhe</guilabel>.</para>
<para>
In der Gruppe <guilabel>Standardfarben</guilabel> können die Voreinstellungen
der Farben für <guilabel>Rahmen</guilabel>, <guilabel>Gitter</guilabel> und
<guilabel>Daten</guilabel> für die Dialogfenster Rahmen, Feld, Funktion und
Parametrische Funktion gewählt werden. Die Auswahl erfolgt dabei über das
Dialogfenster Farbauswahl, das über die farbigen Drucknöpfe erreicht werden
kann.</para>
<para>
Für das <guilabel>Dezimalsymbol</guilabel> zum Einlesen von Datendateien kann
ein Punkt oder ein Komma als Voreinstellung gewählt werden.</para>
<para>
In der Gruppe <guilabel>Ausgabeformat</guilabel> können die
<guilabel>Darstellung</guilabel> und die <guilabel>Genauigkeit</guilabel>
der double-Werte von Funktionsparametern und -bereichen in Dateien und Dialogen
entsprechend dem Format der C-Funktion <function>printf()</function>
eingestellt werden. Das Trennzeichen zur Trennung von Spalten in exportierten
Dateien kann mittels der Kombobox <guilabel>Trennzeichen</guilabel> eingestellt
werden. Es kann zwischen Leerzeichen, Tabulator und Komma gewählt
werden.</para>
<para>
Auch die Umschalteinstellungen des Menüs
<link linkend="settings-menu">Einstellungen</link> können hier auf ein Mal
vorgenommen werden.</para>
<para>
Bei aktiviertem Feld <guilabel>Autofit</guilabel> wird nach dem Laden einer
Datendatei eine automatische Parameteranpassung durchgeführt, entsprechend den
Vorgaben auf der Seite <guilabel>Autofit-Einstellungen</guilabel>.</para>
<para>
Bei aktiviertem Feld <guilabel>Interne PS-Kodierung benutzen</guilabel> wird
leicht editierbare PostScript-Ausgabe generiert. Zum Beispiel werden die
Koordinaten von 2D-Datenpunkten ohne Skalierung gespeichert, entsprechend
den Werten aus Datendateien oder Funktionsberechnungen.</para>

</sect2>

<sect2 id="autoplot">
<title>Autoplot-Einstellungen</title>
<anchor id="sec-autoplot"/>

<para>
Auf der Seite <guilabel>Autoplot-Einstellungen</guilabel> erfolgen die
Einstellungen für die automatisch skalierte Darstellung von Datendateien, die
mittels Befehlszeilenparameter, Dateimenü oder Drag-and-Drop-Technik eingelesen
werden.</para>
<para>
In der Gruppe <guilabel>Achsenmodus</guilabel> kann gewählt werden, ob die
Darstellung nur einen Rahmen um das Datenfenster oder zusätzlich Tickmarken an
den linken und unteren Seiten des Rahmens oder ein Gitter erhält. Tickmarken
und Gitter können mit Zahlenwerten beschriftet werden.</para>
<para>
In der Gruppe <guilabel>Fenster</guilabel> können Lage und Größe des
Datenfensters festgelegt werden.</para>
<para>
In der Gruppe <guilabel>Beschriftung</guilabel> kann Text für die
Achsenbeschriftungen und eine Kopfzeile festgelegt werden. Text mit
Sonderzeichen gibt man am bequemsten über das Dialogfenster
<link linkend="edit-text">Text editieren</link>, das über die Drucknöpfe rechts
neben den Eingabefeldern erreicht werden kann. Mittels des Auswahlfelds
<guilabel>= Pfad</guilabel> kann der Kopf automatisch mit dem Pfad der
jeweiligen Datendatei beschriftet werden.</para>
<para>
In der Gruppe <guilabel>Daten</guilabel> können in
<guilabel>x-Spalte</guilabel> und <guilabel>y-Spalte</guilabel> die Spalten der
Datendatei für Abszissen- und Ordinatenwerte ausgewählt werden. 0 entspricht
dabei der ersten Spalte. Logaritmische Skalierung kann individuell durch
Auswahl von <guilabel>log</guilabel> eingestellt werden. Bei aktiviertem
Auswahlfeld <guilabel>Fehlerbalken</guilabel> wird, wenn vorhanden, die als
<guilabel>Fehlerspalte</guilabel> angegebene Spalte zur Darstellung von
Fehlerbalken herangezogen. Zur Darstellung der Daten können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt. Im Feld <guilabel>Symbolgröße</guilabel>
kann die relative Größe von Zeichensätzen und Plotsymbolen sowie die relative
Breite von Linien (bezogen auf die Breite des Datenfensters) festgelegt werden.
Die Einstellung von 100&nbsp;% entspricht dabei dem Normalwert. Bei aktiviertem
Auswahlfeld <guilabel>Normierung</guilabel> werden bei der automatischen
Skalierung Zehnerpotenzen bestimmt, mit denen sehr große oder sehr kleine
Zahlenwerte in der Darstellung multipliziert erscheinen. Diese
Normierungsfaktoren werden, soweit sie verschieden von 1 sind, in die
Beschriftung der Achsen übernommen.</para>

</sect2>

<sect2 id="autofit">
<title>Autofit-Einstellungen</title>
<anchor id="sec-autofit"/>

<para>
Auf der Seite <guilabel>Autofit-Einstellungen</guilabel> werden die
Einstellungen für automatische Parameteranpassungen von Funktion an Datensätze
vorgenommen, die in Verbindung mit Autoplot erfolgen, wenn die Einstellung
<guilabel>Autofit</guilabel> auf der Dialogseite
<link linkend="basic">Grundeinstellungen</link> aktiviert ist.</para>
<para>
In der Gruppe <guilabel>y(x)</guilabel> kann unter
<guilabel>Bibliothek</guilabel> der Pfad der
<foreignphrase lang="en">shared library</foreignphrase> eingetragen werden, die
die anzupassende Funktion enthält. Der Druckknopf rechts neben dem Eingabefeld
öffnet dazu einen Dateiauswahldialog.</para>
<para>
Der Name der <guilabel>Funktion</guilabel> kann in einem weiteren Feld
angegeben werden. Befindet sich im gleichen Verzeichnis wie die
<foreignphrase lang="en">shared library</foreignphrase> auch eine
Moduldefinitionsdatei gleichen Namens mit der Dateierweiterung
<guilabel>.def</guilabel>, so kann über den Druckknopf rechts neben dem
Eingabefeld das Dialogfenster <guilabel>Funktionen</guilabel> geöffnet werden,
in dem die Funktion aus einer Liste ausgewählt werden kann.</para>
<para>
Über den Druckknopf <guibutton>Bearbeiten</guibutton> kann das Dialogfenster
<guilabel>Parameter</guilabel> geöffnet werden, in dem Zahlenwerte für maximal
20 Parameter der Funktion eingegeben werden können. Hier werden auch durch
Aktivieren der Auswahlfelder links neben den Eingabefeldern die anzupassenden
Parameter ausgewählt; die Werte der anderen Parameter werden konstant gehalten.
Bei aktivierter Einstellung
<guilabel>Funktions<accel>q</accel>uelltext anzeigen</guilabel> auf der
Dialogseite <link linkend="basic">Grundeinstellungen</link> und Vorhandensein
einer C- bzw. C++-Quelltextdatei gleichen Namens wie die
<foreignphrase lang="en">shared library</foreignphrase> und der
Dateierweiterung <literal role="extension">.c</literal> bzw.
<literal role="extension">.cpp</literal> im gleichen Verzeichnis wird deren
Inhalt rechts neben den Parametern angezeigt. Über den Druckknopf
<guibutton>Laden</guibutton> kann ein Dateiauswahlfenster geöffnet werden, mit
dem die Parameter aus einer Textdatei (pro Zeile ein Parameter) eingelesen
werden können. Über den Druckknopf <guibutton>Speichern</guibutton> kann ein
Dateiauswahlfenster geöffnet werden, mit dem die Parameter in einer Textdatei
gespeichert werden können.</para>
<para>
Bei aktiviertem Auswahlfeld <guilabel>Nichtlineare Anpassung</guilabel> werden
nichtlineare Parameteranpassungen nach der iterativen
Levenberg-Marquardt-Methode durchgeführt. Andernfalls sind nichtiterative
allgemeine lineare Parameteranpassungen ausgewählt. In diesem Fall muß die
Funktion linear von allen anzupassenden Parametern abhängen.</para>
<para>
Bei aktiviertem Auswahlfeld <guilabel>Fehlerspalte</guilabel> wird die
entsprechende Spalte des Datensatzes, die auf der Dialogseite
<link linkend="autoplot">Autoplot-Einstellungen</link> eingestellt ist, als
Standardabweichung der y-Werte bei der Berechnung von Chi-Quadrat herangezogen.
Andernfalls wird die Standardabweichung über eine Fehlermodellfunktion mit den
x- oder y-Werten als Argument ermittelt. Diese Funktion und ihre Parameter
können in einem Dialog ausgewählt werden, der über den Druckknopf
<guilabel>Modell</guilabel> angezeigt wird. Ein einfaches Fehlermodell könnte
in der Auswahl eines Polynoms mit p1&nbsp;=&nbsp;0.01 bestehen, mit dem
Resultat einer Standardabweichung von 1&nbsp;%.</para>
<para>
Die Abbruchbedingung des iterativen Algorithmus für die nichtlineare
Parameteranpassung kann durch eine Zahl
<guilabel>Maximale Iterationen</guilabel> und einen Wert für die
<guilabel>Toleranz</guilabel> gesteuert werden. Die Parameteranpassung wird
abgebrochen, wenn entweder die maximale Anzahl Iterationen erreicht ist oder
die relativen Fehler von Chi-Quadrat oder der Parameter den Toleranzwert
unterschreiten.</para>
<para>
Zur Darstellung der anzupassenden Funktion können Plotsymbole
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) oder Linien
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) gewählt werden. Am einfachsten
geschieht dies über das Dialogfenster <guilabel>Linien und Symbole</guilabel>,
das über den Druckknopf rechts neben dem Anzeigefeld erreicht werden kann, der
auch das aktuelle Plotsymbol anzeigt.</para>
<para>
Die <guilabel>Farbe</guilabel> der Linien bzw. Symbole wird über das
Dialogfenster Farbauswahl eingestellt, das über den farbigen Druckknopf
geöffnet werden kann.</para>
<para>
Wenn die Einstellung <guilabel>Dialog anzeigen</guilabel> aktiviert ist, wird
der Dialog <link linkend="fit">Parameteranpassung</link> bei der Anpassung
angezeigt und damit Beobachtung und Interaktion ermöglicht.</para>
<para>
Bei aktivierter Einstellung <guilabel>Parameter speichern</guilabel> werden die
Parameter nach erfolgter Anpassung automatisch in einer Textdatei gespeichert.
Der Dateiname wird aus dem der Datendatei abgeleitet; als Dateierweiterung wird
<filename>.par</filename> verwendet.</para>
<para>
Wenn <guilabel>Parametern folgen</guilabel> aktiviert ist, wird der
Anfangsparametersatz vor Beginn der Anpassung einer Funktion an den nächsten
Datensatz aus einer Serie von Datendateien nicht zurückgesetzt.</para>

</sect2>

</sect1>

</chapter>

<chapter id="developers">
<title>Programmierleitfaden zu Kpl</title>

<sect1 id="functions">
<title>Funktionen</title>

<para>
Benutzerdefinierte C- oder C++-Funktionen zur grafischen Darstellung von
gewöhnlichen und parametrischen Funktionen sowie zur Parameteranpassung werden
von &kpl; in Form von <foreignphrase lang="en">shared libraries</foreignphrase>
genutzt. Entsprechende Funktionen sind vom Typ <type>double</type> und erwarten
ein <type>double</type>-Funktionsargument und einen Zeiger auf ein
<type>double</type>-Array von bis zu 20 Parametern:</para>
<programlisting>
double myfunction(double x, const double *p);</programlisting>
<para>
Funktionen zur dreidimensionalen Darstellung von Oberflächen sind vom Typ
<type>double</type> und erwarten zwei <type>double</type>-Funktionsargumente
und einen Zeiger auf ein <type>double</type>-Array von bis zu 20
Parametern:</para>
<programlisting>
double my3Dfunction(double x, double z, const double *p);</programlisting>
<para>
Moduldefinitionsdateien (mit dem Dateityp
<literal role="extension">.def</literal> und gleichem Namen wie Quell- und
Bibliotheksdateien) dienen zur Auflistung der Funktionsnamen in &kpl;. Sie
entsprechen der Ausgabe des Programms <command>nm</command>.</para>
<para>
Im Verzeichnis $<envar>KDEDIR</envar><filename>/lib/kde4/plugins/kpl</filename>
im Fall einer 32-Bit-Installation bzw.
$<envar>KDEDIR</envar><filename>/lib64/kde4/plugins/kpl</filename> im Fall einer
64-Bit-Installation wird bereits eine
<foreignphrase lang="en">shared library</foreignphrase>
<filename>fkt.so</filename> sowie die Quelldatei <filename>fkt.c</filename>,
die Moduldefinitionsdatei <filename>fkt.def</filename> und eine make-Datei
<filename>Makefile.fkt</filename> installiert. Die Dateien
<filename>fkt.c</filename> und <filename>Makefile.fkt</filename> dienen als
Beispiele und sind gegebenenfalls anzupassen. Die als Beispiele dienenden
Plotdateien <filename>demo2.plo</filename>, <filename>demo3.plo</filename>,
<filename>demo4.plo</filename>, <filename>demo5.plo</filename>,
<filename>demo6.plo</filename> und <filename>demo11.plo</filename> im gleichen
Verzeichnis nutzen Funktionen aus <filename>fkt.so</filename>.</para>
<para>
Als ein Beispiel für mehrdimensionale Parameteranpassung befinden sich im
gleichen Verzeichnis eine C++-Quelldatei <filename>fcompl.cpp</filename> sowie
die zugehörigen Dateien <filename>fcompl.so</filename>,
<filename>fcompl.def</filename> und <filename>Makefile.fcompl</filename>. Hier
nutzen zwei <type>double</type>-Funktionen Real- und Imaginärteil einer mit
Hilfe der Klasse <classname>complex</classname> realisierten komplexen
Funktion. Die als Beispiele dienenden Plotdateien
<filename>demo7.plo</filename> und <filename>demo8.plo</filename> nutzen
Funktionen aus <filename>fcompl.so</filename>.</para>
</sect1>

<sect1 id="d-bus">
<title>D-BUS-Schnittstelle</title>

<para>
Die <acronym>D-BUS</acronym>-Schnittstelle erlaubt die Steuerung von &kpl;
durch andere KDE-Anwendungen und Skripte.</para>
<para>
Ein C++-Beispiel <filename>demo1.cpp</filename> für eine KDE-Anwendung, die von
der <acronym>D-BUS</acronym>-Schnittstelle von &kpl; Gebrauch macht, steht im
Verzeichnis $<envar>KDEDIR</envar><filename>/lib/kde4/plugins/kpl</filename> im
Fall einer 32-Bit-Installation bzw.
$<envar>KDEDIR</envar><filename>/lib64/kde4/plugins/kpl</filename> im Fall einer
64-Bit-Installation zusammen mit einer Projektdatei
<filename>CMakeLists.txt</filename> für <command>cmake</command> zur Verfügung.
Zum Übersetzen kopieren Sie diese zwei Dateien in ein Verzeichnis und führen
dort <command>cmake ./</command> und <command>make</command> aus.</para>
<para>
Ein Beispiel <filename>demo1.py</filename> für ein Python-Skript, das die
<acronym>D-BUS</acronym>-Schnittstelle von &kpl; nutzt, steht ebenfalls im
gleichen Verzeichnis zur Verfügung. Es läßt praktisch dasselbe wie das
C++-Beispiel ablaufen.</para>
<para>
Zum Testen der <acronym>D-BUS</acronym> Schnittstelle von &kpl; können Sie auch
die <acronym>D-BUS</acronym>-Dienstprogramme <command>qdbus</command> (Befehlszeile)
und <command>qdbusviewer</command> (GUI) nutzen.</para>
<para>
Die <acronym>D-BUS</acronym>-Schnittstelle von &kpl; stellt die folgenden
Funktionen zur Verfügung:</para>

<sect2>
<title>newPlot</title>
<synopsis>
void newPlot();
</synopsis>
<para>
Löscht den aktuellen Plot.
</para>
</sect2>

<sect2>
<title>openPlot</title>
<synopsis>
bool openPlot(const QString&amp; <replaceable class="parameter">url</replaceable>);
</synopsis>
<para>Öffnet eine Plotdatei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>openData</title>
<synopsis>
bool openData(const QString&amp; <replaceable class="parameter">url</replaceable>);
</synopsis>
<para>Öffnet eine Datendatei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>savePlot</title>
<synopsis>
bool savePlot(const QString&amp; <replaceable class="parameter">url</replaceable>);
</synopsis>
<para>Speichert Plotdatei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>savePS</title>
<synopsis>
bool savePS(const QString&amp; <replaceable class="parameter">url</replaceable>,
            bool <replaceable class="parameter">landscape</replaceable>);
</synopsis>
<para>Erzeugt PostScript-Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">landscape</replaceable>
</term>
<listitem><para>true für Querformat.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>printPlot</title>
<synopsis>
bool printPlot(const QString&amp; <replaceable class="parameter">printerName</replaceable>,
               const QString&amp; <replaceable class="parameter">fileName</replaceable>,
               bool <replaceable class="parameter">landscape</replaceable>,
               int <replaceable class="parameter">numCopies</replaceable>);
</synopsis>
<para>Druckt aktuellen Plot aus.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">printerName</replaceable>
</term>
<listitem><para>Name des Druckers.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fileName</replaceable>
</term>
<listitem><para>Name einer Ausgabedatei (leer bei Ausgabe auf Drucker).
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">landscape</replaceable>
</term>
<listitem><para>true für Querformat.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">numCopies</replaceable>
</term>
<listitem><para>Anzahl Kopien.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>setAddFilesOption</title>
<synopsis>
void setAddFilesOption(bool <replaceable class="parameter">add</replaceable>);
</synopsis>
<para>Legt Einstellung für Dateien hinzufügen fest.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">add</replaceable>
</term>
<listitem><para>true für Hinzufügen von Plot- und Datendateien zu
 existierenden Plots.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setPathOption</title>
<synopsis>
void setPathOption(bool <replaceable class="parameter">absolute</replaceable>);
</synopsis>
<para>Legt Einstellung für Abspeicherung absoluter/relativer Pfade fest.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">absolute</replaceable>
</term>
<listitem><para>true für Speichern absoluter Pfade.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setBoundingBoxOption</title>
<synopsis>
void setBoundingBoxOption(bool <replaceable class="parameter">calculate</replaceable>);
</synopsis>
<para>Legt Einstellung für Berechnung der PostScript Bounding Box fest.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">calculate</replaceable>
</term>
<listitem><para>true für automatisches Berechnen der Bounding Box.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setPageFormat</title>
<synopsis>
void setPageFormat(double <replaceable class="parameter">w</replaceable>,
                   double <replaceable class="parameter">h</replaceable>);
</synopsis>
<para>Stellt Seitenformat ein.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setColors</title>
<synopsis>
void setColors(const QString&amp; <replaceable class="parameter">colFrame</replaceable>,
               const QString&amp; <replaceable class="parameter">colGrid</replaceable>,
               const QString&amp; <replaceable class="parameter">colData</replaceable>);
</synopsis>
<para>Stellt Standardfarben ein (hexadezimalkodierte RGB-Zeichenketten, z. B.
"ff" für rot).</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">colFrame</replaceable>
</term>
<listitem><para>Farbe für Rahmen und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colGrid</replaceable>
</term>
<listitem><para>Farbe für Gitter und Tickmarken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colData</replaceable>
</term>
<listitem><para>Farbe für Linien und Symbole.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setOutputFormat</title>
<synopsis>
void setOutputFormat(const QString&amp; <replaceable class="parameter">pres</replaceable>,
                     int <replaceable class="parameter">prec</replaceable>);
</synopsis>
<para>Stellt Format für numerische Ausgaben ein.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">pres</replaceable>
</term>
<listitem><para>Darstellungszeichen entsprechend der Funktion
<function>printf()</function>.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">prec</replaceable>
</term>
<listitem><para>Genauigkeit.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setAutoplot</title>
<synopsis>
void setAutoplot(double <replaceable class="parameter">x0</replaceable>,
                 double <replaceable class="parameter">w</replaceable>,
                 double <replaceable class="parameter">y0</replaceable>,
                 double <replaceable class="parameter">h</replaceable>,
                 int <replaceable class="parameter">gridmode</replaceable>,
                 const QString&amp; <replaceable class="parameter">sx</replaceable>,
                 const QString&amp; <replaceable class="parameter">sy</replaceable>,
                 const QString&amp; <replaceable class="parameter">sh</replaceable>,
                 bool <replaceable class="parameter">pathHeading</replaceable>,
                 int <replaceable class="parameter">ix</replaceable>,
                 int <replaceable class="parameter">iy</replaceable>,
                 int <replaceable class="parameter">ie</replaceable>,
                 bool <replaceable class="parameter">logx</replaceable>,
                 bool <replaceable class="parameter">logy</replaceable>,
                 bool <replaceable class="parameter">errbars</replaceable>,
                 int <replaceable class="parameter">symb</replaceable>,
                 bool <replaceable class="parameter">autoNorm</replaceable>,
                 bool <replaceable class="parameter">autoFit</replaceable>,
                 double <replaceable class="parameter">relSize</replaceable>);
</synopsis>
<para>Setzt Autoplot-Einstellungen.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">x0</replaceable>
</term>
<listitem><para>linker Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite des Datenfensters in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y0</replaceable>
</term>
<listitem><para>unterer Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe des Datenfensters in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode</replaceable>
</term>
<listitem><para>0 für nur Rahmen, 1 für Achsen mit Tickmarken, 2 für Achsen mit
Tickmarken und Beschriftung, 3 für Gitter, 4 für Gitter mit Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sx</replaceable>
</term>
<listitem><para>x-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sy</replaceable>
</term>
<listitem><para>y-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sh</replaceable>
</term>
<listitem><para>Kopfzeilentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">pathHeading</replaceable>
</term>
<listitem><para>true für Kopfzeile = Pfad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ix</replaceable>
</term>
<listitem><para>x-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iy</replaceable>
</term>
<listitem><para>y-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ie</replaceable>
</term>
<listitem><para>Fehlerspaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logx</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logy</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errbars</replaceable>
</term>
<listitem><para>true für Zeichnen von Fehlerbalken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">symb</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,&nbsp;&gt;&nbsp;0
für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">autoNorm</replaceable>
</term>
<listitem><para>true für automatische Normierung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">autoFit</replaceable>
</term>
<listitem><para>true für automatische Parameteranpassung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Text, Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>setAutofit</title>
<synopsis>
void setAutofit(const QString&amp; <replaceable class="parameter">path</replaceable>,
                const QString&amp; <replaceable class="parameter">name</replaceable>,
                bool <replaceable class="parameter">nonLin</replaceable>,
                bool <replaceable class="parameter">errCol</replaceable>,
                const QString&amp; <replaceable class="parameter">errModPath</replaceable>,
                const QString&amp; <replaceable class="parameter">errModName</replaceable>,
                int <replaceable class="parameter">itMax</replaceable>,
                double <replaceable class="parameter">tol</replaceable>,
                int <replaceable class="parameter">symb</replaceable>,
                const QString&amp; <replaceable class="parameter">color</replaceable>,
                bool <replaceable class="parameter">showDlg</replaceable>,
                bool <replaceable class="parameter">savePar</replaceable>,
                bool <replaceable class="parameter">follow</replaceable>);
</synopsis>
<para>Setzt Autofit-Einstellungen.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absoluter Pfad der Bibliothek mit der anzupassenden Funktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">name</replaceable>
</term>
<listitem><para>Name der anzupassenden Funktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">nonLin</replaceable>
</term>
<listitem><para>true für nichtlineare Parameteranpassung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errCol</replaceable>
</term>
<listitem><para>true für Wichten der Daten durch Fehlerspalte, false für
Wichten durch Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModPath</replaceable>
</term>
<listitem><para>absoluter Pfad der Bibliothek mit der Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModName</replaceable>
</term>
<listitem><para>Name der Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">itMax</replaceable>
</term>
<listitem><para>maximale Anzahl Iterationen (nur nichtlineare Anpassung).
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">tol</replaceable>
</term>
<listitem><para>Toleranz (nur nichtlineare Anpassung).
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">symb</replaceable>
</term>
<listitem><para>Funktionsplot: 0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe für Funktionsplot.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">showDlg</replaceable>
</term>
<listitem><para>true für Anzeige des Dialogs Parameteranpassung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">savePar</replaceable>
</term>
<listitem><para>true für Speichern der resultierenden Parameter in
Dateienfiles.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">follow</replaceable>
</term>
<listitem><para>true für Parametern folgen bei Serien von Anpassungen.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>loadAutofitPar</title>
<synopsis>
bool loadAutofitPar(const QString&amp; <replaceable class="parameter">url</replaceable>);
</synopsis>
<para>Lädt Parametersatz der Autofit-Funktion von Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>setAutofitPar</title>
<synopsis>
bool setAutofitPar(int <replaceable class="parameter">iPar</replaceable>,
                   double <replaceable class="parameter">value</replaceable>);
</synopsis>
<para>Setzt Wert eines Parameters für Autofit-Funktion.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">iPar</replaceable>
</term>
<listitem><para>Parameterindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">value</replaceable>
</term>
<listitem><para>Parameterwert.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>enableFitPar</title>
<synopsis>
bool enableFitPar(int <replaceable class="parameter">iPar</replaceable>,
                  bool <replaceable class="parameter">fit</replaceable>);
</synopsis>
<para>Legt anzupassende und nicht anzupassende Parameter fest.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">iPar</replaceable>
</term>
<listitem><para>Parameterindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fit</replaceable>
</term>
<listitem><para>true stellt Parameter als anzupassend ein.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>loadErrModPar</title>
<synopsis>
bool loadErrModPar(const QString&amp; <replaceable class="parameter">url</replaceable>,
                   int iArr<replaceable class="parameter"></replaceable>);
</synopsis>
<para>Lädt Parametersatz für Fehlermodellfunktion von Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iArr</replaceable>
</term>
<listitem><para>Feldlistenindex.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>setErrModPar</title>
<synopsis>
bool setErrModPar(int <replaceable class="parameter">iPar</replaceable>,
                  double <replaceable class="parameter">value</replaceable>,
                  int iArr<replaceable class="parameter"></replaceable>);
</synopsis>
<para>Setzt Wert eines Parameters einer Fehlermodellfunktion.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">iPar</replaceable>
</term>
<listitem><para>Parameterindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">value</replaceable>
</term>
<listitem><para>Parameterwert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iArr</replaceable>
</term>
<listitem><para>Feldlistenindex.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>deleteItem</title>
<synopsis>
bool deleteItem(int <replaceable class="parameter">i</replaceable>);
</synopsis>
<para>Löscht Plot-Bestandteil.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Bestandteils.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>moveItem</title>
<synopsis>
bool moveItem(int <replaceable class="parameter">is</replaceable>,
              int <replaceable class="parameter">id</replaceable>);
</synopsis>
<para>Verschiebt Plot-Bestandteil.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">is</replaceable>
</term>
<listitem><para>Quellindex des Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">id</replaceable>
</term>
<listitem><para>Zielindex des Bestandteils.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>activateItem</title>
<synopsis>
bool activateItem(int <replaceable class="parameter">i</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Setzt Aktivierungszustand eines Plotbestandteils.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newFrameItem</title>
<synopsis>
void newFrameItem(double <replaceable class="parameter">x0</replaceable>,
                  double <replaceable class="parameter">w</replaceable>,
                  double <replaceable class="parameter">y0</replaceable>,
                  double <replaceable class="parameter">h</replaceable>,
                  double <replaceable class="parameter">xmin</replaceable>,
                  double <replaceable class="parameter">xmax</replaceable>,
                  double <replaceable class="parameter">ymin</replaceable>,
                  double <replaceable class="parameter">ymax</replaceable>,
                  bool <replaceable class="parameter">logx</replaceable>,
                  bool <replaceable class="parameter">logy</replaceable>,
                  int <replaceable class="parameter">ndigx</replaceable>,
                  int <replaceable class="parameter">ndigy</replaceable>,
                  const QString&amp; <replaceable class="parameter">colFrame</replaceable>,
                  const QString&amp; <replaceable class="parameter">colGrid</replaceable>,
                  double <replaceable class="parameter">xtic</replaceable>,
                  double <replaceable class="parameter">ytic</replaceable>,
                  int <replaceable class="parameter">mticx</replaceable>,
                  int <replaceable class="parameter">mticy</replaceable>,
                  int <replaceable class="parameter">gridmode</replaceable>,
                  int <replaceable class="parameter">iex</replaceable>,
                  int <replaceable class="parameter">iey</replaceable>,
                  const QString&amp; <replaceable class="parameter">sx</replaceable>,
                  const QString&amp; <replaceable class="parameter">sy</replaceable>,
                  const QString&amp; <replaceable class="parameter">sh</replaceable>,
                  double <replaceable class="parameter">relSize</replaceable>,
                  double <replaceable class="parameter">xOff</replaceable>,
                  double <replaceable class="parameter">yOff</replaceable>,
                  bool <replaceable class="parameter">xBottom</replaceable>,
                  bool <replaceable class="parameter">xTop</replaceable>,
                  bool <replaceable class="parameter">yLeft</replaceable>,
                  bool <replaceable class="parameter">yRight</replaceable>,
                  bool <replaceable class="parameter">collapsed</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Rahmen-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">x0</replaceable>
</term>
<listitem><para>linker Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y0</replaceable>
</term>
<listitem><para>unterer Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>x-Wert für linken Rand des Datenfensters in Benutzereinheiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>x-Wert für rechten Rand des Datenfensters in Benutzereinheiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymin</replaceable>
</term>
<listitem><para>y-Wert für unteren Rand des Datenfensters in Benutzereinheiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymax</replaceable>
</term>
<listitem><para>y-Wert für oberen Rand des Datenfensters in Benutzereinheiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logx</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logy</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigx</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigy</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colFrame</replaceable>
</term>
<listitem><para>Farbe für Rahmen und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colGrid</replaceable>
</term>
<listitem><para>Farbe für Gitter und Tickmarken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xtic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ytic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticx</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticy</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode</replaceable>
</term>
<listitem><para>0 für nur Rahmen, 1 für Achsen mit Tickmarken, 2 für Achsen mit
Tickmarken und Beschriftung, 3 für Gitter, 4 für Gitter mit Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iex</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iey</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sx</replaceable>
</term>
<listitem><para>x-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sy</replaceable>
</term>
<listitem><para>y-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sh</replaceable>
</term>
<listitem><para>Kopfzeilentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Text, Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xOff</replaceable>
</term>
<listitem><para>Offset für erste große x-Tickmarke.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yOff</replaceable>
</term>
<listitem><para>Offset für erste große y-Tickmarke.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xBottom</replaceable>
</term>
<listitem><para>true für x-Achsenbeschriftung an der unteren Seite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xTop</replaceable>
</term>
<listitem><para>true für x-Achsenbeschriftung an der oberen Seite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yLeft</replaceable>
</term>
<listitem><para>true für y-Achsenbeschriftung an der linken Seite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yRight</replaceable>
</term>
<listitem><para>true für y-Achsenbeschriftung an der rechten Seite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">collapsed</replaceable>
</term>
<listitem><para>true für kollabiert in Listenansicht.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newAutoFrameItem</title>
<synopsis>
void newAutoFrameItem();
</synopsis>
<para>Fügt neuen Rahmen-Bestandteil entsprechend den Autoplot-Einstellungen
 hinzu.</para>
</sect2>

<sect2>
<title>newArrayItem</title>
<synopsis>
bool newArrayItem(const QString&amp; <replaceable class="parameter">path</replaceable>,
                  int <replaceable class="parameter">ix</replaceable>,
                  int <replaceable class="parameter">iy</replaceable>,
                  int <replaceable class="parameter">ie</replaceable>,
                  int <replaceable class="parameter">istart</replaceable>,
                  int <replaceable class="parameter">n</replaceable>,
                  bool <replaceable class="parameter">errbars</replaceable>,
                  int <replaceable class="parameter">type</replaceable>,
                  const QString&amp; <replaceable class="parameter">color</replaceable>,
                  double <replaceable class="parameter">fx</replaceable>,
                  double <replaceable class="parameter">fy</replaceable>,
                  int <replaceable class="parameter">iDec</replaceable>,
                  int <replaceable class="parameter">fillStyle</replaceable>,
                  double <replaceable class="parameter">xOff</replaceable>,
                  double <replaceable class="parameter">yOff</replaceable>,
                  double <replaceable class="parameter">relSize</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Feld-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absoluter Pfad der Datendatei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ix</replaceable>
</term>
<listitem><para>x-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iy</replaceable>
</term>
<listitem><para>y-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ie</replaceable>
</term>
<listitem><para>Fehlerspaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">istart</replaceable>
</term>
<listitem><para>Startzeilenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">n</replaceable>
</term>
<listitem><para>Anzahl Datenpunkte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errbars</replaceable>
</term>
<listitem><para>true für Zeichnen von Fehlerbalken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe für Datenplot.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iDec</replaceable>
</term>
<listitem><para>0 für Dezimalpunkt, 1 für Komma.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefülltes Polygon.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xOff</replaceable>
</term>
<listitem><para>Offset für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yOff</replaceable>
</term>
<listitem><para>Offset für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newFunItem</title>
<synopsis>
bool newFunItem(const QString&amp; <replaceable class="parameter">path</replaceable>,
                const QString&amp; <replaceable class="parameter">name</replaceable>,
                double <replaceable class="parameter">xmin</replaceable>,
                double <replaceable class="parameter">xmax</replaceable>,
                double <replaceable class="parameter">dx</replaceable>,
                int <replaceable class="parameter">type</replaceable>,
                const QString&amp; <replaceable class="parameter">color</replaceable>,
                double <replaceable class="parameter">fx</replaceable>,
                double <replaceable class="parameter">fy</replaceable>,
                int <replaceable class="parameter">fillStyle</replaceable>,
                double <replaceable class="parameter">xOff</replaceable>,
                double <replaceable class="parameter">yOff</replaceable>,
                double <replaceable class="parameter">relSize</replaceable>,
                bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Funktions-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absoluter Pfad der Funktionsbibliothek.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">name</replaceable>
</term>
<listitem><para>Name der Funktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>minimaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>maximaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dx</replaceable>
</term>
<listitem><para>Schrittweite der Argumentenwerte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe für Funktionsplot.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefülltes Polygon.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xOff</replaceable>
</term>
<listitem><para>Offset für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yOff</replaceable>
</term>
<listitem><para>Offset für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newParFunItem</title>
<synopsis>
bool newParFunItem(const QString&amp; <replaceable class="parameter">pathx</replaceable>,
                   const QString&amp; <replaceable class="parameter">namex</replaceable>,
                   const QString&amp; <replaceable class="parameter">pathy</replaceable>,
                   const QString&amp; <replaceable class="parameter">namey</replaceable>,
                   double <replaceable class="parameter">tmin</replaceable>,
                   double <replaceable class="parameter">tmax</replaceable>,
                   double <replaceable class="parameter">dt</replaceable>,
                   int <replaceable class="parameter">type</replaceable>,
                   const QString&amp; <replaceable class="parameter">color</replaceable>,
                   double <replaceable class="parameter">fx</replaceable>,
                   double <replaceable class="parameter">fy</replaceable>,
                   int <replaceable class="parameter">fillStyle</replaceable>,
                   double <replaceable class="parameter">xOff</replaceable>,
                   double <replaceable class="parameter">yOff</replaceable>,
                   double <replaceable class="parameter">relSize</replaceable>,
                   bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Bestandteil Parametrische Funktion hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">pathx</replaceable>
</term>
<listitem><para>absoluter Pfad der Bibliothek mit derFunktion für die y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">namex</replaceable>
</term>
<listitem><para>Name der Funktion für die x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">pathy</replaceable>
</term>
<listitem><para>absoluter Pfad der Bibliothek mit der Funktion für die y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">namey</replaceable>
</term>
<listitem><para>Name der Funktion für die y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">tmin</replaceable>
</term>
<listitem><para>minimaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">tmax</replaceable>
</term>
<listitem><para>maximaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dt</replaceable>
</term>
<listitem><para>Schrittweite der Argumentenwerte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe für Funktionsplot.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefülltes Polygon.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xOff</replaceable>
</term>
<listitem><para>Offset für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yOff</replaceable>
</term>
<listitem><para>Offset für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newSplineItem</title>
<synopsis>
void newSplineItem(int <replaceable class="parameter">deriv</replaceable>,
                   double <replaceable class="parameter">low</replaceable>,
                   double <replaceable class="parameter">xmin</replaceable>,
                   double <replaceable class="parameter">xmax</replaceable>,
                   double <replaceable class="parameter">dx</replaceable>,
                   int <replaceable class="parameter">type</replaceable>,
                   const QString&amp; <replaceable class="parameter">color</replaceable>,
                   double <replaceable class="parameter">fx</replaceable>,
                   double <replaceable class="parameter">fy</replaceable>,
                   int <replaceable class="parameter">k</replaceable>,
                   int <replaceable class="parameter">fillStyle</replaceable>,
                   double <replaceable class="parameter">xOff</replaceable>,
                   double <replaceable class="parameter">yOff</replaceable>,
                   double <replaceable class="parameter">relSize</replaceable>,
                   bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Spline-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">deriv</replaceable>
</term>
<listitem><para>Ordnung der Ableitung, 0 für Funktion selbst,
-1 für Integral.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">low</replaceable>
</term>
<listitem><para>Untergrenze für Spline-Integral.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>minimaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>maximaler Wert des Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dx</replaceable>
</term>
<listitem><para>Schrittweite der Argumentenwerte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Symbols oder der Linie.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">k</replaceable>
</term>
<listitem><para>Grad des Splines
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefülltes Polygon.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xOff</replaceable>
</term>
<listitem><para>Offset für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yOff</replaceable>
</term>
<listitem><para>Offset für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Symbole und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newArray3DItem</title>
<synopsis>
bool newArray3DItem(double <replaceable class="parameter">x0</replaceable>,
                    double <replaceable class="parameter">w</replaceable>,
                    double <replaceable class="parameter">y0</replaceable>,
                    double <replaceable class="parameter">h</replaceable>,
                    double <replaceable class="parameter">xmin</replaceable>,
                    double <replaceable class="parameter">xmax</replaceable>,
                    double <replaceable class="parameter">ymin</replaceable>,
                    double <replaceable class="parameter">ymax</replaceable>,
                    double <replaceable class="parameter">zmin</replaceable>,
                    double <replaceable class="parameter">zmax</replaceable>,
                    bool <replaceable class="parameter">logx</replaceable>,
                    bool <replaceable class="parameter">logy</replaceable>,
                    bool <replaceable class="parameter">logz</replaceable>,
                    int <replaceable class="parameter">ndigx</replaceable>,
                    int <replaceable class="parameter">ndigy</replaceable>,
                    int <replaceable class="parameter">ndigz</replaceable>,
                    const QString&amp; <replaceable class="parameter">colFrame</replaceable>,
                    const QString&amp; <replaceable class="parameter">colGrid</replaceable>,
                    const QString&amp; <replaceable class="parameter">colData</replaceable>,
                    double <replaceable class="parameter">xtic</replaceable>,
                    double <replaceable class="parameter">ytic</replaceable>,
                    double <replaceable class="parameter">ztic</replaceable>,
                    int <replaceable class="parameter">mticx</replaceable>,
                    int <replaceable class="parameter">mticy</replaceable>,
                    int <replaceable class="parameter">mticz</replaceable>,
                    bool <replaceable class="parameter">frame</replaceable>,
                    int <replaceable class="parameter">gridmode</replaceable>,
                    int <replaceable class="parameter">gridmode3D</replaceable>,
                    double <replaceable class="parameter">xBox</replaceable>,
                    double <replaceable class="parameter">yBox</replaceable>,
                    double <replaceable class="parameter">zBox</replaceable>,
                    double <replaceable class="parameter">xRef</replaceable>,
                    double <replaceable class="parameter">yRef</replaceable>,
                    double <replaceable class="parameter">phi</replaceable>,
                    double <replaceable class="parameter">theta</replaceable>,
                    int <replaceable class="parameter">iex</replaceable>,
                    int <replaceable class="parameter">iey</replaceable>,
                    int <replaceable class="parameter">iez</replaceable>,
                    const QString&amp; <replaceable class="parameter">sx</replaceable>,
                    const QString&amp; <replaceable class="parameter">sy</replaceable>,
                    const QString&amp; <replaceable class="parameter">sz</replaceable>,
                    const QString&amp; <replaceable class="parameter">sh</replaceable>,
                    double <replaceable class="parameter">relSize</replaceable>,
                    const QString&amp; <replaceable class="parameter">path</replaceable>,
                    int <replaceable class="parameter">ix</replaceable>,
                    int <replaceable class="parameter">iy</replaceable>,
                    int <replaceable class="parameter">iz</replaceable>,
                    int <replaceable class="parameter">ie</replaceable>,
                    int <replaceable class="parameter">istart</replaceable>,
                    int <replaceable class="parameter">n</replaceable>,
                    bool <replaceable class="parameter">errbars</replaceable>,
                    double <replaceable class="parameter">smf</replaceable>,
                    double <replaceable class="parameter">dx</replaceable>,
                    double <replaceable class="parameter">dz</replaceable>,
                    double <replaceable class="parameter">fx</replaceable>,
                    double <replaceable class="parameter">fy</replaceable>,
                    double <replaceable class="parameter">fz</replaceable>,
                    int <replaceable class="parameter">iDec</replaceable>,
                    bool <replaceable class="parameter">collapsed</replaceable>,
                    bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen 3D-Feld-Bestandteil hinzu.</para>
<para>Parameters:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">x0</replaceable>
</term>
<listitem><para>linker Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y0</replaceable>
</term>
<listitem><para>unterer Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>minimaler x-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>maximaler x-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymin</replaceable>
</term>
<listitem><para>minimaler y-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymax</replaceable>
</term>
<listitem><para>maximaler y-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zmin</replaceable>
</term>
<listitem><para>minimaler z-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zmax</replaceable>
</term>
<listitem><para>maximaler z-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logx</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logy</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logz</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigx</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigy</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigz</replaceable>
</term>
<listitem><para>number of digits for z axis.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colFrame</replaceable>
</term>
<listitem><para>Farbe für Rahmen und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colGrid</replaceable>
</term>
<listitem><para>Farbe für Tickmarken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colData</replaceable>
</term>
<listitem><para>Farbe für Fläche.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xtic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ytic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ztic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticx</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticy</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticz</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">frame</replaceable>
</term>
<listitem><para>true für Rahmen zeichnen.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode</replaceable>
</term>
<listitem><para>0 für nur Rahmen, 1 für Achsen mit Tickmarken,
 2 für Achsen mit Tickmarken und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode3D</replaceable>
</term>
<listitem><para>0 für Linien parallel zu x, 1 für Linien parallel zu z,
 2 für x-z-Netz.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xBox</replaceable>
</term>
<listitem><para>x-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yBox</replaceable>
</term>
<listitem><para>y-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zBox</replaceable>
</term>
<listitem><para>z-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xRef</replaceable>
</term>
<listitem><para>x-Position der Mitte der Bodenfläche der Box.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yRef</replaceable>
</term>
<listitem><para>y-Position der Mitte der Bodenfläche der Box.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">phi</replaceable>
</term>
<listitem><para>Winkel für Rotation um y-Achse in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">theta</replaceable>
</term>
<listitem><para>Winkel für Neigung der y-Achse in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iex</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iey</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iez</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sx</replaceable>
</term>
<listitem><para>x-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sy</replaceable>
</term>
<listitem><para>y-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sz</replaceable>
</term>
<listitem><para>z-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sh</replaceable>
</term>
<listitem><para>Kopfzeilentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Text und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absolute path of the data file.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ix</replaceable>
</term>
<listitem><para>x-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iy</replaceable>
</term>
<listitem><para>y-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iz</replaceable>
</term>
<listitem><para>z-Spaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ie</replaceable>
</term>
<listitem><para>y-Fehlerspaltenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">istart</replaceable>
</term>
<listitem><para>Startzeilenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">n</replaceable>
</term>
<listitem><para>Anzahl Datenpunkte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errbars</replaceable>
</term>
<listitem><para>true für Gewichten der y-Werte mit Fehlerbalken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">smf</replaceable>
</term>
<listitem><para>Glättungsfaktor.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dx</replaceable>
</term>
<listitem><para>x-Netzlinienschrittweite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dz</replaceable>
</term>
<listitem><para>z-Netzlinienschrittweite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fz</replaceable>
</term>
<listitem><para>Normierungsfaktor für z-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iDec</replaceable>
</term>
<listitem><para>0 für Dezimalpunkt, 1 für Komma.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">collapsed</replaceable>
</term>
<listitem><para>true für kollabiert in Listenansicht.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newFun3DItem</title>
<synopsis>
bool newFun3DItem(double <replaceable class="parameter">x0</replaceable>,
                  double <replaceable class="parameter">w</replaceable>,
                  double <replaceable class="parameter">y0</replaceable>,
                  double <replaceable class="parameter">h</replaceable>,
                  double <replaceable class="parameter">xmin</replaceable>,
                  double <replaceable class="parameter">xmax</replaceable>,
                  double <replaceable class="parameter">ymin</replaceable>,
                  double <replaceable class="parameter">ymax</replaceable>,
                  double <replaceable class="parameter">zmin</replaceable>,
                  double <replaceable class="parameter">zmax</replaceable>,
                  bool <replaceable class="parameter">logx</replaceable>,
                  bool <replaceable class="parameter">logy</replaceable>,
                  bool <replaceable class="parameter">logz</replaceable>,
                  int <replaceable class="parameter">ndigx</replaceable>,
                  int <replaceable class="parameter">ndigy</replaceable>,
                  int <replaceable class="parameter">ndigz</replaceable>,
                  const QString&amp; <replaceable class="parameter">colFrame</replaceable>,
                  const QString&amp; <replaceable class="parameter">colGrid</replaceable>,
                  const QString&amp; <replaceable class="parameter">colData</replaceable>,
                  double <replaceable class="parameter">xtic</replaceable>,
                  double <replaceable class="parameter">ytic</replaceable>,
                  double <replaceable class="parameter">ztic</replaceable>,
                  int <replaceable class="parameter">mticx</replaceable>,
                  int <replaceable class="parameter">mticy</replaceable>,
                  int <replaceable class="parameter">mticz</replaceable>,
                  bool <replaceable class="parameter">frame</replaceable>,
                  int <replaceable class="parameter">gridmode</replaceable>,
                  int <replaceable class="parameter">gridmode3D</replaceable>,
                  double <replaceable class="parameter">xBox</replaceable>,
                  double <replaceable class="parameter">yBox</replaceable>,
                  double <replaceable class="parameter">zBox</replaceable>,
                  double <replaceable class="parameter">xRef</replaceable>,
                  double <replaceable class="parameter">yRef</replaceable>,
                  double <replaceable class="parameter">phi</replaceable>,
                  double <replaceable class="parameter">theta</replaceable>,
                  int <replaceable class="parameter">iex</replaceable>,
                  int <replaceable class="parameter">iey</replaceable>,
                  int <replaceable class="parameter">iez</replaceable>,
                  const QString&amp; <replaceable class="parameter">sx</replaceable>,
                  const QString&amp; <replaceable class="parameter">sy</replaceable>,
                  const QString&amp; <replaceable class="parameter">sz</replaceable>,
                  const QString&amp; <replaceable class="parameter">sh</replaceable>,
                  double <replaceable class="parameter">relSize</replaceable>,
                  const QString&amp; <replaceable class="parameter">path</replaceable>,
                  const QString&amp; <replaceable class="parameter">name</replaceable>,
                  double <replaceable class="parameter">dx</replaceable>,
                  double <replaceable class="parameter">dz</replaceable>,
                  double <replaceable class="parameter">fx</replaceable>,
                  double <replaceable class="parameter">fy</replaceable>,
                  double <replaceable class="parameter">fz</replaceable>,
                  bool <replaceable class="parameter">collapsed</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen 3D-Funktions-Bestandteil hinzu.</para>
<para>Parameters:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">x0</replaceable>
</term>
<listitem><para>linker Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y0</replaceable>
</term>
<listitem><para>unterer Seitenrand in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>minimaler x-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>maximaler x-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymin</replaceable>
</term>
<listitem><para>minimaler y-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ymax</replaceable>
</term>
<listitem><para>maximaler y-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zmin</replaceable>
</term>
<listitem><para>minimaler z-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zmax</replaceable>
</term>
<listitem><para>maximaler z-Wert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logx</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logy</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">logz</replaceable>
</term>
<listitem><para>true für logarithmische Skalierung der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigx</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigy</replaceable>
</term>
<listitem><para>Anzahl Nachkommastellen für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ndigz</replaceable>
</term>
<listitem><para>number of digits for z axis.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colFrame</replaceable>
</term>
<listitem><para>Farbe für Rahmen und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colGrid</replaceable>
</term>
<listitem><para>Farbe für Tickmarken.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colData</replaceable>
</term>
<listitem><para>Farbe für Fläche.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xtic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ytic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">ztic</replaceable>
</term>
<listitem><para>Abstand zwischen großen Tickmarken der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticx</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticy</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">mticz</replaceable>
</term>
<listitem><para>Anzahl Intervalle zwischen großen Tickmarken der z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">frame</replaceable>
</term>
<listitem><para>true für Rahmen zeichnen.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode</replaceable>
</term>
<listitem><para>0 für nur Rahmen, 1 für Achsen mit Tickmarken,
 2 für Achsen mit Tickmarken und Beschriftung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">gridmode3D</replaceable>
</term>
<listitem><para>0 für Linien parallel zu x, 1 für Linien parallel zu z,
 2 für x-z-Netz.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xBox</replaceable>
</term>
<listitem><para>x-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yBox</replaceable>
</term>
<listitem><para>y-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">zBox</replaceable>
</term>
<listitem><para>z-Boxlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xRef</replaceable>
</term>
<listitem><para>x-Position der Mitte der Bodenfläche der Box.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yRef</replaceable>
</term>
<listitem><para>y-Position der Mitte der Bodenfläche der Box.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">phi</replaceable>
</term>
<listitem><para>Winkel für Rotation um y-Achse in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">theta</replaceable>
</term>
<listitem><para>Winkel für Neigung der y-Achse in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iex</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für x-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iey</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für y-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iez</replaceable>
</term>
<listitem><para>Logarithmus des Normierungsfaktors für z-Achse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sx</replaceable>
</term>
<listitem><para>x-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sy</replaceable>
</term>
<listitem><para>y-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sz</replaceable>
</term>
<listitem><para>z-Achsentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">sh</replaceable>
</term>
<listitem><para>Kopfzeilentext.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Größe für Text und Linienbreiten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absoluter Pfad der Funktionsbibliothek.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">name</replaceable>
</term>
<listitem><para>Name der Funktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dx</replaceable>
</term>
<listitem><para>Schrittweite des x-Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dz</replaceable>
</term>
<listitem><para>Schrittweite des z-Arguments.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>Normierungsfaktor für x-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>Normierungsfaktor für y-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fz</replaceable>
</term>
<listitem><para>Normierungsfaktor für z-Werte.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">collapsed</replaceable>
</term>
<listitem><para>true für kollabiert in Listenansicht.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>newImageItem</title>
<synopsis>
void newImageItem(const QString&amp; <replaceable class="parameter">path</replaceable>,
                  double <replaceable class="parameter">x</replaceable>,
                  double <replaceable class="parameter">y</replaceable>,
                  double <replaceable class="parameter">fx</replaceable>,
                  double <replaceable class="parameter">fy</replaceable>,
                  double <replaceable class="parameter">dir</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Bild-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">path</replaceable>
</term>
<listitem><para>absoluter Pfad der EPS-Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fx</replaceable>
</term>
<listitem><para>horizontaler Skalierungsfaktor.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fy</replaceable>
</term>
<listitem><para>vertikaler Skalierungsfaktor.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Rotationswinkel in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newLegendItem</title>
<synopsis>
void newLegendItem(int <replaceable class="parameter">type</replaceable>,
                   const QString&amp; <replaceable class="parameter">colSymb</replaceable>,
                   double <replaceable class="parameter">x</replaceable>,
                   double <replaceable class="parameter">y</replaceable>,
                   const QString&amp; <replaceable class="parameter">text</replaceable>,
                   const QString&amp; <replaceable class="parameter">colText</replaceable>,
                   double <replaceable class="parameter">xoff</replaceable>,
                   double <replaceable class="parameter">yoff</replaceable>,
                   double <replaceable class="parameter">relSize</replaceable>,
                   double <replaceable class="parameter">symbolSize</replaceable>,
                   bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Legenden-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>0 für Kreise, &lt; 0 für verschiedene Symbole,
&nbsp;&gt;&nbsp;0 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colSymb</replaceable>
</term>
<listitem><para>Farbe des Symbols oder der Linie.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">text</replaceable>
</term>
<listitem><para>Text.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">colText</replaceable>
</term>
<listitem><para>Farbe des Texts.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xoff</replaceable>
</term>
<listitem><para>x-Offset des Texts in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yoff</replaceable>
</term>
<listitem><para>y-Offset des Texts in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Zeichengröße.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">symbolSize</replaceable>
</term>
<listitem><para>relative Symbolgröße.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newTextItem</title>
<synopsis>
void newTextItem(const QString&amp; <replaceable class="parameter">text</replaceable>,
                 const QString&amp; <replaceable class="parameter">color</replaceable>,
                 int <replaceable class="parameter">align</replaceable>,
                 double <replaceable class="parameter">x</replaceable>,
                 double <replaceable class="parameter">y</replaceable>,
                 double <replaceable class="parameter">dir</replaceable>,
                 double <replaceable class="parameter">relSize</replaceable>,
                 bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Text-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">text</replaceable>
</term>
<listitem><para>Text.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Texts.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">align</replaceable>
</term>
<listitem><para>1: linksbündig, 2: zentriert, 3: rechtsbündig.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Richtung in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>Relative Zeichengröße.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newLineItem</title>
<synopsis>
void newLineItem(int <replaceable class="parameter">type</replaceable>,
                 const QString&amp; <replaceable class="parameter">color</replaceable>,
                 double <replaceable class="parameter">x</replaceable>,
                 double <replaceable class="parameter">y</replaceable>,
                 double <replaceable class="parameter">dir</replaceable>,
                 double <replaceable class="parameter">len</replaceable>,
                 double <replaceable class="parameter">relSize</replaceable>,
                 bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Linien-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>1 bis 9 für verschiedene Linienarten.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe der Linie.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x Startposition in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y Startposition in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Richtung in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">len</replaceable>
</term>
<listitem><para>Länge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>Relative Breite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newArrowItem</title>
<synopsis>
void newArrowItem(const QString&amp; <replaceable class="parameter">color</replaceable>,
                  double <replaceable class="parameter">x</replaceable>,
                  double <replaceable class="parameter">y</replaceable>,
                  double <replaceable class="parameter">dir</replaceable>,
                  double <replaceable class="parameter">len</replaceable>,
                  double <replaceable class="parameter">relSize</replaceable>,
                  bool <replaceable class="parameter">doubleHeaded</replaceable>,
                  bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Pfeil-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Pfeils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x Position der Spitze in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y Position der Spitze in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Richtung in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">len</replaceable>
</term>
<listitem><para>Gesamtlänge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>Relative Größe der Pfeilspitze.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">doubleHeaded</replaceable>
</term>
<listitem><para>true für zweispitzigen Pfeil.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newArcItem</title>
<synopsis>
void newArcItem(const QString&amp; <replaceable class="parameter">color</replaceable>,
                double <replaceable class="parameter">x</replaceable>,
                double <replaceable class="parameter">y</replaceable>,
                double <replaceable class="parameter">w</replaceable>,
                double <replaceable class="parameter">h</replaceable>,
                double <replaceable class="parameter">start</replaceable>,
                double <replaceable class="parameter">span</replaceable>,
                double <replaceable class="parameter">relSize</replaceable>,
                double <replaceable class="parameter">dir</replaceable>,
                bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Ellipsenbogen-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Bogens.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position des Mittelpunkts in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position des Mittelpunkts in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite der Ellipse in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe der Ellipse in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">start</replaceable>
</term>
<listitem><para>Anfangswinkel in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">span</replaceable>
</term>
<listitem><para>Länge in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Linienbreite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Rotationswinkel in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newRectangleItem</title>
<synopsis>
void newRectangleItem(const QString&amp; <replaceable class="parameter">color</replaceable>,
                      double <replaceable class="parameter">x</replaceable>,
                      double <replaceable class="parameter">y</replaceable>,
                      double <replaceable class="parameter">w</replaceable>,
                      double <replaceable class="parameter">h</replaceable>,
                      double <replaceable class="parameter">relSize</replaceable>,
                      int <replaceable class="parameter">fillStyle</replaceable>,
                      double <replaceable class="parameter">dir</replaceable>,
                      bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Rechteck-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Rechtecks.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position der linken Seite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position der unteren Seite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Linienbreite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefülltes Polygon.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Rotationswinkel in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newEllipseItem</title>
<synopsis>
void newEllipseItem(const QString&amp; <replaceable class="parameter">color</replaceable>,
                    double <replaceable class="parameter">x</replaceable>,
                    double <replaceable class="parameter">y</replaceable>,
                    double <replaceable class="parameter">w</replaceable>,
                    double <replaceable class="parameter">h</replaceable>,
                    double <replaceable class="parameter">relSize</replaceable>,
                    int <replaceable class="parameter">fillStyle</replaceable>,
                    double <replaceable class="parameter">dir</replaceable>,
                    bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Ellipsen-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe der Ellipse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position des Zentrums in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position des Zentrums in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">w</replaceable>
</term>
<listitem><para>Breite in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">h</replaceable>
</term>
<listitem><para>Höhe in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Linienbreite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">fillStyle</replaceable>
</term>
<listitem><para>&gt;&nbsp;0 für Darstellung als gefüllte Ellipse.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">dir</replaceable>
</term>
<listitem><para>Rotationswinkel in Grad.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>newScaleBarItem</title>
<synopsis>
void newScaleBarItem(const QString&amp; <replaceable class="parameter">str</replaceable>,
                     const QString&amp; <replaceable class="parameter">color</replaceable>,
                     double <replaceable class="parameter">x</replaceable>,
                     double <replaceable class="parameter">y</replaceable>,
                     double <replaceable class="parameter">len</replaceable>,
                     double <replaceable class="parameter">relSize</replaceable>,
                     bool <replaceable class="parameter">vertical</replaceable>,
                     bool <replaceable class="parameter">active</replaceable>);
</synopsis>
<para>Fügt neuen Maßstabs-Bestandteil hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">str</replaceable>
</term>
<listitem><para>Text.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable>
</term>
<listitem><para>Farbe des Maßstabs.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">x</replaceable>
</term>
<listitem><para>x-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">y</replaceable>
</term>
<listitem><para>y-Position in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">len</replaceable>
</term>
<listitem><para>Länge in cm.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">relSize</replaceable>
</term>
<listitem><para>relative Linienbreite.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">vertical</replaceable>
</term>
<listitem><para>false für horizontal, true für vertikal.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">active</replaceable>
</term>
<listitem><para>true für sichtbaren Bestandteil.
</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>autoScaleFrame</title>
<synopsis>
bool autoScaleFrame(int <replaceable class="parameter">i</replaceable>,
                    bool <replaceable class="parameter">autoNorm</replaceable>);
</synopsis>
<para>Skaliert Rahmen automatisch gemäß allen zugehörigen Bestandteilen.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Rahmen-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">autoNorm</replaceable>
</term>
<listitem><para>true für zusätzliche automatische Normierung.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>loadPar</title>
<synopsis>
bool loadPar(const QString&amp; <replaceable class="parameter">url</replaceable>,
             int <replaceable class="parameter">i</replaceable>,
             bool <replaceable class="parameter">yFun</replaceable>);
</synopsis>
<para>Lädt Parametersatz für Funktion von Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Funktions-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yFun</replaceable>
</term>
<listitem><para>true für y-Funktionsparameter, false für x-Funktionsparameter
 (nur für parametrische Funktionen).
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>setPar</title>
<synopsis>
bool setPar(int <replaceable class="parameter">i</replaceable>,
            int <replaceable class="parameter">iPar</replaceable>,
            double <replaceable class="parameter">value</replaceable>,
            bool <replaceable class="parameter">yFun</replaceable>);
</synopsis>
<para>Setzt Wert eines Funktionsparameters.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Funktions-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iPar</replaceable>
</term>
<listitem><para>Parameterindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">value</replaceable>
</term>
<listitem><para>Parameterwert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">yFun</replaceable>
</term>
<listitem><para>true für y-Funktionsparameter, false für x-Funktionsparameter
 (nur für parametrische Funktionen).
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>setArrayRange</title>
<synopsis>
bool setArrayRange(int <replaceable class="parameter">i</replaceable>,
                   int <replaceable class="parameter">iStart</replaceable>,
                   int <replaceable class="parameter">n</replaceable>);
</synopsis>
<para>Legt Zeilenbereich eines Felds fest.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">i</replaceable>
</term>
<listitem><para>Index des Feld-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iStart</replaceable>
</term>
<listitem><para>Startzeilenindex.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">n</replaceable>
</term>
<listitem><para>Anzahl Datenpunkte.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>addFitItems</title>
<synopsis>
bool addFitItems(bool <replaceable class="parameter">erase</replaceable>,
                 int <replaceable class="parameter">iArr</replaceable>,
                 int <replaceable class="parameter">iFun</replaceable>,
                 bool <replaceable class="parameter">errCol</replaceable>,
                 const QString&amp; <replaceable class="parameter">errModPath</replaceable>,
                 const QString&amp; <replaceable class="parameter">errModName</replaceable>);
</synopsis>
<para>Fügt Feld- und Funktions-Bestandteile zu Listen für (multidimensionale)
 Parameteranpassung hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">erase</replaceable>
</term>
<listitem><para>true: löscht Liste vorher.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iArr</replaceable>
</term>
<listitem><para>Index des Feld-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iFun</replaceable>
</term>
<listitem><para>Index des Funktionsbestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errCol</replaceable>
</term>
<listitem><para>true für Wichten der Daten entsprechend Fehlerspalte, false für
Wichten entsprechend Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModPath</replaceable>
</term>
<listitem><para>absoluter Pfad der Bibliothek mit der
 Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModName</replaceable>
</term>
<listitem><para>Name der Fehlermodellfunktion.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>fit</title>
<synopsis>
bool fit(bool <replaceable class="parameter">nonLin</replaceable>,
         bool <replaceable class="parameter">savePar</replaceable>,
         bool <replaceable class="parameter">follow</replaceable>);
</synopsis>
<para>Führt Parameteranpassung durch.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">nonLin</replaceable>
</term>
<listitem><para>true für nichtlineare Parameteranpassung.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">savePar</replaceable>
</term>
<listitem><para>true für Speichern der resultierenden Parameter in Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">follow</replaceable>
</term>
<listitem><para>true für Parametern folgen bei Serienanpassungen.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>addSplineFitItems</title>
<synopsis>
bool addSplineFitItems(bool <replaceable class="parameter">erase</replaceable>,
                       int <replaceable class="parameter">iSpl</replaceable>);
</synopsis>
<para>Fügt Spline-Bestandteile zu einer Liste für Spline-Anpassung
hinzu.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">erase</replaceable>
</term>
<listitem><para>true: löscht Liste vorher.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iSpl</replaceable>
</term>
<listitem><para>Index des Spline-Bestandteils.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>splineFit</title>
<synopsis>
bool splineFit(int <replaceable class="parameter">iArr</replaceable>,
               int <replaceable class="parameter">deg</replaceable>,
               double <replaceable class="parameter">smf</replaceable>,
               double <replaceable class="parameter">xmin</replaceable>,
               double <replaceable class="parameter">xmax</replaceable>,
               bool <replaceable class="parameter">errCol</replaceable>,
               const QString&amp; <replaceable class="parameter">errModPath</replaceable>,
               const QString&amp; <replaceable class="parameter">errModName</replaceable>);
</synopsis>
<para>Führt Anpassung eines glättenden Splines durch.</para>
<para>Parameters:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">iArr</replaceable>
</term>
<listitem><para>Index des Feld-Bestandteils.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">deg</replaceable>
</term>
<listitem><para>Grad des Splines.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">smf</replaceable>
</term>
<listitem><para>Glättungsfaktor.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmin</replaceable>
</term>
<listitem><para>Untergrenze des Approximationsintervalls.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">xmax</replaceable>
</term>
<listitem><para>Obergrenze des Approximationsintervalls.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errCol</replaceable>
</term>
<listitem><para>true für Wichten der Daten entsprechend Fehlerspalte,
 false für Wichten entsprechend Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModPath</replaceable>
</term>
<listitem><para>Absoluter Pfad der Bibliothek mit der Fehlermodellfunktion.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">errModName</replaceable>
</term>
<listitem><para>Name der Fehlermodellfunktion.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>chiSquare</title>
<synopsis>
double chiSquare();
</synopsis>
<para>Gibt Chi-Quadrat-Wert der letzen Parameteranpassung zurück.</para>
<para>Rückgabewert: Chi-Quadrat.
</para>
</sect2>

<sect2>
<title>saveFitPar</title>
<synopsis>
bool saveFitPar(const QString&amp; <replaceable class="parameter">url</replaceable>);
</synopsis>
<para>Speichert aus einer Anpassung resultierende Parameter und ihre Fehler
 in einer Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

<sect2>
<title>exportValues</title>
<synopsis>
bool exportValues(const QString&amp; <replaceable class="parameter">url</replaceable>,
                  int <replaceable class="parameter">iItem</replaceable>);
</synopsis>
<para>Exportiert Funktionswertetabelle in Datei.</para>
<para>Parameter:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL der Datei.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">iItem</replaceable>
</term>
<listitem><para>Index des Funktions-Bestandteils.
</para></listitem>
</varlistentry>
</variablelist>
<para>Rückgabewert: true bei Erfolg.
</para>
</sect2>

</sect1>

</chapter>

<chapter id="faq">
<title>Fragen und Antworten</title>

<para></para>

<qandaset id="faqlist">
<qandaentry>
<question>
<para>Die automatische Berechnung der Bounding Box für PostScript-Dateien
funktioniert nicht richtig. Die berechneten Werte schneiden Teile des Plots ab.
Woran liegt das?</para>
</question>
<answer>
<para>Zum richtigen Funktionieren muß das <guilabel>Seitenformat</guilabel> auf
der Seite <link linkend="basic">Grundeinstellungen</link> im Dialog
<link linkend="settings">Einrichten</link> genügend groß eingestellt sein, denn
&kpl; sucht in dieser Fläche nach dem kleinsten, alle Teile des Plots
enthaltenden Rechteck.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Warum endet mein Plot einer Datendatei mit einer Linie zum Ursprung,
obwohl der letzte Punkt in der Datei nicht die Koordinaten (0, 0) hat?</para>
</question>
<answer>
<para>Ihre Datendatei scheint mit einigen unsichtbaren, aber störenden Zeichen
zu enden. Löschen Sie diese Zeichen!</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Warum beginnt das Strichmuster von aufeinanderfolgenden Kurven nicht beim
gleichen Punkt?</para>
</question>
<answer>
<para>Dies erlaubt das Plotten einer Kurve aus mehreren Stücken (mit z. B.
unterschiedlicher Schrittweite des Funktionsarguments) ohne "Sprünge" im
Strichmuster. Sie können die Strichmusterposition durch Einfügen von Legenden
(unsichtbar mit Symbol -17 und leerem Text) vor den entsprechenden
Bestandteilen zurücksetzen.</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title>Danksagung und Lizenz</title>

<para>
&kpl;
</para>
<para>
Copyright für das Programm &copy; 2011 Werner Stille
<email>stille@uni-freiburg.de</email>
</para>
<para>
Copyright für die Dokumentation &copy; 2011 Werner Stille
<email>stille@uni-freiburg.de</email>
</para>

<para>
Dank an
<itemizedlist>
<listitem><para>das KDevelop-Team für die Entwicklungsumgebung, die das
KDE-Programmieren sehr erleichtert</para></listitem>
<listitem><para>Dimi Shahbaz <email>dshahbaz@ucla.edu</email> für Vorschläge
und Änderungen</para></listitem>
<listitem><para>Jürgen Siepmann <email>siepmann@kanzlei-siepmann.de</email> für
Tests und Kritik</para></listitem>
<listitem><para>Wojciech Migda <email>migda@chemia.uj.edu.pl</email> für die
polnische Übersetzung</para></listitem>
<listitem><para>Taiki Komoda <email>kom@kde.gr.jp</email> für die japanische
Übersetzung</para></listitem>
<listitem><para>Alan Mizrahi <email>alan@ldc.usb.ve</email> für die spanische
Übersetzung</para></listitem>
<listitem><para>Paul Dierckx <email>Paul.Dierckx@cs.kuleuven.ac.be</email> für
FITPACK, die Sammlung von FORTRAN-Programmen beschrieben in seinem Buch "Curve
and Surface Fitting with Splines", Oxford University Press, 1993 (Versionen in
C++ einiger FITPACK-Funktionen werden in Kpl genutzt)</para></listitem>
</itemizedlist>
</para>

&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->
</chapter>

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

<sect1 id="getting-kpl">
<title>Woher bekommt man &kpl;?</title>

<para>
&kpl; kann auf seiner Homepage
<ulink url="http://omnibus.uni-freiburg.de/~stille/kpl/index.html">
http://omnibus.uni-freiburg.de/~stille/kpl/index.html</ulink> gefunden
werden.</para>
</sect1>

<sect1 id="requirements">
<title>Voraussetzungen</title>

<para>
Um &kpl; erfolgreich einzusetzen, benötigen Sie KDE. Der PostScript-Interpreter
<application>Ghostscript</application> wird für das automatische Berechnen der
Bounding Box von erzeugten PostScript-Dateien benötigt.
</para>

</sect1>

<sect1 id="compilation">
<title>Übersetzen und Installieren</title>
&install.compile.documentation;
</sect1>

</appendix>

&documentation.index;
</book>
