Presentación Aperitivo Ejemplos Documentación Aplicaciones
Nippe Descartes
Documentación.
IDIOMA /COLORES / ESPACIO / PARAMETROS
/ AUXILIARES / FUNCIONES / CONTROLES /
ECUACIONES / PUNTOS / SEGMENTOS / CURVAS
/ ARCOS / TEXTOS/ BOTONES
No es necesario que el usuario de Descartes estudie detalladamente la documentación de todas sus herramientas. El objetivo de esta documentación es aclarar las dudas que puedan surgirle a un usuario que utiliza Descartes al límite de sus posibilidades. Para comenzar a utilizar Descartes es suficiente estudiar el aperitivo.
El nippe Descartes cuenta con catorce herramientas para configurarlo. Estas herramientas le permiten mostrar una amplia variedad de gráficas interactivas y decidir algunos aspectos adicionales como el idioma.
Cada herramienta corresponde a uno de los "parámetros" que el applet Descartes entiende. Estos "parámetros" son los del applet, es decir, los que aparecen en una llamada al applet desde una página Web. Este es un ejemplo de una llamada al applet Descartes dentro de una página Web:
<applet code="Descartes.class"
codebase="./" archive="Descartes.jar"
width="400" height="300">
<param name="IDIOMA" value="español ">
<param name="COLORES"
value="FONDO=blanco;RED=grisClaro;EJES=grisObscuro;TEXTO=negro; ">
<param name="ESPACIO"
value="escala=25:min=5:incr=10;Ox=0:incr=32;Oy=0:incr=32; ">
<param name="PARAMETROS" value="a=2;b=4;c=-1 ">
<param name="CONTROLES" value=" ">
<param name="AUXILIARES" value=" ">
<param name="FUNCIONES" value=" ">
<param name="ECUACIONES" value="y=a*x^2+b*x+c:color=azul:editable=true
">
<param name="CURVAS" value=" ">
<param name="PUNTOS" value=" ">
<param name="SEGMENTOS" value=" ">
<param name="ARCOS" value=" ">
<param name="TEXTOS" value=" ">
<param name="BOTONES" value=" ">
</applet>
El lector podrá observar que hay 12 líneas entre las etiquetas <applet> y </applet>. Cada una de esas líneas comienza con <param name= y a continuación viene el nombre del parm entre comillas. Luego aparece value= y una cadena, entre comillas, que en la mayoría de los casos solo tiene un espacio, lo que quiere decir que ese parámetro no se está usando. Estos nombres y valores son lo que se llaman "parámetros" del applet. O sea que Descartes, como applet, tiene 12 parámetros. Para evitar confusiones con otros usos de la palabra parámetro, en estas páginas hemos llamado herramientas a los catorce parámetros de Descartes. El contenido de esta parte del documento es una explicación de cómo se configura cada una de estas herramientas (los parámetros del applet Descartes).
Comenzamos por algunas aclaraciones de carácter general.
Las cadenas que se pasan como value al applet Descartes usan el símbolo ; como separador entre las configuraciones de objetos del mismo tipo. Cuando se pulsa el botón config del applet Descartes, aparece una ventana que se llama la ventana de configuración de Descartes. Arriba a la derecha de esta ventana aparece un selector donde se pueden elegir las herramientas. Al elegir una de las herramientas aparece lo que se llama la ventana de configuración de la herramienta y en ella aparece la cadena correspondiente a value separada en varias líneas. Esas líneas corresponden a las subcadenas que se forman usando ; como separador. De esta manera, la configuración se hace más simple pues basta poner atención a la línea en donde se realiza la configuración de cada objeto. El símbolo ; no debe usarse nunca dentro de la ventana de configuración de una herramienta. Los símbolos ; que aparecen en la llamada al applet los pone el programa de configuración cuando se pulsa el botón <applet>.
Podremos clasificar las herramientas de Descartes en tres grupos: las herramientas gráficas, las auxiliares y la mixtas. Las herramientas gráficas son las que generan objetos con una representación gráfica relacionada con el sistema de coordenadas: ECUACIONES, PUNTOS, SEGMENTOS, CURVAS Y ARCOS. Las herramientas auxiliares son las que no tienen una representación gráfica relacionada con el sistema de coordenadas: COLORES, TEXTOS, PARAMETROS, AUXILIARES y FUNCIONES. Las herramientas mixtas son las que no se pueden clasificar como gráficas ni como auxiliares y son dos: ESPACIO y CONTROLES.
Herramientas auxiliares:
Herramientas mixtas:
Herramientas gráficas:
Para definir el color en cualquiera de las herramientas gráficas, hay que agregar, sepadada por : una expresión como esta: color=rojo, donde la palabra rojo puede sustituirse por cualquiera de los colores predefinidos o por una expresión hexadecimal (ver COLORES para una explicación de los colors predefinidos y las expresiones hexadecimales que definen colores).
Las herramientas gráficas tienen tres opciones comunes: fondo, rastro y sucesión cuya configuración se explica al final de esta página. fondo también puede usarse en los TEXTOS.
La opción fondo puede utilizarse en cualquiera de las herramientas gráficas y en TEXTOS para que se dibujen una sola vez y queden como elementos del fondo, igual que los ejes de coordenadas. Para activar esta opción hay que escribir, separada por : , la frase fondo=true. Las herramientas gráficas y los TEXTOS que tengan especificada la opción fondo=true solo se dibujan cuando se pulsa el botón Inicio o se modifican las variables del ESPACIO. Esto es muy útil para agilizar las gráficas interactivas, dejando como objetos de fondo aquellas gráficas que pueden ser lentas de dibujar y que no cambian nunca. Se trata de gráficas que suelen servir sólo como referencias para las otras. En la aplicación sobre las curvas cónicas, especialmente en la construcción y las propiedades de reflexión, se usa esta opción varias veces. Las herramientas gráficas y los TEXOS que no tengan especificada la opción fondo=true, se dibujan cada vez que hay un cambio en los parámetros. El valor por defecto de esta opción en todas las herramientas es fondo=false.
La opción rastro puede utilizarse en cualquiera de las herramientas gráficas para que queden dibujadas las gráficas anteriores cuando se hacen cambios. Para ello hay que escribir, separada por : , una expresión como rastro=rojo, donde la palabra rojo se puede sustituir por cualquier color. El color que se escriba es en el que quedarán dibujadas las gráficas anteriores, es decir, el "rastro" de la gráfica. Si se escribe rastro=false entonces no queda rastro y si se escribe rastro=true entonces el rastro queda dibujado en color gris. Para borrar el rasto basta pulsar sobre la ventana del applet con el botón derecho del ratón. Para ver una aplicación de esta opción vea el applet de la presentación.
La opción sucesión se puede utilizar en cualquiera de las herramientas gráficas para crear una familia de gráficas. Para dibujar familias de gráficas de ECUACIONES, SEGMENTOS, PUNTOS, ARCOS o CURVAS, basta agregar (separdo por : ) un enunciado como este:
sucesión=s[a,b]n
donde: s es el nombre de la variable que se usa en la definición de las gráficas para generar la familia, [a,b] es el intevalo de valores que va a recorrer s y n es el número de subintervalos en que se va a dividir [a,b]. El número de gráficas que se genera es n+1, a menos que a=b en cuyo caso solo hay una gráfica. El ejemplo familias de gráficas ilustra el uso de la opción sucesión, tanto en ECUACIONES como en ARCOS. El ejemplo tiro parabólico ilustra el uso de la opción sucesión en CURVAS.