<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
> </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
>Por omissão, o &kstars; irá ler os valores das opções guardados no seu ficheiro <filename
>$KDEHOME/share/config/kstarsrc</filename
> para determinar onde a imagem será centrada e como será desenhada. Isto significa que você terá de correr o &kstars; no modo gráfico normal e sair do programa quando estiver configurado com as opções desejadas para as imagens geradas. Isto não é muito flexível, como tal oferecemos também a possibilidade de executar um 'script' para o &kstars; em <acronym
>DCOP</acronym
> para configurar a cena antes de gerar a imagem. O nome do ficheiro que indicar como argumento do 'script' deverá ser um programa em <acronym
>DCOP</acronym
> válido para o &kstars;, como os que são criados com a <link linkend="tool-scriptbuilder"
>Ferramenta de Construção de 'Scripts'</link
>. O programa poderá ser usado para definir aonde é que a imagem está a apontar, definir a posição geográfica, a hora e a data, mudar o nível de Zoom e ajustar outras opções de visualização. Algumas das funções de <acronym
>DCOP</acronym
> não fazem sentido no modo não-gráfico (como o <function
>waitForKey()</function
>); se estas funções forem encontradas ao processar o 'script', serão simplesmente ignoradas. </para>
<para
>Como alternativa a ter de executar um 'script' de <acronym
>DCOP</acronym
> do &kstars;, será oferecido um argumento para indicar um ficheiro de configuração alternativo ao <filename
>kstarsrc</filename
>, numa versão futura do &kstars;. </para>

</chapter>
