# Tryb wiersza poleceń do generacji obrazów

Można wykorzystać &kstars; do wygenerowania obrazu nieba bez uruchamiania GUI programu. Aby wykorzystać tą funkcję, uruchom &kstars; z wiersza poleceń używając argumentów, które określają nazwę pliku dla obrazu, a także jego wymiary:

    kstars --dump --filename kstars.png --height 640 --width 480 --script mojskrypt.kstars --date "4 July 1976 12:30:00"

Jeżeli nie zostanie określona nazwa pliku, wygenerowany zostanie plik o nazwie `kstars.png`. Program będzie próbował wygenerować obraz, który odpowiada rozszerzeniu Twojego pliku. Rozpoznawane są następujące rozszerzenia: png, jpg, jpeg, gif, pnm, oraz bmp. Jeżeli rozszerzenie pliku nie zostanie rozpoznane, domyślnym typem obrazu pozostanie PNG.

Podobnie, jeżeli szerokość i wysokość nie zostaną określone, to ich wartości domyślne będą wynosiły odpowiednio 640 i 480.

Domyślnie &kstars; odczytuje wartości opcji przechowywane w pliku `$KDEHOME/share/config/kstarsrc`, aby określić gdzie obraz będzie wyśrodkowany. Oznacza to, że trzeba uruchomić &kstars; w normalnym trybie GUI, a zakończyć jego działanie, kiedy program gdy będzie uruchomiony z właściwymi opcjami dla generowanych obrazów. Nie jest to zbyt wygodne, dlatego dajemy możliwość uruchomienia odpowiedniego skryptu &kstars; DCOP, aby ustawić ekran przed wygenerowaniem obrazu. Nazwa pliku podana jako argument w skrypcie powinna być prawidłowym skryptem &kstars; DCOP, taki jak ten utworzony za pomocą Narzędzia budowania skryptów. Skrypt może być wykorzystany do wyśrodkowania ekranu, ustalania lokalizacji, ustawiania daty i czasu, zmiany poziomu przybliżenia i dostosowywania innych opcji widoku. Niektóre z funkcji DCOP nie mają w sensu w innym trybie niż graficzny interfejs użytkownika (takie jak `waitForKey()`); jeżeli takie funkcje zostaną napotkane w skrypcie, program je pominie.

Domyślnie, &kstars; będzie wykorzystywał czas i datę systemową do generowania obrazu. Zamiast tego, możesz określić czas i datę za pomocą argumentu --date. Możesz także wykorzystać ten argument dla określenia daty w zwykłym trybie GUI.