# Modalità a riga di comando per la generazione di immagini

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:

    kstars --dump --filename kstars.png --height 640 --width 480 --script mioscript.kstars --date "04 Jul 1976 12:30:00"

Se non viene specificato alcun nome file, l'immagine si chiamerà `kstars.png`. Il programma tenterà di generare un'immagine che corrisponda all'estensione del nome file. Le estensioni seguenti sono riconosciute: png, jpg, jpeg, gif, pnm e bmp. Nel caso che l'estensione non venga riconosciuta, l'immagine sarà di tipo PNG.

Analogamente, se la larghezza e altezza dell'immagine non sono specificate, assumeranno i valori predefiniti di 640 e 480, rispettivamente.

L'impostazione predefinita è che &kstars; legga le opzioni contenute nel file `$KDEHOME/share/config/kstarsrc` 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 DCOP di &kstars; per allestire la scena prima di generare l'immagine. Il nome file specificato come argomento dev'essere uno script DCOP valido di &kstars;, come quelli creati dal Costruttore script. 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 DCOP non hanno senso in modalità non grafica (come `waitForKey()`); se compaiono nello script, sono semplicemente ignorate.

&kstars; utilizzerà la data e l'ora della CPU per generare l'immagine. In alternativa, puoi specificare data e ora differenti tramite l'argomento --date. Lo stesso argomento serve a specificare la data e l'ora iniziali per la modalità grafica normale.