Macros

Fecha de realización: 15 de Septiembre del 2014
Macros
Las macros son objetos gráficos compuestos y pueden ser de dos o tres dimensiones. Muchas escenas que tienen un solo espacio pueden generar un macro y convertirse así en un objeto gáfico compuesto que puede usarse en otras escenas. Por ejemplo los ejes coordenados que aparecen en la escena izquierda están definidos a partir de objetosgráficos básicos mientras que los de la escena de la derecha son un solo objeto gráfico, es decir, un macro.
Los macros pueden tener parámetros que pueden ser usados para modificar su aspecto y su comportamiento. Por ejemplo los controles numéricos que hay en la escena derecha actúan sobre los parámetros del macro que en este caso son longitud y punta y representan la longitud de cada eje y el tamañode la punta de flecha que hay en cada uno.
Pero los macros además pueden tener un conjunto de funciones y algoritmos propios que les pueden otrogar una funcionalidad predefinida y/o modificable. Por ejemplo la siguiente escena utiliza dos macros (dinamica/resorte y dinamica/masa) para crear de una manera muy sencilla una escena con mucha funcionalidad.
El propósito de esta página esdescribir qué son, cómo se crean y cómo se usan los macros.
¿Qué es un macro?
Un macro es un archivo de texto que debe colocarse en un sitio específico. Hay dos formas posibles de acomodar los macros: con direccionamiento general o con direccionamiento particular.
1) Direccionamiento general.  (Macros del Sistema.)
Hay que colocar los macros en ciertos subdirectorios relativos al codebase, es decirrelativo a donde se coloca Descartes3.jar. Los macros de dos dimensiones deben colocarse en el subdirectorio:
macros/g2d/
y los de tres dimensiones en:
macros/g3d/
o bien en subdirectorios de ellos. El nombre del macro debe incluir los subdirectorios adicionales a los arriba especificados. Por ejemplo si un macro se coloca en la dirección relativa
macros/g2d/dinamica/masa
el identificador delmacro, es decir lo que hay que escribir en el campo de texto expresión es:
dinamica/masa.
Los macros que se colocan con direccionamiento general podrán ser públicos y utilizados por diversos autores.
2) Direccionamiento particular. (Macros particulares o de las aplicaciones.)
Se pueden colocar los macros en la misma carpeta donde se encuentra la página que contiene a la escena o en subcarpetas deella.
Para que el direccionamiento particular sea posible es necesario que el codebase sea del tipo "./", "../", "../../","../../../", etc..., es decir, es necesario que las páginas con las escena se encuentren en subcarpetas de la que contiene a Descartes.jar o en subcarpetas de ellas, etc...
¿Qué contenido tiene un macro?
Un archivo de texto que es un macro contiene varias líneas. La primeraespecifica si es de dos o tres dimensiones: tipo_de_macro=R2  o  tipo_de_macro=R3. Luego vienen líneas que definen los auxiliares del macro y finalmente las líneas que definen los gráficos del macro. Las líneas que definen auxiliares y gráficos son exactamente las que aparecen al pulsar las etiquetas azules Auxiliar o Gráfico en los respectivos paneles de configuración.
Por ejemplo el contenidodel archivo de texto que constituye el macro dinamica/masa que es uno de los utilizados en la segunda escena de arriba es éste:
Como puede comprobarse (por ejemplo mirando el título de la ventana) la dirección relativa al codebase de este archivo es: macros/g2d/dinamica/masa.
Nota: Cuando una escena se transforma en macro sólo se traspasan al macro los auxiliares y los gráficos. Los controles,la animación y las demás partes de una escena no pasan al macro.
¿Cómo utiliza los macros un autor de escenas de Descartes?
El sistema puede tener un conjunto amplio de macros registrados explícitamente. Estos serán los llamados macros del sistema y deben tener direccionamiento general.
La utilización de los macros para configurar escenas es como la de cualquier otro gráfico. Si se desea usar...