Diferencia entre revisiones de «Tutorial:Funciones y Subrutinas»

De GeoGebra Manual
Saltar a: navegación, buscar
(Página creada con «{{tutorial| title=Funciones y Subrutinas vía ''Guiones'' (''scripts'') }} [http://en.wikipedia.org/wiki/Subroutine Subroutines] (also known as functions or procedures) are...»)
 
m (Revertidos los cambios de Lilai (disc.) a la última edición de LailaTov)
 
(No se muestran 36 ediciones intermedias de 6 usuarios)
Línea 1: Línea 1:
{{tutorial|
+
{{tutoriales|title=Funciones y Subrutinas vía ''Guiones'' (''scripts'')}}
title=Funciones y Subrutinas vía ''Guiones'' (''scripts'')
+
<h4>Funciones y Subrutinas</h4>
}}
+
{{Interfaz Gráfica|Menú}}
[http://en.wikipedia.org/wiki/Subroutine Subroutines] (also known as functions or procedures) are an important concept in computer programming, and help with program maintenance and code re-useThis tutorial describes some ways that you can enjoy some of the advantages of subroutines in GeoGebra.
+
Las [http://es.wikipedia.org/wiki/Subrutina subrutinas] (también denominadas funciones o procedimientos) involucran un concepto central en la programación y brindan una ayuda crucial en el mantenimiento de los programas dado que facilitan la reutilizaciónEn este tutorial se describen mecanismos para emplearlas en GeoGebra.
  
'''Method 1.'''  [[Herramientas Propias|Herramientas Personales o ''Propias'']] act like a new functionThey can take inputs and produce output objects as a resultYou can invoke them from the toolbar, or from the input bar or scripts.   
+
'''Método Nº 1.'''  [[Comentarios:Propias|Herramientas Personales o ''Propias'']]: operan como una nueva funciónRequieren entradas y producen objetos de salida resultantesSe las puede incluir en la [[:Categoría:Iconos#Diferentes_Barras_para_cada_Vista|Barra de Herramientas]] como una más de las ofrecidas y/o se pueden poner en juego desde la [[Manual:Barra de Entrada|Barra de Entrada]]  o incorporar a un [[Referencia:Xml#Programas - Guiones (Scripting)|''guion'' o ''script'']].   
{{Note:Vewr también, para mayores detalles, el tutorial  [[Tutorial:Preparando Herramientas Propias en la Barra|Preparando Herramientas Propias en la Barra]].
+
{{Note|1=Ver también, para mayores detalles, el tutorial  [[Tutorial:Preparando Herramientas Propias en la Barra|Preparando Herramientas Propias en la Barra]].}}
  
'''Method 2.''' Any Javascript functions that you define in the Global Javascript section of the Scripting tab will be available to use from Javascript elsewhere in GeoGebra.
+
'''Método Nº 2.''' Cualquier función [[Referencia:JavaScript|''Javascript'']] definida en la sección Global de la pestaña de ''Guiones-Script'' quedará disponible para emplearse desde [[Referencia:JavaScript|''Javascript'']] en cualquier instancia de GeoGebra.
  
'''Method 3.'''  Los guiones de GeoGebra no cuentan con respaldo para incluir subrutinas pero se pueden obtener los mismos resultados usando el comando [[Comando EjecutaAlClic|EjecutaAlClic[]]].<br>Create an object, let's call it myObject, and enter some scripting code in myObject's On Click script. You can then invoke the code from other objects or from the input bar using RunClickScript[myObject]. If needed, inputs and outputs can be passed to the subroutine via additional objects.
+
'''Método Nº 3.'''  Los guiones de GeoGebra no cuentan con respaldo para incluir subrutinas pero se pueden obtener los mismos resultados usando el comando [[Comando EjecutaAlClic|EjecutaAlClic]].<br>Al crear un objeto, llamado por ejemplo, '''''miObjeto''''' e ingresar algún código de ''guion'' o ''script'' '''''Al clic''''', se puede invocar el código desde otros objetos o desde la [[Manual:Barra de Entrada|Barra de Entrada]] empleando el comando [[Comando EjecutaAlClic|EjecutaAlClic]](miObjeto).<br>Si se lo requiere, pueden ''pasarse'' entradas y salidas a la subrutina vía objetos adicionales.
 +
<h4>Ejemplo Detallado</h4>
 +
Aquí se desarrolla un ejemplo más detallado.<br>Dados cinco puntos '''''A''''', '''''B''''', '''''C''''', '''''D''''' y '''''E''''' si se requiere que cada uno de ellos se torne rojo al darle ''clic'', se lo puede lograr de diferentes maneras;
 +
*Escribiendo un ''guion'' `por separado para cada punto.<br>Para '''''A''''' sería  <code>Color(A,1,0,0)</code>; para '''''B''''', <code>Color(B,1,0,0)</code>, etc.<br>Si se deseara cambiar de rojo a verde más adelante, sería preciso editar cada guion del correspondiente punto por separado. Lo que sería sumamente tedioso si se tratara de numerosos puntos.
  
Here's a more detailed example.  Suppose that you have 5 points, A, B, C, D and E, and you want each point to turn red when clicked.  One way you could achieve this is to write a separate 'On click' script for each point: for point A you would use <code>SetColor[A,1,0,0]</code>; for point B you would use <code>SetColor[B,1,0,0]</code>, etc.  If you decide to change from red to green later on though, then you must edit each point's script separately.  If you have a lot of points then this can be tedious.
+
En cambio, todo es más ágil usando una subrutina que, por ejemplo, creando un objeto llamado '''''destino''''' ingresando lo siguiente:<br>
  
Instead, let's use a subroutine.  Create a text object called target by typing
+
<code>destino = "A"</code>
  
<code>target = "A"</code>
+
En la [[Manual:Barra de Entrada|Barra de Entrada]], se puede emplear este objeto como entrada de una función propia.
  
in the input bar.  We'll use this object as an input for our function.
+
A continuación, se crea un botón llamado '''''miBotón'''''.  
 
+
{{OJo|1=No es preciso emplear un [[:Categoría:Objetos_de_Acción#Botones|botón]]; cualquier tipo de objeto operaría de la misma manera.}}
Next create a button called myButton. (You don't need to use a button; in fact, any kind of object should work just as well.)  In myButton's 'On click' script, enter the following:
+
A '''''miBotón''''' se le asocia un guion ''Al clic'' como el que se anota a continuación:
  
 
<code>
 
<code>
Execute[{"SetColor[" + target + ",1,0,0]"}]
+
Ejecuta({"Color(" + destino + ",1,0,0)"})
 
</code>
 
</code>
  
Now go to point A and enter the following in A's 'On click' script:
+
Así, al dirigirse al punto '''''A''''' y asociarle el siguiente guion ''Al clic'':
  
 
<pre>
 
<pre>
target = A
+
destino = "A"
RunClickScript[myButton]
+
EjecutaAlClic(miBotón)
 
</pre>
 
</pre>
 +
Se hace lo mismo para cada uno de los puntos restantes, reemplazando en la primera línea la '''''A''''' por la letra correspondiente ('B', 'C', 'D', 'E' respectivamente).<br>
 +
Ahora, un ''clic'' en uno de los puntos lo tornará rojo.
 +
Si más adelante se prefiere el verde al rojo, sólo se precisa cambiar la línea correspondiente en el guion '''''Al clic''''' asociado a '''''miBotón''''' y dicha modificación afectará a todos y cada uno de los puntos en juego.<br>
 +
Este método será mucho más adecuado que el de un guion individual por punto cuanto más numerosos sean.
 +
 +
¿Cómo opera este procedimiento?  Un ''clic'' en el punto 'B', por ejemplo, desencadena el guion 'Al clic' vinculado al nombre 'B' en el objeto de texto <code>destino</code>.  Esto ejecuta la subrutina almacenada en  <code>miBotón</code> como guion 'Al clic' usando el comando <code>EjecutaAlClic(miBotón)</code>.
 +
 +
El guion ''Al clic'' de <code>miBotón</code> se concreta. La línea  <code>Ejecuta({"Color(" + destino + ",1,0,0)"})</code> constituye un comando  GeoGebra como:<br>
 +
<code>"Color(" + destino + ",1,0,0)"</code><br>
 +
... que se ejecuta usando <code>Ejecuta()</code>.<br>
 +
El resultado final es el comando <code>Color(B,1,0,0)</code> que opera tornando rojo al punto '''''B'''''.
 +
 +
<h3>Ejemplo de Hoja Dinámica</h3>
 +
 +
El boceto ilustra ''animadamente'' el funcionamiento de esta hoja de trabajo dinámica cuyo título e indicaciones se copian a continuación:<br>
 +
 +
'''Título'''<br>
 +
Ejemplo empleando EjecutaAlClic para emular una subrutina<br>
 +
 +
'''Texto previo a  la construcción'''<br>
 +
Este ejemplo muestra un modo de usar un guion de tipo 'Al clic' asociado a objetos como subrutina que puede emplearse en cualquier lugar usando el comando correspondiente.<br>
 +
 +
'''Texto posterior a la construcción'''<br>
 +
Con un clic en cualquier punto A, B, C, D o E se establece cuál es el 'destino'  que toma el nombre del punto. Ese 'clic' también desencadena el guion asociado al botón 'miBotón' que es el que provoca el cambio de color en el punto de 'destino' indicado por el 'clic'.<br>
 +
 +
<center>'''<ggb_applet width="237" height="188"  language="es" version="5.0" ggbBase64="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"/>'''</center><hr>
 +
 +
<h4>Ejemplo Previo</h4>
 +
En un registro previo de un ejemplo anterior, pueden verificarse diversos guiones.<br>
 +
<br>En el siguiente [[Tutorial:Guiones_Casillas_de_Control_Mutuamente_Excluyentes|ejemplo]] puede verse diversos guiones. Aquí se describe el precedente:
 +
 +
Ejecuta({"SetColor(" + destino + ",1,0,0]"}) ---- en el botón miBotón
 +
 +
y en cada uno de los puntos:
 +
 +
destino = "A"
 +
EjecutaAlClic(miBotón)
  
Do the same for B, C, D and E, but replace the 'A' in the first line with 'B', 'C', 'D', 'E' respectively.
+
... obviamente, cambiando la ''A'' por el correspondiente nombre del punto.
Now when you click on any of the points A, B, C or D, it will change to red.  If you decide that you want to use green instead, you only need to change the line in myButton's 'On click' and the change will take effect for A, B, C, D and E. If you have  large number of points, then this method may be wiser than having to change each point's script separately!
 
  
How does this work?  When you click on a point, 'B' let's say, then B's 'On click' script stores the name 'B' in the text object <code>target</code>. It then runs the subroutine that we stored in <code>myButton</code>'s 'On click' script using the command <code>RunClickScript[myButton]</code>.
+
<ggb_applet width="942" height="400" version="4.4" id="87569" enableRightClick="true" showAlgebraInput="false" language="es" enableShiftDragZoom="true" showMenuBar="true" showToolBar="false" showToolBarHelp="true" enableLabelDrags="false" showResetIcon="true" />
  
<code>myButton</code>'s 'On click' script now runs.  The line <code>Execute[{"SetColor[" + target + ",1,0,0]"}]</code> constructs a GeoGebra command (this is the <code>"SetColor[" + target + ",1,0,0]"</code> part), and then executes it using <code>Execute[]</code>.  The end result is that the command <code>SetColor[B,1,0,0]</code> gets executed, changing B to red.
 
 
[[Category:Tutoriales Avanzados]]
 
[[Category:Tutoriales Avanzados]]

Revisión actual del 20:35 12 ago 2020

Plantilla:Tutoriales

Funciones y Subrutinas

Las subrutinas (también denominadas funciones o procedimientos) involucran un concepto central en la programación y brindan una ayuda crucial en el mantenimiento de los programas dado que facilitan la reutilización. En este tutorial se describen mecanismos para emplearlas en GeoGebra.

Método Nº 1. Herramientas Personales o Propias: operan como una nueva función. Requieren entradas y producen objetos de salida resultantes. Se las puede incluir en la Barra de Herramientas como una más de las ofrecidas y/o se pueden poner en juego desde la Barra de Entrada o incorporar a un guion o script.

Nota: Ver también, para mayores detalles, el tutorial Preparando Herramientas Propias en la Barra.

Método Nº 2. Cualquier función Javascript definida en la sección Global de la pestaña de Guiones-Script quedará disponible para emplearse desde Javascript en cualquier instancia de GeoGebra.

Método Nº 3. Los guiones de GeoGebra no cuentan con respaldo para incluir subrutinas pero se pueden obtener los mismos resultados usando el comando EjecutaAlClic.
Al crear un objeto, llamado por ejemplo, miObjeto e ingresar algún código de guion o script Al clic, se puede invocar el código desde otros objetos o desde la Barra de Entrada empleando el comando EjecutaAlClic(miObjeto).
Si se lo requiere, pueden pasarse entradas y salidas a la subrutina vía objetos adicionales.

Ejemplo Detallado

Aquí se desarrolla un ejemplo más detallado.
Dados cinco puntos A, B, C, D y E si se requiere que cada uno de ellos se torne rojo al darle clic, se lo puede lograr de diferentes maneras;

  • Escribiendo un guion `por separado para cada punto.
    Para A sería Color(A,1,0,0); para B, Color(B,1,0,0), etc.
    Si se deseara cambiar de rojo a verde más adelante, sería preciso editar cada guion del correspondiente punto por separado. Lo que sería sumamente tedioso si se tratara de numerosos puntos.

En cambio, todo es más ágil usando una subrutina que, por ejemplo, creando un objeto llamado destino ingresando lo siguiente:

destino = "A"

En la Barra de Entrada, se puede emplear este objeto como entrada de una función propia.

A continuación, se crea un botón llamado miBotón.

Bulbgraph.pngAtención: No es preciso emplear un botón; cualquier tipo de objeto operaría de la misma manera.

A miBotón se le asocia un guion Al clic como el que se anota a continuación:

Ejecuta({"Color(" + destino + ",1,0,0)"})

Así, al dirigirse al punto A y asociarle el siguiente guion Al clic:

destino = "A"
EjecutaAlClic(miBotón)

Se hace lo mismo para cada uno de los puntos restantes, reemplazando en la primera línea la A por la letra correspondiente ('B', 'C', 'D', 'E' respectivamente).
Ahora, un clic en uno de los puntos lo tornará rojo. Si más adelante se prefiere el verde al rojo, sólo se precisa cambiar la línea correspondiente en el guion Al clic asociado a miBotón y dicha modificación afectará a todos y cada uno de los puntos en juego.
Este método será mucho más adecuado que el de un guion individual por punto cuanto más numerosos sean.

¿Cómo opera este procedimiento? Un clic en el punto 'B', por ejemplo, desencadena el guion 'Al clic' vinculado al nombre 'B' en el objeto de texto destino. Esto ejecuta la subrutina almacenada en miBotón como guion 'Al clic' usando el comando EjecutaAlClic(miBotón).

El guion Al clic de miBotón se concreta. La línea Ejecuta({"Color(" + destino + ",1,0,0)"}) constituye un comando GeoGebra como:
"Color(" + destino + ",1,0,0)"
... que se ejecuta usando Ejecuta().
El resultado final es el comando Color(B,1,0,0) que opera tornando rojo al punto B.

Ejemplo de Hoja Dinámica

El boceto ilustra animadamente el funcionamiento de esta hoja de trabajo dinámica cuyo título e indicaciones se copian a continuación:

Título
Ejemplo empleando EjecutaAlClic para emular una subrutina

Texto previo a la construcción
Este ejemplo muestra un modo de usar un guion de tipo 'Al clic' asociado a objetos como subrutina que puede emplearse en cualquier lugar usando el comando correspondiente.

Texto posterior a la construcción
Con un clic en cualquier punto A, B, C, D o E se establece cuál es el 'destino' que toma el nombre del punto. Ese 'clic' también desencadena el guion asociado al botón 'miBotón' que es el que provoca el cambio de color en el punto de 'destino' indicado por el 'clic'.


Ejemplo Previo

En un registro previo de un ejemplo anterior, pueden verificarse diversos guiones.

En el siguiente ejemplo puede verse diversos guiones. Aquí se describe el precedente:

Ejecuta({"SetColor(" + destino + ",1,0,0]"}) ---- en el botón miBotón

y en cada uno de los puntos:

destino = "A" EjecutaAlClic(miBotón)

... obviamente, cambiando la A por el correspondiente nombre del punto.

© 2024 International GeoGebra Institute