# Генериране на изображения от командния ред

Можете да използвате &kstars;, за да генерирате изображение на небето, без всъщност да стартирате графичния интерфейс на програмата. За да използвате тази функция, стартирайте &kstars; от командния ред, като използвате аргументи за задаване на името на файла на изображението, както и желаните размери на изображението:

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

Ако не е указано име на файл, се генерира файл с име `kstars.png`. Програмата ще се опита да генерира изображение, което съответства на разширението на името на вашия файл. Разпознават се следните разширения:png, jpg, jpeg, gif, pnm и bmp. Ако разширението на името на файла не се разпознава, то по подразбиране е от тип PNG изображение.

По същия начин, ако ширината и височината на изображението не са посочени, те по подразбиране са съответно 640 и 480, респективно.

По подразбиране &kstars; ще прочете стойностите на опциите, съхранени във вашия `$KDEHOME/share/config/kstarsrc` файл, за да определите къде ще бъде центрирано изображението и как се изобразява. Това означава, че трябва да стартирате &kstars; в нормален графичен режим и да излезете от програмата, когато е настроена с желаните опции за плануваните генерирани изображения. Това не е много гъвкаво, така че ние също предоставяме възможност, да изпълните D-Bus скрипт на &kstars;, за да настроите сцената, преди да генерирате изображението. Файлът, който посочвате като аргумент на командния ред трябва да бъде валиден D-Bus скрипт на &kstars;, като например, създаден с редактора на скриптове. Скриптът може да се използва за задаване на центрирането на изображението, на географско местоположение, час и дата, нивото на мащабиране и за настройване на други опции за изглед. Някои от функциите на D-Bus нямат смисъл, когато не се изпълняват в графичния интерфейс на &kstars; (като waitForKey()) и ако тези функции се срещнат при анализиране на скрипта, те просто се игнорират.

По подразбиране &kstars; ще използва времето и датата на системния процесор за генериране на изображението. Алтернативно, можете да посочите час и дата с аргумента --date. Можете също да използвате този аргумент за указване на датата при стартиране в нормален графичен режим.