• Editores de configuración de Descartes

    El diseño, escritura o modificación del código de una escena puede efectuarse de diferentes maneras:

    1. Si se conoce la sintaxis de los parámetros correspondientes a los objetos cartesianos que se quieren incorporar basta usar un editor de texto plano, es decir, que éste no incorpore códigos de formato ajenos a los caracteres a registrar, o bien usar un editor de páginas html en la modalidad de edición de código. Se incluirán o modificarán los parámetros deseados y el código de la escena resultante habrá de incluirse o estará incluido en el cuerpo de una página html, es decir, entre las etiquetas <body> y </body>. También tendrá que incorporarse la referencia para localizar el intérprete de Descartes que se desea usar.

    Para las escenas a interpretar con Java el código de las mismas estará comprendido entre la etiqueta <applet> y </applet> y para el intérprete DescartesJS las etiquetas son <ajs> y </ajs>.

    Página html con una escena

    Página html con una escena y esquema conceptual

    2. Se puede partir de una escena y usar el editor de configuración que está integrado en el propio intérprete,  a él se accede posicionando el ratón sobre la escena y pulsando el botón auxiliar del mismo (el derecho para configuraciones diestras) se mostrará una ventana que contiene un botón etiquetado como config (ver acceso al código de una escena). El editor integrado es:

    acceso al código

    Acceso al código desde el editor de configuración integrado en el intérprete de Descartes Java

    Los cambios que se realicen a la escena pueden aplicarse y observarse en el navegador, pero no hay posibilidad de grabación directa de ellos, es decir si se cierra o recarga la página se perderán. Para poder guardar los cambios es necesario copiar el código de la escena (en el editor Java hay que pulsar el botón código y en el de javascript el código es sobre el se está trabajando directamente) y utilizar un editor de textos, como se ha indicado en la opción anterior, para pegarlo y guardarlo en un archivo html.

    3. Utilizar el gestor de escenas desarrollado en Java.

    4. Optar por el  editor interactivo desarrollado en javascript.

  • Textos y Editor de textos y fórmulas

    En el apartado de gráficos, podemos insertar textos en las escenas Descartes, tal como lo indica la siguiente imagen:

    t1

    Una vez seleccionada la opción, en el panel de configuración podemos escribir el texto en la casilla que se muestra al lado del boton texto:

    t2

    Si deseamos incluir algunas porpiedades especiales al texto, hacemos clic en el botón con la etiqueta texto. Este botón permite editar el texto que puede insertarse en la escena Descartes. Al pulsarlo aparecen dos opciones:

    t3

    La opción «Texto simple», permite cambiar algunos atributos básicos, tales como el tipo de letra, tamaño, negrita y cursiva:

    t4

    En la opción «Texto con formato», es posible acceder a unos atributos mas amplios, los cuales se decribiran en el resto de este apartado:

    t5

    En esta ventana de edición de textos se puede editar el contenido del texto, así como el tipo, el estilo y el tamaño de la letra del texto. El texto que se escribe puede tener varias líneas; el área de texto donde se realiza la escritura no hace el plegado de líneas sino que esto debe hacerlo manualmente el autor.

    Los textos de Descartes pueden tener varios colores. Además pueden presentar letras griegas, símbolos matemáticos y otros carácteres. Finalmente, lo que es más importante, pueden incluir fórmulas matemáticas desplegadas en el estilo de escritura clásico de fórmulas. El color de fondo es el mismo que el del espacio al que corresponde el texto. La siguiente imagen ilustra toda la funcionalidad descrita.

    t6

    A continuación se detalla cómo funciona la edición de textos, la tabla de símbolos y el editor de fórmulas.

    Edición de textos

    La parte izquierda de la línea de controles de edición de textos tiene los controles que sirven para definir el tipo, tamaño y estilo de letra y el color del texto.t7

    En concreto aparecen los siguientes componentes o controles:

    1. Un selector para elegir el tipo de letra: Ofrece tres tipos:Monospaced, Serif o SantSerif, equivalentes a Courier, TimesRoman y Helvética (o Arial) respectivamente.Su valor en cada momento indica el tipo de letra en el sitio del cursor.
    2.  Un selector para elegir el tamaño de la fuente (en puntos).Ofrece casi todos los valores pares entre 8 y 80. Del 28 al 48 va de cuatro en cuatro y a partir de allí de ocho en ocho.Su valor en cada momento indica el tamaño del texto en el sitio del cursor.
    3. Tres interruptores para definir el estilo de la fuente: negritacursiva y subrayada y con raya arriba (para vectores por ejemplo), los cuales pueden combinarse como se desee.
    4. Un botón del color del sitio “C” donde se encuentra el cursor que al pulsarse abre el editor de colores con el que se puede definir cualquier color. Al pulsarse abre el editor de colores para editar el color de las letras. Si se pulsa manteniendo la tecla ‘Ctrl’ apretada, entonces se edita el color de ‘fondo’ de las letras. Si se elige color totalmente transparente entonces desaparece el color de fondo, lo cual se traduce en que el color de fondo del botón se hace gris.
    5. Un interruptor editor para elegir modo de edición, que es el que aparece de inicio y permite modificar el texto.
    6. Un interruptor ver para elegir modo de edición, que es el que aparece de inicio y permite modificar el texto. En este modo las fórmulas aparecen rodeadas por un rectángulo. Para editar una fórmula hay que hacer un doble clic sobre ella, lo cual abrirá el editor de fórmulas.
    7. Interruptor para elegir modo de edición, que es el que aparece de inicio y permite modificar el texto.En este modo las fórmulas aparecen rodeadas por un rectángulo. Para editar una fórmula hay que hacer un doble clic sobre ella, lo cual abrirá el editor de fórmulas.
    8. Un boton ayuda para entrar a modo de ayuda. Al pulsarlo aparece el cursor de la mano y haciendo clic con él en cualquier componente se obtiene una explicación de él.
    9. Un botón unicode que abre la tabla de símbolos UNICODE, en la que puede elegirse entre muchos caracteres, incluyendo letras griegas y símbolos matemáticos. El caracter seleccionado en la tabla se insertará en donde se encontraba el cursor al pulsar este botón.
    10. Un botón formúla para insertar una fórmula. Las fórmulas aparecen en el texto rodeadas por un rectángulo y se comportan como un solo caracter algo grande. Para modificar una fórmula hay que hacer un doble clic sobre ella, con lo cual aparece el editor de fórmulas.
    11. Un botón RTF que abre una ventana en la que aparece el código RTF del texto. Ese texto puede copiarse y ponerse en un archivo con extensión .rtf y podrá ser leído por diversos editores que reconocen el formato RTF como WordPad. Sin embargo las fórmulas no aparecerán en esos editores.
    12. «Insert Char» Inserta, en el texto o fórmula seleccionados, el carácter indicado. También puede arrastrar el carácter al texto activo.
    13. «Simbolos Especiales» selecciona la lista de caracteres especiales que aparece abajo.Hay tres opciones:
      1) símbolos (operadores),
      2) Alfa. GRIEGO (mayúsculas)
      3) Alfa. griego (minúsculas)
    14. «15 char in hex TextField tf» Muestra el código Unicode del carácter a la derecha del cursor. Si se escribe ún código Unicode en formato hexadecimal y se pulsa &lt;intro&gt; se insertará en el texto o en la fórmula el carácter correspondiente a dicho código.
    15. Un botón imagen que abre la ventana para editar las imágenes. Se pueden agregar, eliminar, cambiar de orden y escribir sus coordenadas.

    Todos estos controles actúan sobre el sitio donde se halla el cursor predefiniendo así el tipotamaño estilo de letra y el color con el que se va a escribir inmediatamente. Si se hace un cambio de letra o color y en lugar de empezar a escribir se mueve el cursor, este cambio se pierde. Si en el momento en que se hace un cambio de tipotamaño o estilo de letra o de color se tiene marcado un segmento del texto, entonces el cambio se aplica al segmento marcado.

    La edición funciona con las convenciones acostumbradas:

    • Para marcar un segmento hay que arrastrar el ratón o mover las flechas con Control apretado.
    • Un doble clic sobre una palabra la marca. 
      Nota: Un doble clic sobre una fórmula abre el editor de fórmulas, por tanto si se quiere marcar una fórmula hay que hacerlo arrastrando el ratón o moviendo las flechas con Control apretado.
    • Un triple clic sobre una palabra marca toda la línea.
    • Para copiar un segmento marcado hay que pulsar Control-C.
    • Para copiar un segmento marcado y borrarlo al mismo tiempo hay que pulsar Control-X.
    • Para pegar el texto copiado en un sitio hay que colocar el cursor donde se desea pegar y pulsar Control-V.

    Los controles de la línea superior se actualizan con cada movimiento del cursor indicando los valores correspondientes a la posición del cursor. El cursor mismo cambia de tamaño y de estilo de acuerdo con el sitio donde se encuentra.

    Nota: Conviene observar que en la frontera entre dos tipos de letra o dos colores, el cursor se comporta así: adquiere el tipo, tamaño, estilo de letra y el color que corresponde al último carácter que cruzó. Es decir, si viene de la derecha queda con los atributos del carácter a su derecha y si viene de la izquierda conserva los atributos del que tiene a su izquierda.
    La parte derecha de la línea de controles de edición de texto tiene los controles necesarios para insertar un símbolo especial, una fórmula matemática, o una expresión.
    Los controles de la línea superior se actualizan con cada movimiento del cursor indicando los valores correspondientes a la posición del cursor. El cursor mismo cambia de tamaño y de estilo de acuerdo con el sitio donde se encuentra.
    Nota: Conviene observar que en la frontera entre dos tipos de letra o dos colores, el cursor se comporta así: adquiere el tipo, tamaño, estilo de letra y el color que corresponde al último carácter que cruzó. Es decir, si viene de la derecha queda con los atributos del carácter a su derecha y si viene de la izquierda conserva los atributos del que tiene a su izquierda.
    La parte derecha de la línea de controles de edición de texto tiene los controles necesarios para insertar un símbolo especial, una fórmula matemática, o una expresión.

    Tabla de símbolos

    Descartes utiliza el sistema de símbolos “UNICODE”. UNICODE es un sistema de numeración de las letras de todos los alfabetos del mundo y de muchos carácteres especiales. Probablemente en el futuro los ordenadores podrán representar todos los carácteres de este sistema. En general en los ordenadores actuales se encuentran muchos de estos símbolos ya integrados, pero no todos. Así es posible que en un ordenador aparezca un símbolo que en otro ordenador no aparece. Afortunadamente los símbolos más usados como las letras griegas aparecen ya en casi todos los ordenadores. Cuando un símbolo no está integrado en un sistema se representa mediante un cuadrado.

    Al pulsar el botón Tabla en la ventana de edición de textos se abrirá la tabla de símbolos UNICODE en la que se puede elegir el símbolo deseado.

    t8

    La tabla de símbolos tiene este aspecto:

    t9

    Esta ventana ofrece una manera de acceder a la tabla UNICODE y seleccionar uno de los caracteres UNICODE entre el 0000 al 26FF (la numeración es hexadecimal). Recordemos que si algunos aparecen como un cuadrado es porque  no existen o no están disponibles.

    A la izquierda de la ventana aparece una lista de los alfabetos y grupos de símbolos. Es una lista de los principales alfabetos del sistema UNICODE. Al seleccionar un elemento de la lista se despliegan a la derecha los caracteres de ese alfabeto o grupo de símbolos. Pulsando el botón del símbolo deseado la tabla de símbolos se cerrará y la letra seleccionada se escribirá en el editor (en el sitio donde estaba el cursor cuando se abrió la tabla de símbolos).

    En el selector de abajo a la izquierda puede seleccionarse cualquier número múltiplo de 16 (hexadecimal 10) para desplegar el segmento de la tabla UNICODE que se desee entre 0000 y 2600. Si el selector tiene el foco, entonces pulsando la flecha hacia arriba o la flecha hacia abajo se logra desplazar la tabla UNICODE línea a lína y puede así revisarse toda ella cómodamente. Cuando la base del segmento coincide con uno de los alfabetos de la lista, éste aparece como seleccionado en ella.

    Editor de fórmulas

    Las fórmulas matemáticas elementales constan fundamentalemente de texto común y corriente más elementos matemáticos como fracciones,raíces cuadradassubíndices y superíndices (potencias o exponentes). Lo que hace complicada la presentación de una fórmula matemática no es la variedad de elementos que la componen, sino el hecho de que éstos pueden insertarse unos en otros arbitrariamente tantas veces como se quiera con lo cual el resultado puede ser muy complejo.

    Como muestra basta un botón:

    Esta es una fórmula en Descartes. De hecho es una escena de Descartes, como el lector puede comprobar haciendo un doble clic sobre ella. Escribir una fórmula como ésta es muy fácil usando el editor de fórmulas de Descartes. Este editor permite escribir fórmulas elementales de cualquier grado de complejidad y Descartes las puede presentar en sus escenas.
    Las fórmulas de Descartes no existen independientemente de los textos sino como parte de ellos. Las fórmulas se insertan y editan dentro de laventana de edición de textos. Al pulsar el botón [F] a la derecha de la línea de controles de edición de textos, se insertará un rectángulo en el área de texto donde editar la fórmula deseada: el marco de fórmulas. Al mismo tiempo se activarán los botónes con los elementos matemáticos de que dispone DescartesÉstos son, en el orden en que aparecen en el cuadro rojo en la ventana de edición de textos abajo: fracciones, super- y subíndices, raíces cuadradas, sumas, integrales, matrices y expresiones.

    También se puede insertar una fórmula pulsando <control> y “f”.

    t10

    En la ventana de edición de textos, las fórmulas siempre están en modo de edición: aparecen en el marco de fórmulas.

    Para empezar a editar la fórmula, es suficiente poner el cursor al principio del marco de fórmulas y pulsar sobre el elemento matemático requerido para insertar éste en el marco. En un marco, se puede insertar cualquier cantidad de elementos matemáticos, en cualquier sitio y cualquier orden. También se pueden insertar símbolos (por ejemplo el símbolo π) con la tabla de símbolos y carácteres con el teclado del ordenador, en cualquier parte de la fórmula.

    Los elementos matemáticos siempre aparecerán blancos, es decir sin ningún valor por defecto, y se pueden configurar todas sus partes. En cada parte configurable de un elemento matemático pueden insertarse otros elementos matemáticos, así como símbolos y carácteres.

    Dentro del marco de fórmulas, se puede mover entre las diferentes partes de la fórmula de 2 maneras: mediante las flechas que se encuentran del lado inferior derecho en el teclado del ordenador, o haciendo clic con el ratón para colocar el cursor sobre la parte que se desea editar. Quedará enmarcada en un rectángulo la parte a la que se accedió dentro del marco de fórmulas. 

    t11

    Los carácteres y símbolos en las fórmulas matemáticas se pueden editar de la misma manera como edición de textos.  El tipo, y estilo de letra se puede cambiar a nivel de los caracteres individuales.

    t12

    En las escenas de Descartes, las fórmulas matemáticas aparecerán como un solo carácter sin el marco de edición.

    t13

    A continuación se explican las características de la edición de cada elemento matemático particular.

    • Fracción
      Se puede insertar cualquier elemento matemático, símbolo o carácter tanto en la parte inferior como en la parte superior. Por defecto, el cursor aparecerá en la parte superior. Se puede mover de la parte superior a la parte inferior de la fracción y a derecha o izquierda, mediante las flechas para subir y bajar.

      También se puede insertar una fracción pulsando <shift> <control> y “_” .

    • Subíndice y superíndice
      Con el botón [x²] se pueden insertar superíndices. Por defecto el cursor aparecerá en el espacio de la base, y se puede mover entre las diferentes partes mediante las flechas.
      También se puede añadir un superíndice a un carácter normal pulsando <control> y “flecha arriba”. Para añadir un subíndice se pulsa <control> y “flecha abajo”.
      Se puede insertar cualquier elemento matemático, símbolo o carácter en el súper- y subíndice.
    • Raíz cuadrada
      Se puede insertar cualquier elemento matemático, símbolo o carácter en el radicando de la raíz así como debajo de la raíz. Por defecto, la raíz aparecerá con el marco de edición sobre el espacio del radicando.
      También se puede insertar una raíz cuadrada pulsando <control> y “r”.
    • Suma
      En la parte superior así como en la inferior se puede llenar cualquier elemento matemático, símbolo o carácter . Para mover entre la parte inferior y superior se utilizan las flechas para subir y bajar.
      También se puede insertar una suma pulsando <control> y “s”.
    • Integral
      Se puede escribir cualquier carácter o combinación de caracteres en la integral. También se puede insertar una integral pulsando <control> e “i”.
    • Matriz
      Al pulsar el botón de matriz, aparecerá una ventana para indicar el número de columnas (m) y renglones (n) que tendrá la matriz.

    t14

    La matriz aparecerá envuelta entre paréntesis y se puede mover sobre los renglones mediante las flechas izquierda/derecha. Además puede escribirse cualquier elemento, símbolo o carácter adentro de la matriz.

    • Expresión

    La inserción de una expresión aparece como [expr] encerrado en un rectángulo. La imagen de abajo muestra una fórmula donde hay varias expresiones insertadas, todas ellas se muestran como [expr] encerrado en un rectángulo.
    t15
    En realidad «detrás» de cada una de estas [expr] encerradas en rectángulos hay una expresión. Para acceder a ella hay que hacer un doble clic sobre el rectángulo. Por ejemplo al hacer un doble clic sobre el último rectángulo aparece el editor de expresiones:

    t16

    En este caso la expresión es a^2+b^2. Cuando se inserta una expresión nueva ésta siempre es “1” y para modificarla hay que abrir (con un doble clic) el editor de expresiones y modificarla allí. Esta expresión se evaluará y el resultado de la evaluación se escribirá con el número de decimales especificado y en formato fijo o ajustado de acuerdo con el interruptor.

    En el campo decimales hay que escribir el número de decimales (máximo) con el que se presentará el resultado de evaluar la expresión. Si no se especifica (es decir, si se deja en blanco) entonces se usará el valor de decimales heredado del objeto gráfico.

    El interruptor fijo determina si el número de decimales es fijo o se usa formato ajustado eliminando los ceros innecesarios a la derecha del punto decimal. La elección sólo es válida si el número de decimales no se deja en blanco pues cuando el número de decimales se deja en blanco se usa el valor de fijo heredado del objeto gráfico.

    También se puede insertar una expresión pulsando <control> y “e”.

  • Editor básico de configuración, de líneas, (javascript)

    El intérprete descartes-min.js lleva integrado un editor básico de configuración, un editor de líneas, que permite modificar el código de una escena de manera textual, en base a patrones de código que aporta el propio editor y sobre los que puede modificarse los valores específicos que tiene o quieren asignarse a la escena. Para esta edición es necesario conocer la sintaxis de cada parámetroy  los valores que pueden asignarse. El propio editor limita los campos que el usuario puede modificar.

    Para acceder al editor básico es necesario pulsar el botón config asociado a cada escena. Éste puede estar localizado explícitamente en la escena (ver imagen 1) o bien mediante la ventana auxiliar que se abre posicionando el ratón sobre la escena y pulsando su botón auxiliar, es decir el derecho en caso de diestros, ( ver imagen 2).

    Botón config incluido en una escenas

    Imagen 1. Botón config incluido en una escena

    Ventana auxiliar

    Imagen 2.Ventana auxiliar que permite acceder al botón config

    El aspecto de este editor es el reflejado en la imagen 3.

    Código en el editor básico

    Código de una escena en el Editor básico de líneas que incorpora el intérprete descartes-min.js

    Si al realizar la pulsación del botón config lo que le muestra es sólo un texto plano con el código de la escena, es que está usando un intérprete que no incorpora esta funcionalidad. Si desea que una escena pueda ser editada interactivamente mediante este editor de líneas es necesario que en la página que incorpora la escena incluya antes del script de llamada a la escena el siguiente script que lo que hace es incorporar el editor:

    <script type=’text/javascript’ src=’https://arquimedes.matem.unam.mx/Descartes5/lib/descartes_editor-min.js‘></script>

     

    Para una descripción de este editor puede consultarse «Cómo editar escenas con el editor básico de líneas«

  • Editor de configuración de Ítems

    Un Ítem es un tipo especial de escena de Descartes que tiene la estructura y la funcionalidad de un Discurso y que permite, en conexión con un servidor de Ítems, registrar los valores aportados por un usuario a los controles que el desarrollador ha definido como evaluables y abordar la evaluación de los mismos de acuerdo a los patrones dados por el autor del mismo. Un Ítem es una escena cuyo objeto es evaluar.

    Al insertar en el gestor de escenas un Ítem nuevo observaremos una escena como la siguiente:

    Un Ítem nuevo en el gestor de escenas

    1. Un Ítem nuevo en el gestor de escenas

    Para la edición de Ítems puede consultarse el artículo de «Editor de configuración de Discursos«.

    Véase también el artículo «Ítems de Descartes» para ubicar este tipo especial de escenas y la necesidad del Sistema de Evaluación A Distancia (SEAD) actualemente descontinuado. DescartesJS interpreta los ítems, pero la funcionalidad no es igual en especial en los campos de texto con barras de edición.

  • Editor de configuración de Discursos

    Los discursos de Descartes son un tipo especial de escenas en las que se proporciona un espacio base de edición, que se denomina escenario, y en él se pueden introducir textos y fórmulas de Descartes e intercalar, entre estos, otros objetos cartesianos como controles y espacios bi y tridimensionales.

    Al insertar en el gestor de escenas un Discurso nuevo observaremos una escena como la siguiente:

    Base inicial para la elaboración de un Discurso de Descartes

    Base inicial para la elaboración de un Discurso de Descartes

     

    Podemos observar tres zonas:

    1. La superior constituida por un conjunto de tres filas de selectores y botones. La primera y tercera que permiten la edición de cualquier texto y fórmula según es usual en la edición de textos en Descartes, y la segunda que son botones para insertar controles y espacios en el escenario. Estos se insertarán en la posición que se encuentre el cursor en el escenario en el momento que se pulse el botón elegido.

      Selectores y botones en la edición de Discursos

      Selectores y botones en la edición de Discursos

    2. Una segunda con fondo azul a modo de pleca que al hacer doble clic sobre ella abre una ventana donde se puede indicar el Título y el subtítulo que se desea poner al discurso que se está elaborando.

      Pleca de título y subtítulo

      Pleca de título y subtítulo

    3. Una tercera que es el escenario en sí donde se editan los textos y se combinan los controles y espacios de Descartes. Como guía se aporta un guión orientador, pero, si se desea, puede suprimirse completamente y diseñar aquel que se desee.
      Escenario en un Discurso

      Escenario en un Discurso

       

    Por ejemplo, en la siguiente imagen se puede observar un discurso en el que se ha incluido texto, un espacio bidimensional, una fórmula y un control tipo menú:

    Insertando textos, espacios y controles en un Discurso

    Insertando textos, espacios y controles en un Discurso

     

    Para editar los objetos cartesianos introducidos en el escenario ha de accederse al editor de configuración bien pulsando el botón situado en la parte superior derecha, bien haciendo doble clic sobre el discurso o bien a través del botón config que quedará accesible en la ventana auxiliar que aparece cuando pulsamos con el botón derecho del ratón. El editor de configuración que se obtiene es el correspondiente a Descartes 5 por lo que puede consultarse el artículo «Editor de configuración de escenas de Descartes 5«.

    Editor de configuración en un Discurso

    Editor de configuración en un Discurso