docs/kstars/dumpmode.docbook

0001 <chapter id="dumpmode">
0002 <title
0003 >Modalità a riga di comando per la generazione di immagini</title>
0004 <indexterm
0005 ><primary
0006 >Modalità generazione immagini</primary
0007 ></indexterm>
0008
0009 <para
0010 >Puoi utilizzare &kstars; per generare un'immagine del cielo senza bisogno di avviare l'interfaccia grafica del programma. Per servirti di questa funzione, avvia &kstars; da riga di comando, passando argomenti per specificare il nome file dell'immagine e le sue dimensioni: <cmdsynopsis
0011 ><command
0012 >kstars</command
0013 > <arg choice="plain"
0014 >--dump</arg
0015 > <arg
0016 >--filename <replaceable
0017 >kstars.png</replaceable
0018 ></arg
0019 > <arg
0020 >--height <replaceable
0021 >640</replaceable
0022 ></arg
0023 > <arg
0024 >--width <replaceable
0025 >480</replaceable
0026 ></arg
0027 > <arg
0028 >--script <replaceable
0029 >mioscript.kstars</replaceable
0030 ></arg
0031 > <arg
0032 >--date <replaceable
0033 >"04 Jul 1976 12:30:00"</replaceable
0034 ></arg
0035 > </cmdsynopsis>
0036 </para>
0037 <para
0038 >Se non viene specificato alcun nome file, l'immagine si chiamerà <filename
0039 >kstars.png</filename
0040 >. Il programma tenterà di generare un'immagine che corrisponda all'estensione del nome file. Le estensioni seguenti sono riconosciute: <quote
0041 >png</quote
0042 >, <quote
0043 >jpg</quote
0044 >, <quote
0045 >jpeg</quote
0046 >, <quote
0047 >gif</quote
0048 >, <quote
0049 >pnm</quote
0050 > e <quote
0051 >bmp</quote
0052 >. Nel caso che l'estensione non venga riconosciuta, l'immagine sarà di tipo <acronym
0053 >PNG</acronym
0054 >. </para>
0055 <para
0056 >Analogamente, se la larghezza e altezza dell'immagine non sono specificate, assumeranno i valori predefiniti di 640 e 480, rispettivamente. </para>
0057 <para
0058 >L'impostazione predefinita è che &kstars; legga le opzioni contenute nel file <filename
0059 >$KDEHOME/share/config/kstarsrc</filename
0060 > per stabilire dove centrare l'immagine e quali caratteristiche attribuirle. Ciò significa che dovrai eseguire &kstars; in modalità grafica, e uscire una volta impostate le opzioni con i valori desiderati per la generazione delle immagini. Non si tratta di una procedura molto flessibile, perciò forniamo anche la possibilità di eseguire uno script &DBus; di &kstars; per allestire la scena prima di generare l'immagine. Il nome file specificato come argomento deve essere uno script &DBus; valido di &kstars;, come quelli creati dal <link linkend="tool-scriptbuilder"
0061 >Costruttore script</link
0062 >. Lo script può essere usato per impostare il punto del cielo su cui è centrata l'immagine, la località geografica, la data e l'ora, per modificare il livello di zoom e cambiare altre opzioni di visualizzazione. Alcune delle funzioni &DBus; non hanno senso in modalità non grafica (come <function
0063 >waitForKey()</function
0064 >); se compaiono nello script, sono semplicemente ignorate. </para>
0065 <para
0066 >&kstars; utilizzerà la data e l'ora della CPU per generare l'immagine. In alternativa, puoi specificare data e ora differenti tramite l'argomento <quote
0067 >--date</quote
0068 >. Lo stesso argomento serve a specificare la data e l'ora iniziali per la modalità grafica normale. </para>
0069
0070 </chapter>