<chapter id="dumpmode">
<title
>Modo da liña de comandos para a xeración de imaxes</title>
<indexterm
><primary
>Modo de emborcado de imaxes</primary
></indexterm>

<para
>Pódese empregar o &kstars; para xerar unha imaxe do ceo sen realmente lanzar a parte <acronym
>GUI</acronym
> do programa. Para utilizar esta funcionalidade hai que iniciar o &kstars; desde unha liña de comandos empregando argumentos para especificar o nome do ficheiro da imaxe, así como as dimensións que se desexan para a imaxe: <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
>omeuscript.kstars</replaceable
></arg
> <arg
>--date <replaceable
>"4 de xullo de 1976 12:30:00"</replaceable
></arg
> </cmdsynopsis>
</para>
<para
>Se non se especifica un nome de ficheiro xérase un ficheiro chamado <filename
>kstars.png</filename
>. Tentarase xerar unha imaxe que corresponda coa extensión do nome do ficheiro. Recoñécense as extensións seguintes: <quote
>png</quote
>, <quote
>jpg</quote
>, <quote
>jpeg</quote
>, <quote
>gif</quote
>, <quote
>pnm</quote
> e <quote
>bmp</quote
>. Se non se recoñece a extensión do nome do ficheiro, por omisión será o tipo de imaxe <quote
>PNG</quote
>. </para>
<para
>Igualmente, se non se especifican a anchura e a altura, por omisión serán 640 e 480, respectivamente. </para>
<para
>By default, &kstars; will read in the options values stored in your <filename
>$KDEHOME/share/config/kstarsrc</filename
> file to determine where the image will be centered, and how it is rendered. This means you need to run &kstars; in normal GUI mode, and exit the program when it is set up with the desired options for the generated images. This is not very flexible, so we also provide the ability to execute a &kstars; <acronym
>DCOP</acronym
> script to set the scene before generating the image. The filename you specify as the script argument should be a valid &kstars; <acronym
>DCOP</acronym
> script, such as one created with the <link linkend="tool-scriptbuilder"
>Script Builder Tool</link
>. The script can be used to set where the image is pointing, set the geographic location, set the time and date, change the Zoom level, and adjust other view options. Some of the <acronym
>DCOP</acronym
> functions make no sense in non-GUI mode (such as <function
>waitForKey()</function
>); if these functions are encountered while parsing the script, they are simply ignored. </para>
<para
>Por omisión, o &kstars; utilizará a hora e a data da CPU do sistema para xerar a imaxe. Como alternativa, pódense especificar unha hora e data co argumento <quote
>--date</quote
>. Tamén se pode empregar este argumento para especificar a data de arranque no modo GUI normal. </para>

</chapter>