Este primer artículo tratará sobre cómo obtener la librería FLARToolKit gracias a TortoiseSVN y sobre cómo poder correr nuestro primer ejemplo. He de explicar que todos los componentes de la librería los encontraremos vía SVN (Subversion), lo que nos llevará a instalar el software gratuito TortoiseSVN, explicaremos paso a paso desde cómo descargarlo hasta correr de manera muy sencilla uno de los proyectos que hay dentro de la librería.
Al entrar a la página de FLARToolKit, lo que encontraremos cuando queremos descargar es un link de este tipo:
svn checkout http://www.libspark.org/svn/as3/FLARToolKit/trunk/ FLARToolKit-read-only
Esto lo que nos indica es que podemos obtener los cambios más recientes y la última versión que se vaya desarrollando si usamos de manera adecuada lo que ellos nos proveen.
Lo primero que haremos será descargar TortoiseSVN. Una vez entremos a la página, damos click a Download, escogemos el instalador que corresponda a nuestra arquitectura e instalamos.
Ahora bien, hemos pasado quizá la parte más complicada, lo que sigue es de lo más sencillo; vamos a crear una carpeta con el nombre que querramos, en mi caso, se llama FLARToolKit. Dentro tengo una carpeta que recibe el nombre de Ejemplos y dentro hay algunos archivos con proyectos muy sencillos que he descargado de un par de páginas. Además de eso, tengo una carpeta que se llama SVN y es a la que asociaré a TortoiseSVN para descargar FLARToolKit. De esta manera:
- FlarToolKit
- Ejemplos
- SVN
Daremos un click derecho sobre la carpeta SVN y escogemos SVN Checkout, acceso que se ha creado tras la instalación. Ponemos en el cuadro URL of Repository lo siguiente:
http://www.libspark.org/svn/as3/FLARToolKit/trunk/
Dejamos en el cuadro Checkout directory la ruta de la carpeta y damos click a OK. En mi caso, quedaría así:

Checkout repository
TortoiseSVN ahora muestra un cuadro que indica estar descargando todos los archivos y carpetas que podemos encontrar si entramos directamente al repositorio. Tras un mensaje exitoso después de la descarga, damos una vez más click a OK.
¿Qué contiene cada una de esas carpetas?
Bien, no quiero entrar en detalles a explicar el contenido de cada una de esas carpetas en este post, para ello hay preparados otros artículos en donde se entrará a ver cada una de ellas de manera muy directa. Sin embargo veremos una muy breve explicación de lo que podemos encontrar allí.
- archive: dentro hay dos archivos comprimidos: FLARToolKit-rxxxx.zip y FLARToolKit-Starter-Kit.zip. Si nos fijamos en su contenido, veremos casi lo mismo que hay en las carpetas src y starter-kit respectivamente. Lo que nos lleva a pensar que son los archivos comprimidos de cada una de esas carpetas.
- bin: dentro hay un archivo con extensión SWC, podemos fijarnos en el contenido de este archivo si lo abrimos con algún programa compresor, investigando un poco nos daremos cuenta que ese tipo de archivos son usados por una aplicación de Adobe Flex. Cada SWC contiene un grupo de componentes entendidos por esta aplicación; estos incluyen un SWF y un XML llamado catalog.xml, que lista los contenidos del paquete y los componentes individuales del mismo. Ya hablaremos de este archivo.
- examples: el nombre de la carpeta lo dice todo. Son ejemplos sobre Realidad Aumentada.
- src: contiene todo el source o archivos fuente de FLARToolKit.
- starter-kit: contiene archivos con ejemplos de uso para comenzar a desarrollar nuestras aplicaciones. En esta carpeta nos centraremos en los próximos artículos ya que es de suma importancia entender cada archivo allí contenido para tener un buen manejo de FLARToolKit.
¡Corramos nuestra primer aplicación de FLARToolKit!
Para ello, iremos a la carpeta starter-kit y luego a la carpeta Data. Abriremos el PDF que hay dentro y veremos un cuadrito como este:

