Warning, /education/kstars/po/nl/docs/kstars/scriptbuilder.docbook is written in an unsupported language. File is not indexed.
0001 <sect1 id="tool-scriptbuilder"> 0002 <title 0003 >Het hulpmiddel Scriptbouwer</title> 0004 <indexterm 0005 ><primary 0006 >Hulpmiddelen</primary> 0007 <secondary 0008 >Scriptbouwer</secondary> 0009 </indexterm> 0010 0011 <para 0012 >Toepassingen in &kde; kunnen worden bestuurd vanuit een ander programma, vanaf de opdrachtregel in een tekstscherm, of met behulp van een shellscript, waarbij het protocol wordt gebruikt voor de communicatie tussen processen (&DBus;). In &kstars; wordt dit gebruikt voor het vastleggen van tamelijk complex gedrag in een script, dat daarna op elk moment kan worden afgespeeld. Men kan hiervan bijvoorbeeld gebruik maken voor het maken van een demonstratie voor in de klas, om een astronomisch begrip toe te lichten. </para> 0013 <para 0014 >Het probleem met DBus-scripts is dat het schrijven ervan een beetje lijkt op programmeren, waartegen iemand zonder programmeerervaring wel wat kan opzien. Het hulpmiddel Scriptbouwer heeft een <abbrev 0015 >GUI</abbrev 0016 >-interface, waarin u voor het maken van &DBus;-scripts voor &kstars; alleen maar wat hoeft aan te wijzen en te klikken, waardoor het maken van complexe scripts erg eenvoudig wordt. </para> 0017 0018 <sect2 id="sb-intro"> 0019 <title 0020 >Inleiding tot de Scriptbouwer</title> 0021 0022 <para 0023 >Voor de uitleg hoe de Scriptbouwer moet worden gebruikt, geef ik een korte inleiding tot alle <abbrev 0024 >GUI</abbrev 0025 >-componenten; als u meer wilt weten, kunt u de "Wat is dit"-functie gebruiken. </para> 0026 0027 <screenshot> 0028 <screeninfo 0029 >Het hulpmiddel Scriptbouwer </screeninfo> 0030 <mediaobject> 0031 <imageobject> 0032 <imagedata fileref="scriptbuilder.png" format="PNG"/> 0033 </imageobject> 0034 <textobject> 0035 <phrase 0036 >Het hulpmiddel Scriptbouwer</phrase> 0037 </textobject> 0038 </mediaobject> 0039 </screenshot> 0040 0041 <para 0042 >In de schermafbeelding hierboven ziet u de Scriptbouwer. Het vak links is het vak <firstterm 0043 >Huidige script</firstterm 0044 >; hierin ziet u de lijst van opdrachten in de huidige script. Het vak rechts is de <firstterm 0045 >Functiebrowser</firstterm 0046 >, hierin ziet u een lijst van alle beschikbare functies. Onder de Functiebrowser is een klein paneel met informatie over de in de Functiebrowser geselecteerde functie. In het paneel onder het vak "Huidige script"ziet u de <firstterm 0047 >Functieargumenten</firstterm 0048 >; als een functie in het vak "Huidigescript" is geselecteerd, vindt u hier de gegevens over de eventuele argumenten die deze functie nodig heeft. </para 0049 ><para 0050 >Aan de bovenkant van het venster ziet u een rij knoppen waarmee u bewerkingen op de hele script kunt uitvoeren. Van links naar rechts zijn dit: <guibutton 0051 >Nieuw Script</guibutton 0052 >, <guibutton 0053 >Script openen...</guibutton 0054 >, <guibutton 0055 >Script opslaan</guibutton 0056 >, <guibutton 0057 > Script opslaan als...</guibutton 0058 >, en <guibutton 0059 >Script testen</guibutton 0060 >. Het is duidelijk waar deze knoppen voor dienen, behalve misschien de laatste. Als u op de knop <guibutton 0061 >Script testen</guibutton 0062 > drukt, zal geprobeerd worden om de huidige script uit te voeren in het hoofdvenster van &kstars;. Het venster van de Scriptbouwer moet uit de weg gezet worden, om het resultaat te kunnen zien. </para 0063 ><para 0064 >In het midden van het venster is een rij knoppen voor bewerkingen op de individuele scriptfuncties. Van boven naar beneden zijn dit de knoppen: <guibutton 0065 >Functie toevoegen</guibutton 0066 >, <guibutton 0067 >Functie verwijderen</guibutton 0068 >, <guibutton 0069 >Functie kopiëren</guibutton 0070 >, <guibutton 0071 >Omhoog</guibutton 0072 >, en <guibutton 0073 >Omlaag</guibutton 0074 >. Met de knop <guibutton 0075 >Functie toevoegen</guibutton 0076 > voegt u de in de Functiebrowser geselecteerde functie toe aan het vak "Huidige script" (u kunt ook de functie toevoegen door erop te dubbelklikken). Met de overige knoppen voert u bewerkingen uit op de functie die in het vak "Huidig script" is geselecteerd: verwijderen, kopiëren, of verplaatsen in de huidige script. </para> 0077 </sect2> 0078 0079 <sect2 id="sb-using"> 0080 <title 0081 >Gebruik van de Scriptbouwer</title> 0082 <para 0083 >Om het gebruik van de Scriptbouwer toe te lichten, geven we hier een klein leerzaam voorbeeld waarin we een script maken dat de maan volgt, terwijl de klok sneller loopt. </para 0084 ><para 0085 >Als we de maan willen volgen, moeten we eerst de kijkrichting aanpassen. Daarvoor gebruiken we de functie <firstterm 0086 >lookToward</firstterm 0087 > (kijk in de richting van). Kies deze functie in de Functiebrowser, en bekijk de documentatie in het paneel onder de browser. Druk op de knop <guibutton 0088 >Functie toevoegen</guibutton 0089 > om deze functie toe te voegen in het vak "Huidige script". In het paneel "Functieargumenten" ziet u nu een comboveld met de tekst <quote 0090 >Dir</quote 0091 >, wat direction (richting) betekent. Dit is de kijkrichting in het beeldscherm. Het comboveld bevat alleen de hoofd- en tussenstreken van het kompas, en niet de maan of andere objecten. U kunt of <quote 0092 >Maan</quote 0093 > met de hand invullen in het comboveld, of op de knop <guibutton 0094 >Object...</guibutton 0095 > drukken om het venster <guilabel 0096 >Object zoeken...</guilabel 0097 > te kunnen gebruiken om hierin de Maan te selecteren uit de lijst van objecten met een naam. Merk op, dat zoals gewoonlijk, het centreren op een object het volgen automatisch inschakelt, het is dus niet nodig om de functie <firstterm 0098 >setTracking</firstterm 0099 > (volgen aanzetten) toe te voegen na lookToward. </para 0100 ><para 0101 >Nu we ervoor hebben gezorgd dat de kijkrichting op de maan wordt ingesteld, willen we de tijd sneller laten lopen. Gebruik hiervoor de functie <firstterm 0102 >setClockScale</firstterm 0103 > (Kloksnelheid instellen). Voeg deze functie toe aan de script door erop te dubbelklikken in de Functiebrowser. Het paneel "Functieargumenten" heeft een tijdstap-spinveld om de gewenste tijdstap voor de simulatieklok te kiezen. Verander de tijdstap in 3 uur. </para 0104 ><para 0105 >Goed, we hebben nu de kijkrichting op de maan ingesteld, en de klok versneld. Nu willen we dat de script enkele seconden wacht, terwijl in het beeld de maan wordt gevolgd. Voeg de functie <firstterm 0106 >waitFor</firstterm 0107 > (wacht op) toe aan de script, en gebruik het paneel "Functieargumenten" om aan te geven dat er 20 seconden moet worden gewacht alvorens verder te gaan. </para 0108 ><para 0109 >Tenslotte zetten we de tijdstap van de klok terug naar de normale waarde van 1 seconde. Voeg de functie setClockscale nog een keertje toe, met als argument 1 sec. </para 0110 ><para 0111 >Eigenlijk zijn we nu nog niet klaar. We moeten er zeker van zijn dat er op het scherm Equatoriale coördinaten worden gebruikt, voordat de script de maan versneld gaat volgen. Anders, als horizontale coördinaten worden gebruikt, zal het scherm zeer snel veranderen over grote hoeken op de momenten dat de maan opkomt of ondergaat. Dit is erg verwarrend, en kan worden vermeden door de weergaveoptie <firstterm 0112 >UseAltAz</firstterm 0113 > (gebruik HgteAz) op "false" (onwaar) in te stellen. Om een weergaveoptie te veranderen, gebruikt u de functie <firstterm 0114 >changeViewOption</firstterm 0115 > (verander de weergaveoptie). Voeg deze functie toe aan de script, en bestudeer het paneel "Functieargumenten". Er is een comboveld met een lijst van alle weergaveopties die door changeViewOption kunnen worden veranderd. Omdat we weten dat we de UseAltAz-optie moeten hebben, kunnen we die gewoon kiezen in het comboveld. Maar de lijst is erg lang, en er is geen uitleg bij elke regel. Het is daarom wellicht eenvoudiger om op de knop <guibutton 0116 >Boomstructuur doorbladeren</guibutton 0117 > te klikken, waardoor een venster wordt geopend met een lijst van alle weergaveopties, ingedeeld naar onderwerp. Er is bovendien uitleg bij elke optie, en het gegevenstype van de waarde van elke optie. We vinden "UseAltAz" in de categorie <guilabel 0118 >Hemelkaartopties</guilabel 0119 >. Kies het en klik op de knop <guibutton 0120 >OK</guibutton 0121 >, en het zal worden gekozen in het combinatieveld van het paneel "Functieargumenten". Tenslotte maakt u de waarde ervan <quote 0122 >false</quote 0123 > of <quote 0124 >0</quote 0125 >. </para 0126 ><para 0127 >Nog een stap: het veranderen van "UseAltAz" aan het eind van de script zal ons niet helpen, dit moet gebeuren voor alles wat er gebeurt. Dus kies deze functie in het vak "Huidige script" en druk op de knop <guibutton 0128 >Omhoog</guibutton 0129 > totdat het de eerste functie in de script is. </para 0130 ><para 0131 >Nu dat we met de script klaar zijn, moeten we die nog opslaan op de schijf. Druk op de knop <guibutton 0132 >Script opslaan</guibutton 0133 >. Hierdoor wordt eerst een venster geopend, waarin u een naam kunt invullen van de script, en uw naam als de auteur. Vul als naam in <quote 0134 >Volgen van de Maan</quote 0135 >, en uw naam als auteur, en druk op <guibutton 0136 >OK</guibutton 0137 >. U zult daarna de standaarddialoog "Bestand opslaan" van &kde; zien. Voer een bestandsnaam in voor de script. Merk op dat de extensie <quote 0138 >.kstars</quote 0139 > automatisch wordt toegevoegd mocht u die vergeten. Als u nieuwsgierig bent, kunt u met elke tekstverwerker het scriptbestand bekijken. </para 0140 ><para 0141 >Nu we een script hebben gemaakt, kunnen we die op een aantal manieren laten werken. U kunt de script uitvoeren vanaf de opdrachtregel in een tekstscherm, als er een &kstars; draait. U kunt ook de script uitvoeren vanuit &kstars;, met het menu-item <menuchoice 0142 ><guimenu 0143 >Bestand</guimenu 0144 > <guimenuitem 0145 >Run Script...</guimenuitem 0146 ></menuchoice 0147 >. </para> 0148 </sect2> 0149 </sect1> 0150