Warning, /education/kstars/po/it/docs/kstars/scriptbuilder.docbook is written in an unsupported language. File is not indexed.
0001 <sect1 id="tool-scriptbuilder"> 0002 <title 0003 >Il Costruttore di script</title> 0004 <indexterm 0005 ><primary 0006 >Strumenti</primary> 0007 <secondary 0008 >Costruttore di script</secondary> 0009 </indexterm> 0010 0011 <para 0012 >Le applicazioni &kde; possono essere controllate esternamente da un altro programma, da un prompt di terminale o da uno script di shell, usando il protocollo di comunicazione tra processi (&DBus;). &kstars; sfrutta questa possibilità per permettere in ogni momento la registrazione e riproduzione di complesse sequenze di eventi. Ciò può essere utile, ad esempio, per creare una dimostrazione didattica che illustri un concetto astronomico. </para> 0013 <para 0014 >Il problema con gli script &DBus; è che scriverli è un po' come programmare, impresa che può apparire proibitiva a chi non ha esperienza in materia. Il Costruttore di script fornisce un'interfaccia grafica (<abbrev 0015 >GUI</abbrev 0016 >) punta-e-fai-clic per realizzare gli script &DBus; di &kstars;, rendendo molto facile crearne anche di complessi. </para> 0017 0018 <sect2 id="sb-intro"> 0019 <title 0020 >Introduzione al Costruttore di script</title> 0021 0022 <para 0023 >Prima di spiegare come si usa il Costruttore di script, introdurremo brevemente tutti i componenti dell'interfaccia grafica; per maggiori informazioni utilizza la funzione "Che cos'è questo?". </para> 0024 0025 <screenshot> 0026 <screeninfo 0027 >Il Costruttore di script </screeninfo> 0028 <mediaobject> 0029 <imageobject> 0030 <imagedata fileref="scriptbuilder.png" format="PNG"/> 0031 </imageobject> 0032 <textobject> 0033 <phrase 0034 >Costruttore di script</phrase> 0035 </textobject> 0036 </mediaobject> 0037 </screenshot> 0038 0039 <para 0040 >Il Costruttore di script è mostrato nell'immagine qui sopra. A sinistra c'è il <firstterm 0041 >riquadro Script corrente</firstterm 0042 > che mostra la lista di comandi inclusi nello script corrente. Il riquadro a destra è il <firstterm 0043 >Browser funzioni</firstterm 0044 >, con la lista di tutte le funzioni disponibili. Sotto il Browser funzioni c'è un pannello dove compare una breve documentazione sulla funzione evidenziata nel riquadro sovrastante. Sotto il riquadro Script corrente c'è il <firstterm 0045 >pannello Argomenti funzione</firstterm 0046 >; quando si seleziona una funzione nel riquadro Script corrente, in questo pannello appare il necessario per specificare il valore degli argomenti eventualmente richiesti. </para 0047 ><para 0048 >In cima alla finestra c'è una fila di pulsanti che operano sullo script nel suo insieme. Da sinistra a destra: <guibutton 0049 >Nuovo script</guibutton 0050 >, <guibutton 0051 >Apri script...</guibutton 0052 >, <guibutton 0053 >Salva script</guibutton 0054 >, <guibutton 0055 >Salva script come...</guibutton 0056 > e <guibutton 0057 >Prova script</guibutton 0058 >. La funzione di questi pulsanti dovrebbe essere ovvia, fatta forse eccezione per l'ultimo. Premendo <guibutton 0059 >Prova script</guibutton 0060 > lo script corrente sarà eseguito nella finestra principale di &kstars;. Prima di farlo ti consigliamo di spostare la finestra del Costruttore di script, in modo che tu possa vedere i risultati. </para 0061 ><para 0062 >Al centro della finestra c'è una fila verticale di pulsanti che operano su singole funzioni dello script. Dall'alto in basso: <guibutton 0063 >Aggiungi funzione</guibutton 0064 >, <guibutton 0065 >Elimina funzione</guibutton 0066 >, <guibutton 0067 >Copia funzione</guibutton 0068 >, <guibutton 0069 >Sposta in alto</guibutton 0070 > e <guibutton 0071 >Sposta in basso</guibutton 0072 >. Il pulsante <guibutton 0073 >Aggiungi funzione</guibutton 0074 > aggiunge la funzione selezionata nel Browser all'interno del riquadro Script corrente (puoi anche aggiungere una funzione con un doppio clic su di essa). Gli altri pulsanti operano sulla funzione selezionata nel riquadro Script corrente, con l'effetto di eliminarla, di duplicarla o di modificarne la posizione all'interno dello script. </para> 0075 </sect2> 0076 0077 <sect2 id="sb-using"> 0078 <title 0079 >Utilizzo del Costruttore di script</title> 0080 <para 0081 >Per illustrare l'utilizzo del Costruttore di script presenteremo un piccolo esempio. Scriveremo uno script che insegue la Luna mentre il tempo scorre a velocità accelerata. </para 0082 ><para 0083 >Se vogliamo inseguire la Luna dobbiamo per prima cosa puntarla. La funzione <firstterm 0084 >lookToward</firstterm 0085 > ha precisamente questo scopo. Selezionala nel Browser funzioni e consulta la documentazione visualizzata nel pannello sottostante. Quindi premi il pulsante <guibutton 0086 >Aggiungi funzione</guibutton 0087 > per aggiungere la funzione nel riquadro Script corrente. Il pannello Argomenti funzione conterrà ora una casella chiamata <quote 0088 >Dir</quote 0089 >, che sta per "Direzione". Si tratta della direzione verso cui si vuol puntare lo schermo. La lista contiene solo i punti cardinali, non la Luna o altri oggetti. Puoi inserire <quote 0090 >Luna</quote 0091 > manualmente nella casella, oppure premere il pulsante <guibutton 0092 >Oggetto...</guibutton 0093 > per utilizzare la finestra <guilabel 0094 >Trova oggetto...</guilabel 0095 > e selezionarla dalla lista di oggetti con nome. Nota che, come sempre, centrare un oggetto attiva automaticamente l'inseguimento, così che non c'è bisogno di aggiungere la funzione <firstterm 0096 >setTracking</firstterm 0097 > dopo lookToward. </para 0098 ><para 0099 >Ora che abbiamo puntato la Luna vogliamo che il tempo scorra a una velocità superiore al normale. Utilizza allo scopo la funzione <firstterm 0100 >setClockScale</firstterm 0101 >. Aggiungila allo script facendo doppio clic su di essa nel Browser funzioni. Il pannello Argomenti funzione contiene ora il necessario per modificare il passo dell'orologio della simulazione. Porta il passo a tre ore. </para 0102 ><para 0103 >Bene, abbiamo puntato la Luna e accelerato lo scorrere del tempo. Ora vogliamo solo che lo script attenda un certo numero di secondi mentre lo schermo insegue la Luna. Aggiungi allo script la funzione <firstterm 0104 >waitFor</firstterm 0105 >, e utilizza il pannello Argomenti funzione per impostare a venti secondi il tempo di attesa. </para 0106 ><para 0107 >Per finire, riportiamo il passo dell'orologio al valore normale di un secondo. Aggiungi un'altra istanza di setClockScale, e impostane il valore a un secondo. </para 0108 ><para 0109 >Per la verità non abbiamo ancora finito. Dovremmo assicurarci che il programma stia utilizzando le coordinate equatoriali prima che lo script inizi a inseguire la Luna con passo temporale accelerato. Altrimenti, se lo schermo utilizza coordinate orizzontali, ruoterà assai rapidamente di grandi angoli mentre la Luna sorge e tramonta. Ciò può provocare parecchia confusione, ma lo si può evitare impostando l'opzione di visualizzazione <firstterm 0110 >UseAltAz</firstterm 0111 > a <quote 0112 >false</quote 0113 >. Per modificare una qualsiasi opzione di visualizzazione, utilizza la funzione <firstterm 0114 >changeViewOption</firstterm 0115 >. Aggiungila allo script ed esamina il pannello Argomenti funzione. C'è un pulsante che apre una lista di tutte le opzioni modificabili tramite changeViewOption. Dato che sappiamo di dover utilizzare l'opzione UseAltAz, potremmo semplicemente selezionarla dalla lista. Si tratta tuttavia di una lista piuttosto lunga, e non ci sono spiegazioni per le varie voci. Potrebbe quindi essere più semplice premere il pulsante <guibutton 0116 >Esamina albero...</guibutton 0117 >, che aprirà una finestra con una vista ad albero delle opzioni di visualizzazione, divise per argomento. Inoltre ogni voce dispone di una breve spiegazione, ed è indicato il tipo di dati dell'argomento. Possiamo trovare UseAltAz nella categoria <guilabel 0118 >Opzioni mappa celeste</guilabel 0119 >. Selezionala e premi <guibutton 0120 >OK</guibutton 0121 >, ed essa comparirà all'interno del pannello Argomenti funzione. Infine, imposta il suo valore a <quote 0122 >false</quote 0123 > o <quote 0124 >0</quote 0125 >. </para 0126 ><para 0127 >Un'altra cosa: cambiare UseAltAz alla fine dello script non serve a granché; dobbiamo modificarlo prima di ogni altra cosa. Perciò assicurati che la funzione sia selezionata nel riquadro Script corrente, e premi il pulsante <guibutton 0128 >Sposta in alto</guibutton 0129 > fino a farla diventare la prima funzione. </para 0130 ><para 0131 >Ora che abbiamo terminato lo script dobbiamo salvarlo su disco. Premi il pulsante <guibutton 0132 >Salva script</guibutton 0133 >. Si aprirà una finestra in cui puoi inserire un nome per lo script e uno per il suo autore. Inserisci <quote 0134 >Inseguire la Luna</quote 0135 > come nome, metti il tuo nome come autore e premi <guibutton 0136 >OK</guibutton 0137 >. Apparirà la finestra di dialogo standard "Salva file" di &kde;. Specifica un nome file per lo script e premi <guibutton 0138 >OK</guibutton 0139 > per salvarlo. Nota che, se il nome file non finisce per <quote 0140 >.kstars</quote 0141 >, l'estensione sarà aggiunta automaticamente. Se sei curioso, puoi esaminare lo script con un qualunque editor di testi. </para 0142 ><para 0143 >Ora che abbiamo uno script completo possiamo eseguirlo in due modi diversi. È possibile farlo da un prompt di terminale, purché &kstars; sia in esecuzione. In alternativa puoi eseguire lo script da &kstars; tramite la voce di menu <menuchoice 0144 ><guimenu 0145 >File</guimenu 0146 > <guimenuitem 0147 >Esegui Script...</guimenuitem 0148 ></menuchoice 0149 >. </para> 0150 </sect2> 0151 </sect1> 0152