<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>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>$TDEHOME/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>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>
