<chapter id="dumpmode">
<title
>Mode línia d'ordres per a la generació d'imatges</title>
<indexterm
><primary
>Mode volcat de la imatge</primary
></indexterm>

<para
>Podeu usar &kstars; per a generar una imatge del cel sense necessitat de carregar la porció <acronym
>IGU</acronym
> del programa. Per a usar aquesta característica, engegueu &kstars; des de l'indicatiu d'ordres emprant els arguments per a especificar el nom de fitxer per a la imatge, així com les dimensions que voleu per a la mateixa: <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
>el_meu_script.kstars</replaceable
></arg
> <arg
>--date <replaceable
>"4 de juliol de 1976 12:30:00"</replaceable
></arg
> </cmdsynopsis>
</para>
<para
>Si no s'especifica un nom de fitxer, aquest generarà un fitxer anomenat <filename
>kstars.png</filename
>. Intentarà generar una imatge que cassi amb l'extensió del vostre nom de fitxer. Es reconeixen les següents extensions: «png», «jpg», «jpeg», «gif», «pnm» i «bmp». Si l'extensió del nom de fitxer no es reconeix, es deixarà el tipus d'imatge al format per omissió <acronym
>PNG</acronym
>. </para>
<para
>Tanmateix, si no s'especifiquen l'amplada i alçada de la imatge, es deixarà 640 i 480, respectivament. </para>
<para
>Per omissió, &kstars; llegirà en els valors d'opcions desats al vostre fitxer <filename
>$KDEHOME/share/config/kstarsrc</filename
> per a determinar a on centrar la imatge i com renderitzar-la. Això significa que necessitareu engegar &kstars; en mode IGU normal i eixir del programa quan s'estableixin les opcions desitjades per a prendre les imatges. Això no és molt flexible, així que també proporcionem la capacitat d'executar un script &DBus; del &kstars; per a establir l'escena abans de generar la imatge. El nom de fitxer que especifiqueu haurà de ser un script &DBus; del &kstars; vàlid, tal com un de creat amb l'<link linkend="tool-scriptbuilder"
>eina de constructor d'scripts</link
>. L'script es pot usar per a establir cap a on apunta la imatge, establir l'emplaçament geogràfic, establir l'hora i la data, canviar el nivell d'apropament i ajustar altres opcions de la vista. Algunes de les funcions &DBus; no tenen cap sentit en el mode sense IGU (com ara <function
>waitForKey()</function
>); si es troben aquestes funcions mentre analitzeu l'script, simplement seran omeses. </para>
<para
>Per omissió, &kstars; usarà la data i hora del sistema per a generar la imatge. Alternativament, podeu especificar una data i una hora amb l'argument «--date». També podreu usar aquest argument per especificar l'hora inicial en el mode IGU (interfície gràfica d'usuari) normal. </para>

</chapter>
