docs/kstars/dumpmode.docbook

0001 <chapter id="dumpmode">
0002 <title
0003 >Modo de linha de comando para geração de imagem</title>
0004 <indexterm
0005 ><primary
0006 >Modo de geração de imagem</primary
0007 ></indexterm>
0008
0009 <para
0010 >Você pode usar o &kstars; para gerar uma imagem do céu sem exibir os componentes da <acronym
0011 >GUI</acronym
0012 > do programa nesta imagem. Para usar este recurso, inicie o &kstars; a partir da linha de comando usando argumentos para especificar o nome do arquivo para a imagem, bem como as dimensões desejadas para a imagem: <cmdsynopsis
0013 ><command
0014 >kstars</command
0015 > <arg choice="plain"
0016 >--dump</arg
0017 > <arg
0018 >--filename <replaceable
0019 >kstars.png</replaceable
0020 ></arg
0021 > <arg
0022 >--height <replaceable
0023 >640</replaceable
0024 ></arg
0025 > <arg
0026 >--width <replaceable
0027 >480</replaceable
0028 ></arg
0029 > <arg
0030 >--script <replaceable
0031 >meuscript.kstars</replaceable
0032 ></arg
0033 > <arg
0034 >--date <replaceable
0035 >"4 julho 1976 12:30:00"</replaceable
0036 ></arg
0037 > </cmdsynopsis>
0038 </para>
0039 <para
0040 >Se nenhum nome de arquivo for especificado, ele irar gerar um arquivo nomeado <filename
0041 >kstars.png</filename
0042 >. Ele tentará gerar uma imagem que corresponda à extensão do seu nome de arquivo. As seguintes extensões são reconhecidas: <quote
0043 >png</quote
0044 >, <quote
0045 >jpg</quote
0046 >, <quote
0047 >jpeg</quote
0048 >, <quote
0049 >gif</quote
0050 >, <quote
0051 >pnm</quote
0052 > e <quote
0053 >bmp</quote
0054 >. Se a extensão do nome do arquivo não for reconhecida, ele cria a imagem no tipo <acronym
0055 >PNG</acronym
0056 > que é o padrão. </para>
0057 <para
0058 >Do mesmo modo, se a largura e altura da imagem não forem especificados, os padrões serão 640 e 480, respectivamente. </para>
0059 <para
0060 >Por padrão, o &kstars; lerá nas opções valores armazenados em seu arquivo <filename
0061 >$KDEHOME/share/config/kstarsrc</filename
0062 > para determinar onde a imagem será centrada, e como ela será renderizada. Isto significa que você precisa rodar o &kstars; no modo GUI normal, e sair do programa quando ele estiver configurado para as opções desejadas para a geração de imagens. Isto não é muito flexível, de modo que nós também fornecemos a possibilidade de executar um script &DBus; do &kstars; para configurar o cenário antes de gerar a imagem. O nome do arquivo que você especificar como o argumento script deve ser um script &DBus; do &kstars; válido, como um criado com a <link linkend="tool-scriptbuilder"
0063 >Ferramenta de construção de script</link
0064 >. O script pode ser usado para configurar onde a imagem é posicionada, a localização geográfica, a hora e data, mudar o nível de Ampliação, e ajustar outras opções de visualização. Algumas das funções &DBus; não fazem sentido no modo não-GUI (como a <function
0065 >waitForKey()</function
0066 >); se estas funções forem encontradas durante a análise do script, elas serão simplesmente ignoradas. </para>
0067 <para
0068 >Por padrão, o &kstars; usará a data e hora do sistema para gerar a imagem. Em alternativa, você poderá indicar uma data e hora específicas com o argumento <quote
0069 >--date</quote
0070 >. Você poderá também usar este argumento para indicar a data inicial no modo gráfico normal. </para>
0071
0072 </chapter>