Het maken van afbeeldingen via de opdrachtregel (in tekstscherm)
U kunt gebruiken voor het maken van een afbeelding van de hemel zonder daadwerkelijk de (het grafische gedeelte) van het programma te starten. Hiertoe start u in een terminal met als argumenten de naam van de afbeelding, en de gewenste afmetingen van het beeld:
kstars --dump --filename kstars.png --height 640 --width 480 --script mijnscript.kstars --date "4 Juli 1976 12:30:00"
Height staat in dit voorbeeld voor de hoogte, en width voor de breedte. Als er geen bestandsnaam wordt opgegeven, zal een bestand worden aangemaakt met de naam kstars.png. Het programma probeert dan een afbeeldingstype volgens de extensie van de bestandsnaam die u opgeeft. De volgende extensies worden herkend: png, jpg, jpeg, gif, pnm, en bmp. Als de extensie van de bestandsnaam niet wordt herkend, zal het standaard afbeeldingstype PNG worden gebruikt.
Op dezelfde manier zullen, als de hoogte en breedte van de afbeelding niet worden opgegeven, de standaardwaarden 640 en 480 worden gebruikt.
Standaard leest de waarden in voor de opties die opgeslagen zijn in uw bestand $KDEHOME/share/config/kstarsrc, om vast te stellen waar uw afbeelding op moet worden gecentreerd, en welk type weergave u wenst. Dit betekent dat u eerst moet starten in de normale -modus, en het programma weer verlaten wanneer de gewenste opties voor de te maken afbeeldingen zijn ingesteld. Dit is niet bepaald handig. We hebben het daarom mogelijk gemaakt om een -script voor uit te voeren om deze zaken te regelen voordat u de afbeelding maakt. De bestandsnaam die u opgeeft als argument voor de script moet geldig zijn voor een -script voor zoals u die bijvoorbeeld maakt met het hulpmidddel Scriptbouwer. De script kan worden gebruikt om in te stellen wat er op de afbeelding komt, de geografische locatie, datum en tijd, het zoomniveau en andere instellingen voor het beeld. Sommige van de -functies hebben geen betekenis in een niet- (zoals de functie waitForKey()); deze functies worden gewoon genegeerd.
Standaard gebruikt de systeemtijd en datum bij het genereren van een afbeelding. U kunt ook een tijd en een datum opgeven met behulp van het argument --date. U kunt dit argument ook gebruiken in de normale (grafische) modus voor het opgeven van de opstartdatum.