Marker File
Este cuadrito, como lo he llamado despectivamente, recibe el nombre de mark o marker file y es de suma importancia para el desarrollo de un proyecto. Es por ello que dedicaremos un post entero para entender el funcionamiento de estas imágenes. Por ahora, vamos a imprimir el PDF. Nos devolvemos a la carpeta starter-kit y abrimos Earth.swf o SimpleCube.swf, aceptamos la petición de cámara, ponemos nuestra hoja impresa de tal manera que el marker file aparezca en pantalla y… ¡voilá!

Simple Cube

Earth
Hemos conseguido nuestro objetivo, obtener FlarToolKit y dar un -para algunos- primer acercamiento a esta fabulosa herramienta. En el próximo artículo hablaremos sobre el marker file y en los siguientes sobre los componentes de la carpeta starter-kit.
Ya sabes que cualquier duda la puedes plantear como comentario y será contestada en la mayor brevedad posible. Muchas gracias por leernos.
Actualización: Los repositorios para la descarga por SVN han cambiado debido a que hay una nueva versión de FLARToolKit. Ahora, dentro de la carpeta src encontramos una que se llama examples, allí hay un archivo que se llama FLARToolKitExample_ColladaData.as. Éste archivo correspondería a lo que conocíamos como Earth.as. Otra alternativa es descargar los archivos antiguos del starter-kit desde la página del mini-tutorial de Saqoosha.










