Warning, /education/kstars/po/es/docs/kstars/scriptbuilder.docbook is written in an unsupported language. File is not indexed.
0001 <sect1 id="tool-scriptbuilder"> 0002 <title 0003 >La herramienta del constructor de guiones</title> 0004 <indexterm 0005 ><primary 0006 >Herramientas</primary> 0007 <secondary 0008 >Constructor de guiones</secondary> 0009 </indexterm> 0010 0011 <para 0012 >Las aplicaciones de KDE se pueden controlar externamente desde otro programa, desde la línea de órdenes de la consola o mediante un guion de consola que use el protocolo de comunicación entre procesos (&DBus;). &kstars; se beneficia de esta característica para permitir que se puedan plasmar en un guion comportamientos bastante complejos con el fin de reproducirlos de nuevo en cualquier momento. Esto se puede usar, por ejemplo, para crear una demostración para el aula que ilustre un concepto astronómico. </para> 0013 <para 0014 >El problema que existe con los guiones de &DBus; es que escribirlos es algo parecido a la programación y puede parecer una tarea tremenda para las personas que no tienen experiencia como programadores. La herramienta del constructor de guiones proporciona una interfaz gráfica del tipo apuntar y pulsar para construir guiones &DBus; para &kstars;, haciendo muy fácil la creación de guiones complejos. </para> 0015 0016 <sect2 id="sb-intro"> 0017 <title 0018 >Introducción al constructor de guiones</title> 0019 0020 <para 0021 >Antes de explicar cómo usar el constructor de guiones proporcionaremos una breve introducción a los componentes de la interfaz gráfica. Para obtener más información, utilice la función «¿Qué es esto?». </para> 0022 0023 <screenshot> 0024 <screeninfo 0025 >La herramienta del constructor de guiones </screeninfo> 0026 <mediaobject> 0027 <imageobject> 0028 <imagedata fileref="scriptbuilder.png" format="PNG"/> 0029 </imageobject> 0030 <textobject> 0031 <phrase 0032 >Herramienta del constructor de guiones</phrase> 0033 </textobject> 0034 </mediaobject> 0035 </screenshot> 0036 0037 <para 0038 >La captura de pantalla anterior muestra el constructor de guiones. El campo de la izquierda es el <firstterm 0039 >campo del guion actual</firstterm 0040 >; muestra la lista de las órdenes que componen el guion de trabajo actual. El campo de la derecha es el <firstterm 0041 >navegador de funciones</firstterm 0042 >; muestra la lista de todas las funciones disponibles. Debajo del navegador de funciones existe un pequeño panel que mostrará una información básica sobre la función resaltada en el navegador de funciones. El panel que hay debajo del campo del guion actual es el <firstterm 0043 >panel de argumentos de la función</firstterm 0044 >; cuando se selecciona una función en el campo del guion actual, este panel contiene elementos para especificar valores para cualquier argumento que necesite la función seleccionada. </para 0045 ><para 0046 >En la parte superior de la ventana existe una fila de botones que operan sobre la totalidad del guion. De izquierda a derecha, son: <guibutton 0047 >Nuevo guion</guibutton 0048 >, <guibutton 0049 >Abrir guion</guibutton 0050 >, <guibutton 0051 >Guardar guion</guibutton 0052 >, <guibutton 0053 >Guardar guion como...</guibutton 0054 > y <guibutton 0055 >Probar guion</guibutton 0056 >. La función de estos botones debe ser obvia, excepto tal vez la del último botón. Si pulsa <guibutton 0057 >Probar guion</guibutton 0058 > se tratará de ejecutar el guion actual en la ventana principal de &kstars;. Deberá apartar la ventana del constructor de guiones antes de pulsar este botón si desea ver su resultado. </para 0059 ><para 0060 >En el centro de la ventana existe una columna de botones que operan sobre funciones individuales del guion. De arriba a abajo, son: <guibutton 0061 >Añadir función</guibutton 0062 >, <guibutton 0063 >Eliminar función</guibutton 0064 >, <guibutton 0065 >Copiar función</guibutton 0066 >, <guibutton 0067 >Mover arriba</guibutton 0068 > y <guibutton 0069 >Mover abajo</guibutton 0070 >. <guibutton 0071 >Añadir función</guibutton 0072 > añade la función seleccionada actualmente en el navegador de funciones al campo del guion actual (también puede añadir una función haciendo doble clic sobre ella). El resto de botones operan sobre la función seleccionada en el campo del guion actual, bien para eliminarla, duplicarla o cambiar su posición en el guion actual. </para> 0073 </sect2> 0074 0075 <sect2 id="sb-using"> 0076 <title 0077 >Uso del constructor de guiones</title> 0078 <para 0079 >Para ilustrar el uso del constructor de guiones, le presentamos un breve ejemplo de su uso en el que crearemos un guion que sigue la posición de la Luna mientras el reloj avanza a ritmo acelerado. </para 0080 ><para 0081 >Si vamos a seguir la posición de la Luna, necesitaremos que la pantalla la muestre. La función <firstterm 0082 >lookToward</firstterm 0083 > se usa para hacer esto. Seleccione esta función en el navegador de funciones y lea la documentación que se muestra en el panel que hay debajo del navegador. Pulse el botón <guibutton 0084 >Añadir función</guibutton 0085 > para añadir esta función al campo del guion actual. El panel de argumentos de la función contendrá ahora una lista desplegable con la etiqueta «Dir», que significa «dirección» en forma abreviada. Esta es la dirección a la que debe apuntar la pantalla. La lista desplegable contiene solo los puntos cardinales de la brújula, no la Luna ni ningún otro objeto. Ahora puede introducir «Luna» en el campo manualmente o pulsar el botón <guibutton 0086 >Objeto</guibutton 0087 > para usar la ventana <guilabel 0088 >Buscar objeto</guilabel 0089 > y seleccionar la Luna de la lista de objetos con nombre. Tenga en cuenta que, como es habitual, al centrar un objeto en la pantalla se activa automáticamente el modo de seguimiento del objeto, por lo que no hay necesidad de añadir la función <firstterm 0090 >setTracking</firstterm 0091 > tras «lookToward». </para 0092 ><para 0093 >Ahora que ya nos hemos ocupado de apuntar hacia la Luna, haremos que el tiempo transcurra a un ritmo acelerado. Para esto usaremos la función <firstterm 0094 >setClockScale</firstterm 0095 >. Añádala al guion haciendo doble clic sobre ella en el navegador de funciones. El panel de los argumentos de la función contiene un control de incremento de los pasos de tiempo para establecer el deseado para el reloj de la simulación. Cambie el paso de tiempo a 3 horas. </para 0096 ><para 0097 >Ya hemos apuntado hacia la Luna y hemos acelerado el reloj. Ahora queremos que el guion espere durante varios segundos mientras la pantalla sigue a la Luna. Añadimos la función <firstterm 0098 >waitFor</firstterm 0099 > al guion y usamos el panel de argumentos de la función para especificar que se debe esperar durante 20 segundos antes de continuar. </para 0100 ><para 0101 >Para terminar, reiniciaremos el paso de tiempo del reloj a su valor normal de 1 segundo. Para ello, añadimos otra vez la función «setClockScale» y establecemos su valor a 1 segundo. </para 0102 ><para 0103 >En realidad, aún no hemos terminado. Probablemente deberíamos asegurarnos de que la pantalla está usando coordenadas ecuatoriales antes de que el guion siga la Luna con un paso de tiempo acelerado. En caso contrario, si la pantalla estuviera usando coordenadas horizontales, rotaría muy rápidamente en grandes ángulos a medida que la Luna saliera y se pusiera. Esto puede resultar bastante confuso, y se evita estableciendo la opción de visualización <firstterm 0104 >UseAltAz</firstterm 0105 > a «false». Para cambiar cualquier opción de visualización usaremos la función <firstterm 0106 >changeViewOption</firstterm 0107 >. Añada esta función al guion y examine el panel de argumentos de la función. Dispone de una lista desplegable que contiene la lista de todas las opciones que se pueden ajustar con «changeViewOption». Como sabemos que queremos la opción «UseAltAz», podemos seleccionarla en esta lista desplegable. No obstante, la lista es bastante larga y no existe una explicación para lo que hace cada opción. Por este motivo resulta más fácil pulsar el botón <guibutton 0108 >Examinar árbol</guibutton 0109 >, que abrirá una ventana con una vista de árbol que contiene todas las opciones disponibles organizadas por temas. Además, cada elemento posee una breve explicación de lo que hace la opción y el tipo de dato del valor de la opción. Encontraremos «UseAltAz» en la categoría <guilabel 0110 >Opciones del mapa del cielo</guilabel 0111 >. Solo tiene que resaltar este elemento y pulsar <guibutton 0112 >Aceptar</guibutton 0113 > para seleccionarlo en la lista desplegable del panel de argumentos de la función. Por último, cambie su valor a «false» o a «0». </para 0114 ><para 0115 >Un paso más: no resulta apropiado cambiar «UseAltAz» al final del guion; necesitamos cambiar esto antes de que ocurra nada más. Así, nos aseguraremos de que esta función esté seleccionada en el campo del guion actual y pulsaremos el botón <guibutton 0116 >Mover arriba</guibutton 0117 > hasta que se convierta en la primera función. </para 0118 ><para 0119 >Ahora que hemos terminado el guion deberíamos guardarlo en el disco. Para ello pulsaremos el botón <guibutton 0120 >Guardar guion</guibutton 0121 >, que primero abrirá una ventana en la que puede proporcionar un nombre para el guion además de introducir su nombre como autor del guion. Introduzca «Seguimiento de la Luna» como nombre y su propio nombre como autor, y luego pulse el botón <guilabel 0122 >Aceptar</guilabel 0123 >. A continuación verá el diálogo estándar de &kde; para guardar archivos. Introduzca un nombre de archivo para el guion y pulse el botón <guilabel 0124 >Aceptar</guilabel 0125 > para guardar el guion. Tenga en cuenta que su nombre de archivo no debe terminar con «.kstars», ya que este sufijo será añadido automáticamente. Si siente curiosidad, puede examinar el archivo del guion con cualquier editor de texto. </para 0126 ><para 0127 >Ahora que tenemos un guion completo, podemos ejecutarlo de varias formas. Desde la línea de órdenes de la consola, donde puede ejecutar el guion cuando tenga &kstars; en funcionamiento; o bien, puede ejecutar el guion desde &kstars; usando el elemento <guimenuitem 0128 >Ejecutar guion...</guimenuitem 0129 > del menú <guimenu 0130 >Archivo</guimenu 0131 >. </para> 0132 </sect2> 0133 </sect1> 0134