{"id":2403,"date":"2014-10-28T20:08:16","date_gmt":"2014-10-28T19:08:16","guid":{"rendered":"http:\/\/descartesjs.org\/documentacion\/?p=2403"},"modified":"2021-08-07T16:42:42","modified_gmt":"2021-08-07T15:42:42","slug":"macros-en-el-editor-de-configuracion","status":"publish","type":"post","link":"https:\/\/reddescartes.org\/documentacion\/macros-en-el-editor-de-configuracion\/","title":{"rendered":"Macros en el editor de configuraci\u00f3n Java y en el int\u00e9rprete Java"},"content":{"rendered":"
\n

\u00bf<\/strong>Qu\u00e9 es una macro?<\/strong><\/h3>\n

Una\u00a0macro<\/strong><\/em>\u00a0es un\u00a0archivo de texto<\/strong>\u00a0que contiene parte del c\u00f3digo de una escena de Descartes y que interpretado por Descartes act\u00faa como un gr\u00e1fico en una escena.<\/p>\n

Podemos distinguir dos tipos de macros: Macros del Sistema o Macros de usuario. Los primeros son macros que previamente se han construido y que est\u00e1n incorporados al c\u00f3digo del int\u00e9rprete de Descartes en Java Descartes5.jar, y los segundo son macros que puede definir el usuario y que no est\u00e1n integrados en el int\u00e9rprete.<\/p>\n

objetos cartesianos debe colocarse en un sitio espec\u00edfico. Hay dos formas posibles de acomodar las macros: con\u00a0direccionamiento general<\/strong>\u00a0o con\u00a0direccionamiento particular<\/strong>.<\/p>\n

1)\u00a0Macros del Sistema<\/strong><\/p>\n

Los macros del sistema tienen una organizaci\u00f3n interna en diversos subdirectorios y para su localizaci\u00f3n es necesario aportar el direccionamiento adecuado. Este direccionamiento es aportado por el editor de configuraci\u00f3n de manera autom\u00e1tica y ha de respetarse para que pueda ser accesible. En la figura siguiente puede observarse a un primer nivel el directorio macros<\/em>, en un segundo nivel g2d<\/em> y g3d<\/em> (macros de gr\u00e1ficos 2d y 3d respectivamente) y un tercer nivel y sucesivos donde se agrupan los macros por su tem\u00e1tica. Para un detalle completo de todos estos macros puede consultarse el art\u00edculo\u00a0Relaci\u00f3n de macros del sistema<\/a>.<\/p>\n

\"Organizaci\u00f3n<\/a>

Organizaci\u00f3n interna de los macros del sistema<\/p><\/div>\n

Dado que los macros 2d est\u00e1n ubicados en el subdirectorio\u00a0macros\/g2d\/<\/em> y los 3d en macros\/g3d\/<\/em> el editor de configuraci\u00f3n presupone este direccionamiento y s\u00f3lo aporta como par\u00e1metro en la escena el direccionamiento relativo a esos dos subdirectorios anteriores.<\/p>\n

As\u00ed pues el macro\u00a0masa<\/em> que est\u00e1 ubicado en\u00a0macros\/g2d\/dinamica\/masa<\/em> en el par\u00e1metro\u00a0expresi\u00f3n<\/strong>\u00a0del c\u00f3digo de la escena aparecer\u00e1 referenciado como\u00a0dinamica\/masa<\/em>.<\/p>\n

Todos estos macros son\u00a0p\u00fablicos y pueden ser utilizados por cualquier\u00a0desarrollador de escenas.<\/p>\n

2)\u00a0Macros de usuario o particulares<\/strong><\/p>\n

Un usuario puede crear sus macros y ubicarlos en la misma carpeta donde se encuentra la p\u00e1gina que contiene a la escena o en subcarpetas de ella.\u00a0Para usarlos tendr\u00e1 que indicar el direccionamiento adecuado para que el int\u00e9rprete de Descartes pueda acceder a ese fichero y leer su contenido.<\/p>\n

\u00bfQu\u00e9 contenido tiene una macro?<\/strong><\/h3>\n

Un archivo de texto que es una macro contiene varias l\u00edneas. La primera especifica si es de dos o tres dimensiones:\u00a0tipo_de_macro=R2<\/em> o\u00a0tipo_de_macro=R3<\/em>.\u00a0Luego vienen l\u00edneas que definen los objetos auxiliares del macro y, finalmente, las l\u00edneas que definen los gr\u00e1ficos del macro. Las l\u00edneas que definen auxiliares y gr\u00e1ficos son exactamente las que aparecen al pulsar las etiquetas azules Auxiliar o Gr\u00e1fico en los respectivos paneles de configuraci\u00f3n.<\/p>\n

Por ejemplo el contenido del archivo de texto que constituye el macro\u00a0dinamica\/masa<\/strong>\u00a0que es uno de los utilizados en la segunda escena de arriba es \u00e9ste:<\/p>\n

\n\n