<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> <arg>--date <replaceable>"4 July 1976 12:30:00"</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 nicht erkannt wird, ist der Standard <acronym>PNG</acronym>. </para>
<para>Genauso wird die Bildgrößen auf 640 bzw. 480 eingestellt, wenn die Höhe und die Breite nicht angegeben werden. </para>
<para>Standardmäßig liest &kstars; die Werte, die in der Datei <filename>$TDEHOME/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, um dann das Programm so zu beenden, 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, sollte ein gültiges &kstars;-<acronym>DCOP</acronym>-Skript sein, wie sie der <link linkend="tool-scriptbuilder">Skriptbaukasten</link> erzeugt. Das Skript kann benutzt werden, um die Position anzugeben, auf die das Bild zeigt, um den Standort 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 Standard verwendet &kstars; die auf Ihren Computer eingestellte Zeit, um das Bild zu erzeugen. Alternativ können Sie Datum und Zeit mit den Argument <quote>date</quote> vorgeben. Sie können dieses Argument auch beim normalen Start des Programms benutzen. </para>

</chapter>
