Sobre Guiones

De GeoGebra Manual
Saltar a: navegación, buscar






Programa (guion-scripting)

Un Guión o Script es una secuencia de comandos, que son ejecutados uno tras otro. GeoGebra soporta dos lenguajes - GGBScript y Javascript. La ejecución puede ser disparada por :

  • hacer clic sobre un objeto particular
  • actualizar un objeto particular (es decir, cuando el valor o las propiedades del objeto son modificadas)
  • cargar el archivo (en el caso de JavaScript)
  • Javascript listeners (ver Referencia:JavaScript)

Puedes establecer un Guión en la pestaña "Programa de guión (Scripting) que se encuentra en el Menu-options.svg Cuadro de Propiedades.

GGBScript

Puedes crear guiones o scripts que consisten en secuencias de comandos de GeoGebra, como los que utilizas en la Barra de Entrada. Luego de disparar el guión, cada comando se ejecuta uno tras otro.

Ejemplo:
  • a es un deslizador que toma valores enteros entre 1 y 3 (es decir, que el Incremento está fijado en 1)
  • tipea: lista1 = {"rojo", "verde", "azul"} en la barra de entrada
  • en propiedades de a, establece el siguiente guión en la pestaña "Al actualizar" Color(a, Elemento(lista1, a))
  • al mover el deslizador su color irá cambiando de acuerdo al valor

Explicación: Cada vez que el deslizador se mueve, ocurre una actualización. Por lo tanto, se ejecuta el guión y el valor de a es utilizado para obtener un color de la lista definida, y el comando Color cambia el color del deslizador a.

Nota: Puedes utilizar # para iniciar un comentario
Note Aviso: Hay comandos que solamente pueden ser utilizados para construir guiones. Puedes encontrarlos en Comandos_de_Guiones_-_Scripting.


JavaScript

JavaScript es un lenguaje de programación utilizado por muchas tecnologías asociadas a Internet. A diferencia del lenguaje GeoGebra Script, en Javascript los comandos no necesitan ser ejecutados como una secuencia simple, pueden utilizarse controladores de flujo (if, while, for). Puedes encontrar un lindo tutorial de JavaScript en developer.mozilla.org. En GeoGebra, puedes utilizar métodos de JavaScript especiales, que permiten modificar tu construcción. Estos pertenecen al objeto ggbApplet, lo que significa que puedes llamarlos como ggbApplet.method_name(parameter,..,parameter). Para ver una lista completa de estos métodos consulta Referencia:JavaScript.

Ejemplo:
for(var i =0;i<10;i++) 
   ggbApplet.evalCommand("A_"+i+"=(random()*10,random()*10)");
Este guión crea 10 puntos A0 a A9 con coordenadas aleatorias.
Nota: Escribir guiones con JavaScript es muy versátil, pero muchas tareas pueden lograrse de un modo más sencillo utilizando GeoGebraScript.

JavaScript Global

En la sección de JavaScript Global de la pestaña Programa de guión (Scripting) que se encuentra en el cuadro Menu-options.svg Propiedades puedes definir funciones (no variables) que estarán disponibles para los otros programas de guión. Puedes definir la función ggbOnInit(), que será llamada automáticamente al cargar la construcción. La función ggbOnInit puede ser utilizada para registrar algunos listeners, como se muestra a continuación.

Ejemplo:
function onAdd(name){
    alert("Objeto "+name+" fue añadido.");
}

function ggbOnInit(){
    ggbApplet.registerAddListener("onAdd");
}
En primer lugar, se define la función onAdd que, dada una cadena, muestra un mensaje que depende de esa cadena. A continuación, utilizando la función ggbOnInit, se le indica a GeoGebra que llame a esta función cada vez que un nuevo objeto es añadido. Al recargar la construcción, la función ggbOnInit será llamada y a partir de es momento, cuando el usuario añada un punto llamado, por ejemplo A, el mensaje "Objeto A fue añadido" aparecerá.

También puedes utilizar listeners para acciones como renombrar, eliminar y limpiar una construcción. Se puede encontrar una lista completa en Referencia:JavaScript.

Nota: Utilizando cualquier método ggbApplet en JavaScript Global por fuera de ggbOnInit no funcionará como se espera dado que deben ser llamados antes de que la construcción sea cargada.

Guion ejemplificado







Ejemplo:

A continuación se deriva a un guion (y se analiza el guion).
En este guion, Al clic se revisa la abscisa de un punto animado sobre una semicircunferencia.
Acorde al resultado se le establecen al punto libre A, coordenadas y color (azul o verde oscuro):

Si( Resto( round(10 x(B)) , 2) == 0, Coordenadas(A, y(B), 0), Coordenadas(A, x(B), 1))
Si( Resto( round(10 x(B)) , 2) == 0, Color(A, "dark green"), Color( A,"blue" ))


Nota: Quizá se podría emplear este tipo de guion como desafío para que quien no conoce la regla de asignación de posición del punto libre en relación al del animado sea el acertijo a resolver. Por ejemplo, pidiendo que se logre en tres ocasiones seguidas pasar de un color al otro.


Bulbgraph.pngAtención: En el guion se refiere el nombre en inglés de los colores para dar más versatilidad al empleo eventual de la aplicación.

Guiones o scripts

Los artículos de esta categoría describen cuestiones sobre guiones o scripts que pueden desarrollarse en y con GeoGebra .

Páginas en la categoría «Guiones»

Esta categoría incluye solamente la siguiente página.

© 2020 International GeoGebra Institute