<chapter id="dumpmode">
<title
>Kommandozeilenbetrieb für Bilderzeugung</title>
<indexterm
><primary
>Bilderzeugungsmodus</primary
></indexterm>

<para
>Sie können &kstars; benutzen, um ein Bild des Himmels zu erzeugen, ohne die Oberfläche des Programms zu starten. Um dies zu nutzen, starten Sie &kstars; von einer Kommandozeile mit Argumenten, die den Dateinamen für das Bild und die gewünschten Bilddimensionen angeben: <cmdsynopsis
><command
>kstars</command
> <arg choice="plain"
>--dump</arg
> <arg
>--filename <replaceable
>kstars.png</replaceable
></arg
> <arg
>--height <replaceable
>640</replaceable
></arg
> <arg
>--width <replaceable
>480</replaceable
></arg
> <arg
>--script <replaceable
>myscript.kstars</replaceable
></arg
> </cmdsynopsis>
</para>
<para
>Wenn kein Dateiname angegeben wird, wird eine Datei namens <filename
>kstars.png</filename
> erzeugt. Es wird versucht, ein Bild des Typs zu erzeugen, den die Erweiterung verlangt. Die folgenden Erweiterungen werden erkannt: <quote
>png</quote
>, <quote
>jpg</quote
>, <quote
>jpeg</quote
>, <quote
>gif</quote
>, <quote
>pnm</quote
> und <quote
>bmp</quote
>. Falls die Dateierweiterung nichterkannt wird, ist der Standard <acronym
>PNG</acronym
>. </para>
<para
>Genauso sind die Bildgrößen 640 bzw. 480, wenn die Höhe und die Breite nicht angegeben werden. </para>
<para
>Standardmäßig liest &kstars; die Werte, die in der Datei <filename
>$KDEHOME/share/config/kstarsrc</filename
> gespeichert sind, um zu bestimmen, wo das Bild zentriert wird und wie es gezeichnet werden soll. Das bedeutet, dass Sie &kstars; in normalem Modus starten müssen, un dann das Programm so beenden müssen, wenn das Bild so aussieht, wie Sie es möchten. Das ist nicht so flexibel, also bieten wir die Möglichkeit ein &kstars;-<acronym
>DCOP</acronym
>-Skript auszuführen, bevor das Bild erstellt wird. Der Dateiname, den Sie als Skriptargument angeben, sollt ein gültiges &kstars;-<acronym
>DCOP</acronym
>-Skript sein, wie die, die der <link linkend="tool-scriptbuilder"
>Skriptbaukasten</link
> erzeugt. Das Skript kann benutzt werden, um die Position anzugeben, auf die das Bild zeigt, um den Ort und die Zeit einzustellen, die Vergrößerung oder andere Ansichtseinstellungen. Einige der <acronym
>DCOP</acronym
>-Funktionen machen keinen Sinn im Modus ohne Oberfläche (wie <function
>waitForKey()</function
>); Falls solche Funktion gefunden werden, werden Sie einfach ignoriert. </para>
<para
>Als eine Alternative zu einem &kstars;-<acronym
>DCOP</acronym
>-Skript werden wir in Zukunft ein Argument bieten, das eine Konfigurationsdatei in Form einer <filename
>kstarsrc</filename
> annimmt. </para>

</chapter>
