1 files changed, 76 insertions, 0 deletions
diff --git a/tde-i18n-pt/docs/kdeedu/kstars/dumpmode.docbook b/tde-i18n-pt/docs/kdeedu/kstars/dumpmode.docbook
new file mode 100644
index 00000000000..aa99c0729a7
--- /dev/null
+++ b/tde-i18n-pt/docs/kdeedu/kstars/dumpmode.docbook
@@ -0,0 +1,76 @@
+<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
+>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
+>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>