<chapter id="dumpmode">
<title
>Modo de Linha de Comandos para a Geração de Imagens</title>
<indexterm
><primary
>Modo de Geração de Imagens</primary
></indexterm>

<para
>Você poderá usar o &kstars; para gerar uma imagem do céu sem ter de lançar de facto a interface gráfica do programa. Para usar esta funcionalidade, inicie o &kstars; a partir de uma linha de comandos, usando os argumentos para indicar o nome do ficheiro da imagem, assim como as dimensões desejadas da imagem: <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
>o_meu_script.kstars</replaceable
></arg
> <arg
>--date <replaceable
>"4 July 1976 12:30:00"</replaceable
></arg
> </cmdsynopsis>
</para>
<para
>Se não for indicado nenhum nome de ficheiro, ele gera um ficheiro chamado <filename
>kstars.png</filename
>. Ele irá tentar gerar uma imagem que corresponda à extensão do seu ficheiro. São reconhecidas as seguintes extensões: <quote
>png</quote
>, <quote
>jpg</quote
>, <quote
>jpeg</quote
>, <quote
>gif</quote
>, <quote
>pnm</quote
> e <quote
>bmp</quote
>. Se a extensão do nome do ficheiro não for reconhecida ele optar pelo tipo de imagem <acronym
>PNG</acronym
>. </para>
<para
>Da mesma forma, se a largura e altura da imagem não forem indicadas, serão usados os valores respectivos 640 e 480. </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 omissão, o &kstars; irá usar a data e hora do sistema para gerar a imagem. Em alternativa, poderá indicar uma data e hora específicas com o argumento <quote
>--date</quote
>. Poderá também usar este argumento para indicar a data inicial no modo gráfico normal. </para>

</chapter>
