# Modus voor de Commandoregel voor het maken van afbeeldingen

U kunt &kstars; gebruiken voor het maken van een afbeelding van de hemel zonder daadwerkelijk het GUI (grafische) gedeelte van het programma te starten. Hiertoe start u &kstars; in een terminal met argumenten waarmee u de naam opgeeft voor 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 zal proberen een afbeeldingstype te maken dat overeenkomt met 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 zal &kstars; de optionele waarden inlezen die opgeslagen zijn in uw bestand `$KDEHOME/share/config/kstarsrc`, om vast te stellen waar uw afbeelding op moet worden gecentreerd, en welk type afbeeldingsbestand u wenst. Dit betekent dat u &kstars; eerst moet starten in de normale grafische 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 DCOP-script voor &kstars; uit te voeren om deze zaken te regelen voordat u de afbeelding maakt. De bestandsnaam die u opgeeft als argument voor deze script moet geldig zijn voor een DCOP-script voor &kstars; zoals bijvoorbeeld een die u 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 beeldinstellingen. Sommige van de DCOP-functies hebben geen betekenis in een tekstscherm (zoals de `waitForKey()`); deze functies worden dan domweg genegeerd.

Standaard gebruikt &kstars; de systeemtijd en datum voor 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 GUI (grafische) modus om de opstartdatum op te geven.