no he logrado hacer correr el programa pero to los archivos he descargado
MARCHENA: ¿Me podrías dar más detalles? Si entras a la carpeta starter-kit deben aparecerte los swf que nombro en el artículo, si abres alguno, permites la cámara y pones tu impresión frente a ella, debería funcionar todo. Ten en cuenta que no se trata de un programa, es un swf que se ha trabajado previamente en Flash (ya veremos cómo).
[...] Marker Files, como habíamos dicho en el artículo anterior, juegan un papel muy significativo en aplicaciones de FLARToolKit y en general, de Realidad [...]
tienes razon me rectifico he herrado en algunos pasos pero ya e logrado lo que muestras en tu blog gracias ahora como hago el resto para generar
gracias de antemano estoy en proceso de aprender
MARCHENA: me alegra que todo haya salido bien
Por ahora el nuevo artículo muestra cómo hacer un Marker File correcto. En los siguientes artículos verás desde el modelado 3D de un elemento hasta la puesta en escena en una aplicación de Realidad Aumentada.
[...] http://blog.aumentality.com/2009/08/22/empecemos-primeros-pasos/ [...]
hola, tengo una mac con procesador intel, ahora mi problema es que no puedo lograr ver los archivos .swf, no se si sera por que tengo problemas para activar la camara, tambien tengo instalado el versions y el flash que creo que lo podia remplazar por el fx.
@eduardo
Hola Eduardo! Es muy extraño el problema que se te presenta. Si la cámara te funciona en otras aplicaciones es probable que haya algo mal en nuestro código o en la manera en que Flash activa la cámara. Cuéntame si te funciona en otros programas e intenta también correr la aplicación en otros computadores. Espero tu comentario de regreso
yo utilizo blender, como bajo el plugin para exportar los modelos.
gracias
un saludo desde Bogotá colombia
@jorge aldana:
Hola Jorge!
Bueno, en el artículo del videotutorial encuentras los links, sin embargo, acá te lo vuelvo a dejar. Si tienes problemas instalando, avísame.
Hola ZoiX, me gustaria invitarte a que puedas dar una conferencia sobre relidad aumentada con Blender, para el día Blender del 13-Noviembre-2009, este año queremos que sea orientada al desarrolo de Vjuegos y es muy bueno mostrar que tambien se puede implementar en esta área.
gracias
jorge Aldana
@Jorge:
Me siento muy agradecido. Te concatcaré por mail en unas horas, ahora no estoy en casa. Muchísimas Gracias.
Hola Zoix, soy diego de chile, junto darte las gracias por toda la información que haz entregado a la comunidad, quisiera saber como poder subir a la web la aplicación flash, si es que lo has intentado. La verdad es que lo he probado con la carpeta bin-debug y bin-release y ninguna de las aplicaciones, que crea Flex, las he podido ver (on-line).
Otra duda que tengo es, que tan facil es poner una animación, es decir, colocar un .DAE animado (con huesos u otro metodo) que se visualice de esta manera.
de antemano muchas gracias
suerte!
@Dimm:
Hola Diego, respecto a tu primera pregunta, en la lista de usuarios de FLARToolKit se ha hablado de este tema y se ha llegado a soluciones como embeber el SWF en un nuevo proyecto en Flash, aunque, subir algunos de los archivos de la carpeta bin-debug debería funcionar.
En cuanto a la animación, es sencillo, sólo debes intentar hacer todo con huesos y marcar la casilla de animación al exportar el DAE.
Te recuerdo que pudes también usar el foro para resolver estas inquietudes
Hola ZoiX disculpa ya e visto tus ejemplos funcionando en otras partes y pues cuando los vi me emocione mucho asi que quise tratar de visualizarlos en mi propia computadora pero tuve un problema con el archivo Earth.swf ya que al intantar cargarlo me mostraba en archivo de la tierra y si estaba girando y todo pero todo en forma de poligonos si me pudieras aclarar mi problema te lo agradeceria mucho
@Walkuren:
No estoy seguro de darte una respuesta correcta, tendría que investigar un poco más porque es muy raro lo que te sucede. Te pediría el favor que abrieras el .DAE en ARtisan DAE Viewer para descartar que sea el .DAE y echarle un vistazo a la webcam, que finalmente creo que es la que tiene mayor parte en el problema, sin embargo, como te digo, no quiero asegurar nada aún, déjame investigar un poco más y si tu problema continúa por favor siéntete libre de dejar planteada tu duda en el foro. Muchas gracias por tu comentario
Hola nuevamente Maestro Zoix, te escribo nuevamente con una gran duda sobre un problema con mis archivos.dae
(antes que nada, me registré en el foro, pero no me llega el correo de verificación)
Estoy modelando un 3d muy simple el cual corresponde a un plano y a una textura pero no logro que se proyecte la textura en el la prueba de flex, sinó que solo se ve con unas lineas muy gruesas moradas sobre el objeto. A demás estoy trabajando con el 3d max 2009 pero a pesar de instalar los componentes de collada, solo logro que 3d max me reconzca la version de collada autodesk y la version de opencollada, y la version del plugin que bajo como ejecutable desde la pagina que tu recomiendas, no logro que sea identificada por el programa.
Te escribo realmente con mucha urgencia al punto que pongo una url para que revises el archivo tu mismo, te agradeceria la respuesta mas rápida posible sobre el problema que por este tema se me va la cabeza y no es broma man
porfavor cualquier orientacion a mi correo indexgrafics@gmail.com
realmente es urgente master Zoix.
(previsualice el archivo con el previsualizador de archivos dae y si se ve correctamente)
http://www.mediafire.com/?sharekey=1c075582ef6ec526312dbd5f2bdc5062e04e75f6e8ebb871
Jose, dos cosas, la primera, es que me gustaría mucho que las dudas de ahora en adelante sean planteadas en el foro.
Lo segundo, respecto a tu problema, estoy muy seguro que dentro de tu código le has puesto maya al DAE, por favor pega el código en pastebin.ca y pones el enlace, como te digo, si volvieras a plantear la duda en el foro con el código en pastebin te agradecería mucho.
Hola Soy Cristobal que buena todo funciona perfecto , ahora me queda una duda, si yo quiero cambiar el 3D por un video como lo hago, alguien sabe de un tutorial o me pueda explicar que hacer, gracias..
saludos
@Cristobal, te recomiendo que mires primero los dos videotutriales mientras en unos días publico el de video.
Zoix pero aun no tienes tutorial de como integrar un video, eso lo encontre excelente !!! espero ese tutorial
saludosssssssssssss
@Cristobal, gracias
Yo busqué videotutoriales cuando empecé con esto y no encontré alguno sobre video. Sin embargo, dame un poco de tiempo y publicaré el código y el videotutorial sobre cómo poner video en Realidad Aumentada.
hola zoix, tengo un pequeno problema y es que al instalar el TortoiseSVN todo marcha perfecto pero el problema comienza cuando a la carpeta le doy click derecho no aparece nada sobre el menu de TortoiseSVN, el sistema que tengo es el windows7 home premium, hayudameeee please
@alma, en mi laptop también tengo Windows 7, dame un poco de tiempo mientras instalo y hago pruebas y te estaré comentando. Mientras tanto puedes descargar el ZIP que Saqoosha publicó en uno de sus artículos.
- -
Actualización: @alma, instalé TortoiseSVN en el laptop y todo funciona sin problema, trambién están los accesos al dar click derecho.
Hola amigo!!!! espero que no te hayas olvidado del problemita que tengo para instalar el tortoise tengo Windows 7 Saludos!!! BYE
@alma, como te decía, lo instalé en mi laptop y funcionó bien, no entiendo qué puede estar pasando, reinstalarlo puede ser una opción.
hola zoix ya lo hice y siguen sin aparecer cuando le doy click derecho sobre la carpeta, pienso que windows7 tiene algun bloqueo que no logro desifrar, seguire intentando, muchas gracias zoix
@alma, puede que sea por lo que tú dices porque a mí me funciona bien, ya vendría a ser cosa de permisos de Administrador o algo parecido porque la verdad no tengo idea. Suerte y ojalá puedas
De todas maneras hay sitios que ofrecen el .zip con las librerías.
Hola.. excelente todo esto. Pude hacer que funcione el programa pero no puedo hacer que corra mi propio modelo, en este caso un Video. Hasta lo convertí de MPG a SWF pero no lo reconoce y me lo abre normalmente en el Firefox.
Cómo consigo que al poner el marker ejecute lo que yo quiero y no soloamente la tierra o el cubo?
Saludos
@Santiago, no puedes reemplazar así como así un .DAE por un video. Debes seguir unos pasos adecuados para lograr lo que necesitas. Te recomiendo que veas los tutoriales o te unas al foro para que tengas una mejor guía para hacer todo lo que quieres
hola, buenos dias, ya he instalado el TortoiseSVN , pero cuando intento acceder al repositorio como lo muestran al principio de este foro me sale este herror
OPTIONS of ‘http://www.libspark.org/svn/as3/FLARToolKit/trunk’: could not
, de antemano gracias , por tu ayuda en el video muestran justo lo que necesito….
Intenta de nuevo, yo veo que está disponible, sigue al pie de la letra los pasos
QUE PENA PERO EL ERROR CONTINUA
SERA PORQUE UTILIZO PROXY,, GRACIAS
Hola ZoiX
Lo primero mil felicitaciones, por esta ayuda y aporte a la humanidad XD
Mi pregunta es que no se me descarga la carpeta ORG dentro starter-kit ni en ningun otro lado, y veo que esto me da problemas en el Flex, ya que creo que llama archivos de estas librerias y como no lo tengo me salen muchos fallos.
He probado a meterme por el link http://www.libspark.org/svn/as3/FLARToolKit/trunk y tampoco me encuentra esta carpeta.
Sabes que podria ser??
Un saludo
Muchas gracias por tus felicitaciones Juan. En cuanto a la carpeta, fíjate que sí está en la ruta, pero ya no aparece en el SVN la de papervision3D, sólo FLARToolKit, por tanto debes descargar de la misma manera (por SVN) las librerías de PV3D.
Comenta cualquier duda o pregúntanos a todos en el foro
Gracias Zoix!
Pero ya encontre las librerias en el blog de papervision3d y ya lo he conseguido. Aqui dejo el enlace:
http://code.google.com/p/papervision3d/downloads/list
Bueno gracias Zoix y a ahora a por la animación.
Un saludo y siento preguntar antes de rebuscar por todos lados.
estimados…he bajado e instalado el SVN pero no viene la carpeta ‘org’ dentro de ‘starter-kit’…lo instale nuevamente y tampoco,. alguien podria compatir esa carpeta conmigo?
atte
@Jose, la carpeta sí viene dentro del starter-kit por SVN, está dentro de la carpeta src.
Como comentaba juan romero, las librerías de papervision ya no están dentro del starter kit, así que toca descargarlas por aparte desde el link que él nos ha facilitado.
Jose descargate el Papervision3D_2.1.920.zip (el primero de la lista) lo he descomrimido en la carpeta de starter-kit y ningun problema
Saludos
Hola!! gracias por vuestras respuestas.
descargue el archivo Papervision3D_2.1.920.zip , lo descomprimi y tengo ahora dos carpetas llamas ‘org’ y ‘nochump’ que hago con ellas?
gracias
yo solo me he copiado la de org
Yo tambien… pero al igual que a Juan Romero, en FLEX me han aparecido muchos fallos. Descargue el archivo en cuestion ‘Pepervision’ pero me han salido mas fallos.
Look: http://www.anonimouse.cl/look.png
que podra ser?
Te pasa lo mismo que ami
en el zip que te hs descargado viene una carpeta ORG, esta carpeta no se exporta, tienes que copiarla y volver a pegarla en la nueva. dentro de ORG yo tengo dentro libspark, ascollada y papervision3d. me fijé que tenia ZoiX en el video tutorial y me los busque, te he subido la carpeta en mi server
http://www.romeroero.com/org.zip (856kb)
y esto copiala al ladito de Data y model
Un saludo y espero que te sirva
ya lo descargue, mil gracias…voy a ver que pasa.
estimado. todo Ok, muchisimas gracias…solo me da un ultimo error que no logro identificar la causa:
A file found in a source-path ‘AR2′must have the same name as the class definition inside the file ‘amorfo’
quien sabe cual podra ser el problema?
Gracias!
@jose, se debe a que la clase se llama de otra manera a como se llama el archivo. Puedes ver el primer videotutorial, ahí pasaba lo mismo
Zoix com estas , aun no tienes novedades del tutorial con video, tienes algun link interesante para realizar las pruebass
saludos
@Cristobal, no, no he tenido tiempo, ando lleno de trabajo, pero mira, en el foro se ha hablado sobre ello.
Hola, gracias por este tutorial, pues me corre todo bien en win 7, me muestra el cubo y tambien la esfera, pero solo eso “me muestra una esfera” más no el mapa mundo como colocas tu en tu captura , al parecer la animación no esta llamando a esta imagen : 800px-Earthmap1000x500.jpg
mi estructura de carpetas es la siguiente :
FLARToolKit\SVN\starter-kit\model
agradeceré tu ayuda
Bien, estuve investigando el porque no me jalaba a la imagen y era por la ruta, detallo un poco por si le sirve a otro que este en el mismo problema que yo :
1- si solo ves una esfera y no un mapa mundi ve a la siguiente ruta :
FLARToolKit\SVN\starter-kit\model\earth
2- si ya ubicaste el archivo earth (archivo de texto), abrelo con dreamweaver o cualquier editor de texto.
3- si lo abriste con dreamweaver , ubica la linea 116 y 119, notarás que hace una llamada a lo siguiente :
../../../volumes/data/flartoolkit/libs/trunk/starter-kit/model/shadow.png
y a :
../../../volumes/data/flartoolkit/libs/trunk/starter-kit/model/800px-earthmap1000x500.jpg
estas 2 líneas cambialo por lo siguiente:
shadow.png
800px-earthmap1000x500.jpg
Espero haya ayudado en algo.
Muchas gracias por responder la pregunta y dejar el precedente de la solución
Muy buen post didactico para empezar a utilizar la realidad aumentada. Me ha sido muy util y seguire revisando los demas posts.
@George, gracias por tu comentario.
toda va bien pero no tengo la carpeta de starter-kit en la URL, no hay ninguna carpeta asi. salu2
@Pablo, efectivamente el repositorio ha cambiado, se anunció hace no más de dos semanas en el grupo de usuarios de FLARToolKit. Mientras preparo un tutorial con los nuevos pasos, puedes descargar el starter-kit de la página de Saqoosha.
Hola zoix, tengo dudas con la carpeta data y bueno claro la imagen…. mmmm esta como la puedo cambiar?! :S!! no entiendo mucho esa parte.. debo meter mano a programar?! para empezar a checar el codigo… ya que no quiero perder el tiempo y pss lanzarme a lo que mas necesito!
ojala me puedas ayudar!
¿A cuál imagen te refieres? Al marker.
Puedes ver los otros tutoriales para ir avanzando en el tema, seguro encontrarás la respuesta
no me aparece la carpeta starterkid, esas extensiones de swf tampoco tengo ninguna en la carpeta, estaran kizas comprimidas?
@laqstadead, gracias por tu comentario.
Lee por favor unos 5 ó 6 comentarios más arriba.
hola zoix, gracias, pero ahora me lo bajo y al descomprimirlo me dice q esta dañado…plop,ademas tenia una preguntilla, que diferencia hay entre el flartool y el papervision, xq en la pagina de squosha lo pone en ingles y no me entero,quiero hacer unos personajes animados que he visto que se puede animar y ademas segun le das click a opciones en una pagina que tu tbm crearias realizan acciones, o demuestran estados de animo…que programas son los mas adecuados para hacer esto??tengo nociones de 3dmax solo
pero estoy dispuesta a aprender…gracias!!
Descárgalo de nuevo con otro navegador. En mi caso funciona.
Papervision3D es un motor de render para manipular las opciones de tridimensionalidad de Flash. FLARToolKit es el framework para Flash basado en ARToolKit.
Por lo que quieres hacer, creo que cualquier programa de modelado 3D que puedan exportar a formato COLLADA estaría bien.
yehhhh…lo he logrado!!muchisimas gracias
me seguire paseando x aki…me encanta el blog
Hola ZoiX… he seguido tan meticulosamente como he podido los pasos de tu tutorial, también me he descargado el starter kit ya que me faltaba como se indicó unos comentarios atrás… el problema viene cuando me pongo a abrir el archivo .swf pues entonces el sistema me pregunta con qué programa debo abrir el archivo… según la imagen que aparece en el tutorial debe ser con adobe flash player 10, el cual tengo instalado. Aun así no aparece en la lista de programas posibles para seleccionar, ya que parece ser un plugin del explorador… Resumiendo: no consigo abrir el swf y ahí me quedo bloqueado. Temo que la pregunta sea muy tonta ya que parece que a nadie le ha pasado nada parecido… :S
¡Retiro lo dicho..!!! ya me di cuenta
Mira que soy burro….
Hola!Gracias por iniciarnos en este mundo de la RA.Pregunta:segui exactamente todos los pasos pero no me aparece por ningun lado la carpeta starter-kit con el PDF del market file ni los archivos swf. No tengo nada de eso.Perdonen mi ignorancia.
@MajisARG, el repositorio ha cambiado porque ha salido una nueva versión de FLARToolKit. Sin embargo puedes descragar la versión anterior en este enlace.
Buenisimo el foro ZOIX..
segui tus pasos y me fue todo bien..
pero tengo una duda al descargar el archivo org especificamente el papervision3d para que me sirve..?
saludos!
@Ana Laura, básicamente papervision3D son librerías con las cuales tú creas efectos tridimensionales en Flash.
Hola Zoix, en primer lugar felicitarte por el blog, en segundo lugar he seguido los pasos que indicas en el tuto; pero no me crea la carpeta starter-kit, ni archive. Es por eso que no puedo probar el ejemplo. Espero me puedas ayudar en lo pronto porque tengo el tiempo limitado para realizar una aplicacion usando realidad aumentada.
GX.
Slds dsd Perú
@Romer, es porque el repositorio ha cambiado un poco, para seguir el tutorial mejor descarga el Starter-Kit de la página de Saqoosha
Hola Zoix, agradezco el tiempo que te tomas en responder cada interrogante que tenemos. Te comento, he estado probando con el blender realizando modificaciones sobre un prototipo – el monito – que da como ejemplo y lo he exportado a COLLADA 1.4 (si bien no recuerdo) y lo renombraba como earth.dae, y lo bueno era que podia visualizarlo. De ahí traté de hacer lo mismo con texto pero no logro visualizarlo. Según la experiencia que tienes a que crees que se pueda deber esto?…
Gx. Nvmnt
Slds dsd Perú
@Romer, casualmente publiqué algo en el foro hace poco. Depronto te sirva; así mismo te animo a que hagas las preguntas allí para que más usuarios te colaboren.
buenas, esque yo tengo un problema para abrir el FLARToolKitExample_ColladaData.as!!! no puedo abrirlo y no se como, si me pueden ayudar gracias…
@Cuela, lo puedes abrir con Flash o con Flex.
Hola primero que todo felicitaciones por el blog y gracias por compartir sus conociemientos, soy nuevo en esto de la realidad aumentada pero me ha parecido muy interesante y ya pude crear mis modelos y visualizarlos.
Pero quisiera saber si podria visualizar varios modelos en un mismo swf o tengo que crear un swf por cada modelo??
Gracias!! y saludos!!
@Cristian, gracias por tu comentario.
Respecto a tu pregunta, sí puedes. Se puede hacer fácilmente con FLARManager