# A ferramenta Construtor de scripts

As aplicacións do KDE poden ser controladas externamente por outro programa, desde unha consola ou cun script de consola empregando o protocolo de comunicación entre procesos (DCOP). O KStars aproveita esta característica para permitir que se podan escribir scripts para comportamentos bastante complexos e que se reproduzan en calquera momento. Isto pódese empregar, por exemplo, para crear unha demostración para a aula para ilustrar un concepto astronómico.

O problema cos scripts de DBus é que escribilos é un pouco como programar e que lles pode parecer unha tarefa aterradora a quen non teñan experiencia en programación. A Ferramenta Construtor de Guións fornece unha interface GUI na que apuntar e premer para construir scripts DCOP para o KStars, tornando moi doada a creación de scripts complexos.

## Introdución ao Construtor de scripts

Antes de explicar como empregar o Construtor de scripts vou fornecer unha breve introdución a todos os componentes da GUI; para máis información emprega a función "Que é isto?".

A Ferramenta Construtor de scripts Ferramenta Construtor de scripts

Na imaxe de abaixo vese o Construtor de scripts. A caixa da esquerda é a caixa do script actual; mostra a lista de comandos que constitúen o script no que se está a traballar. A caixa da dereita é o Navegador de funcións; mostra a lista de todas as funcións de scrip disponíbeis. Por debaixo do Navegador de funcións hai un paneliño que mostra unha documentación breve acerca da función do script resaltado no Navegador de funcións. O panel por baixo da caixa do script actual é o panel Argumentos da función; cando se resalta unha función na caixa Guión actual, este panel contén elementos para especificar os valores de calquera argumento que requira a función resaltada.

Na parte superior da xanela hai unha fileira de botóns que actúan sobre o script como un todo. Da esquerda para a dereita, son: Novo script, Abrir script, Gardar script, Gardar script como... e Probar o script. A función destes botóns debería ser obvia, excepto talvez o derradeiro botón. Cando se preme Probar o script, o programa tenta executar o script na xanela principal do KStars. Hai que apartar a xanela do Construtor de guións antes de premelo para así poder ver os resultados.

No centro da xanela hai unha columna de botóns que actúan sobre as funcións individuais do script. Desde arriba para baixo, son: Engadir función, Eliminar función, Copiar función, Subir e Baixar. Engadir función adiciona a función resaltada no Navegador de funcións á caixa Script actual (tamén se pode engadir unha función preméndoa dúas veces). O resto dos botóns actúan sobre a función resaltada na caixa Script actual, eliminándoo, duplicándoo ou movendo a súa posición no script actual.

## Uso do Construtor de scripts

Para ilustrar o uso do Construtor de scripts presentamos un pequeno titorial de exemplo no que facemos un script que segue a Lúa mentres o reloxo corre a unha velocidade acelerada.

Se imos seguir a Lúa, temos primeiros que centrar o visor nela. A función lookToward é a que se emprega para isto. Resalta esta función no Navegador de funcións e observa a documentación que se mostra no panel que hai por debaixo do Navegador.

Unha vez que nos ocupamos de apuntar para a Lúa, o seguinte que queremos é facer que o tempo transcorra a unha velocidade acelerada. Para isto, emprega a función setClockScale. Engádea ao script premendo dúas veces o Navegador de funcións. O panel Argumentos da función contén un selector de pasos de tempo para axustar os pasos de tempo desexados para o reloxo de simulación. Cambia os pasos de tempo a 3 horas.

Ben, apuntamos para a Lúa e aceleramos o reloxio. A seguir simplemente queremos que o script agarde uns segundos mentres o visor segue a Lúa. Engade a función waitFor ao script e emprega o panel Argumentos de función para especificar que debe agardar 20 segundos antes de continuar.

Para rematar, volvamos os pasos de tempo do reloxo ao valor normal de 1 segundo. Engade outro setClockScale e dalle o valor de 1 segundo.

Na verdade, ainda non rematamos de todo. Probabelmente nos teñamos que asegurar de que o visor está a empregar as coordenadas ecuatoriais antes de que o script siga a Lúa cun paso de tempo acelerado. Se non, se o visor emprega as coordenadas horizontais, rotará moi rapidamente en ángulos moi grandes segundo a Lúa se ergue e se pon. Isto pode resultar moi confuso e evítase configurando a Opción de Vista UseAltAz como false. Para mudar calquera Opción de Vista emprega a función changeViewOption. Engade esta función ao script e examina o panel Argumentos de función. Hai un menú despregábel que contén a listaxe de todas as opcións que se poden axustar con changeViewOption. Dado que sabemos que queremos a opción UseAltAz, poderíamos simplemente seleccionala neste menú. Porén, a lista é bastante longa e carece de explicacións do que é cada elemento. Polo tanto, é mellor premer o botón Examinar árbore, que abre unha xanela cunha vista de árbore de todas as funcións disponíbeis organizadas por temas. Alén disto, cada elemento ten unha explicación breve do que fai a opción e o tipo de datos do valor da opción. Atopamos UseAltAz na categoría Opcións do mapa do ceo. Chega con resaltar este elemento e premer Aceptar e selecciónase no menú despregábel do panel Argumentos de función. Por último, fai que o seu valor sexa false ou 0.

Un paso máis: mudar UseAltAz ao final do script non nos sirve de nada; ten que cambiar antes de que aconteza nada máis. Por iso, asegúrate de que a función estea resaltada na caixa Script actual e preme o botón Subir até que sexa a primeira función.

Unha vez rematado o script deberíamolo gravar no disco. Preme o botón Gardar script. Isto abre primeiro unha xanela na que se lle pode dar un nome ao script e escribir o teu nome como autor. Escribe Seguindo a Lúa como nome e o teu nome como autor e preme Aceptar. A seguir, verás o diálogo normal Gardar Ficheiro do &kde;. Especifica un nome de ficheiro para o script e preme Aceptar para gravarlo. Lembra que se o nome do ficheiro non remata con .kstars, este sufixo engádese automaticamente. Se tes curiosidade, podes examinar o ficheiro do script con calquera editor de texto.

Agora que xa rematamos o script podémolo executar dun par de maneiras. Desde unha consola pódese simplemente executar o script sempre que haxa un KStars en execución. Como alternativa, pódese executar o script desde dentro do KStars co elemento Executar guión do menú Ficheiro.