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.










Hola, primero muchas gracias por compartir tu conocimiento, he seguido el tutorial pero al ejecutar el archivo .as lo abre en flash y aparece el código pero no consigo ejecutarlo como se haria desde el swf, mi pregunta es, desde flash como exporto ese archivo .as a swf. Gracias.
@latalines, gracias por tu comentario.
El .as está asociado a un .fla. Abres el .fla y compilas.
Hola, he estado siguiendo el tutorial pero tengo un problema. y es que en la carpeta SVN no me aparecen todos los archivos que expones en el tutorial, no me aparece starter-kit ni otras carpetas. que estoy haciendo mal?
Saludos.
@paco, como comenté en la actualización, los repositorios han cambiado. También puse un enlace para que descargues el starter-kit. Por favor mira esta actualización al finalizar el artículo
Hola. enhorabuena por el tutorial.
Mira swf me compila y me pide permiso para utiliza la webcam, lo acepto pero no es capaz de abrirla. Tengo un Imac con una webcam incorporado. Quiza para Mac necesitamos otro codigo para ejecutar la webcam?
Gracias
Basi,
En mac debes hacer click derecho, configuración, ir al ícono de la webcam y seleccionar la cámara que usualmente usas.
Hola,
Tengo un problema y es que cuando descargo por Tortoise, no sé si será Windows pero no se puede crear un archivo o carpeta e interrumpe la descarga e instalación.
¿Que hago en este caso?
Creería que descargar el ZIP de la página que pongo al final o usar otro programa para descargar por SVN.
Hola, que pena molestarte, pude instalar de la manera en que lo describes en este paso-a-paso. Al revisra el contenido descargado la carpeta starter-kit no aparece, ¿será a caso que en esta versión que descargué será otra carpeta?
Te cambio la pregunta, ¿dentro de que carpeta ubico el starter-kit?
AlexxDeLarge, al final del artículo, lee la actualización.
Hola Zoix.
He estado siguiendo el tutorial y hasta ahora funciona. Lo que sucede es que no entiendo lo que estoy haciendo. Por ejemplo, dudas sobre para que realmente sirve tortoise, y que es basicamente el contenido del kit. He buscado en el foro pero no hay nada concreto. Me gustaría saber si es posible que me puedas dar alguna url o link en donde encontrar esa info, te lo agradecería mucho.
Saludos!
FLARToolKit está subido a Internet de manera diferente, no es un .ZIP que descargas, por ejemplo, sino que la descarga se hace mediante SVN. Al ser así, Tortoise nos sirve para realizar ese tipo de descargas. Respecto a la URL, realmente hay muchas, basta con que busques guías de FLARToolKit en Google, aunque recuerda que Aumentality es la única página web con guías en español sobre Realidad Aumentada. Recuerda que también puedes hacer uso del foro (como ya he visto que lo has hecho) para que allí podamos responder todas tus dudas
disculpa el re posteo, pero tengo una duda fundamental y conceptual:
Que diferencia o relación existe entre flartoolkit y flarmanager?
tengo muchas dudas existenciales y estoy tratando de resolverlas, de no lograrlo me tiraré al barranco.
muchas gracias de nuevo.
FLARToolKit es, por llamarlo de alguna manera, las librerías base para crear Realidad Aumentada para Flash, mientras que FLARManager es un framework que hace que FLARToolKit sea mucho más fácil de trabajar. Incorpora funciones para múltiples características, pero trabaja siempre con FLARToolKit.
Y por cierto, no te tires al barranco, aún queda una luz de esperanza.
Hola, gracias por este tuto!
Me surgio un problema… no puedo abrir los ejemplos! estan en .as (de actinscript) y no me abre el flashplayer, tambien prove instalando el macromedia flash 8 y me lee el codigo pero no me deje ejecutarlo tampoco…
Alguna sugerencia?
Desde ya; muchas gracias.
Uhm, para correr el .as necesitas todas las librerías que se llaman en los imports. Te recomiendo leer este artículo.
Y después ve ver los ejemplos… que hago para crear mis propias animaciones????? o insertar videos???
Javier, para ello están los videotutoriales.
Hola..
ya tengo mi modelado en .DAE…. y ahora? reemplazo nomas? con cual ejemplo????
http://blog.aumentality.com/componentes-y-aclaraciones/videotutorial-modelando-nuestro-elemento-3d-y-exportandolo-correctamente-con-collada/#title
Zoix disculpa si soy un poco atrevido pero hay varias cosas que me gustaria decirte y que espero tomes como consejos.
Cuando respondes por ej. a Javier, que “para ello estan los videotutoriales” deberias poner enlaces tambien en el coment, porque he revuelto el blog y no encontre ningun video que explicara como iniciar desde cero en R.A.
Otra cosa, creo que deberías buscar otra forma de que te sea remunerativo el blog para pagar gastos de hosting y etc, porque peronas como yo que viven en lugares poco poblados no tenemos forma de darte una donacion, y asi estarias excluyendo mucha gente. Podrias aplicar Adsence por ej.
Tampoco encontre en el blog que expliques “como podemos darte esa donacion”, y que metodos de pago usas.
Creo que son cosas en las que debes mejorar el sitio.
Espero no me tomes a mal, y te felicito por la ayuda que brindas a quienes pueden disfrutar de la informacion que provees.
Muchas gracias;
Gabriel.
Hola Gabriel, antes que nada muchas gracias por tus comentarios y consejos, siempre son bien recibidos
Tienes razón en cuanto al comentario de Javier, es posible que en la barra lateral no se destaquen las categorías. Ya he puesto en enlace. Muchas gracias.
Sobre artículos sobre cómo empezar desde 0 sólo dispongo de este y del primer videotutorial que se publicó en el blog. Sin embargo esto cambiará en unos días, cuando publique nuevos videotutoriales, en especial uno sobre la nueva versión de FLARToolKit.
Respecto a las remuneraciones varias cosas. Lo primero es que no quiero usar AdSense, no me gusta ver publicidad en las páginas y por eso hago el intento de no insertarla en las mías. Por otro lado, el conocimiento que se adquirirá es muy probable que se use para fines comerciales, el que sea dada una donación a cambio de aprendizaje me parece una buena alternativa teniendo en cuenta que luego esa donación será cubierta por un trabajo real. Sobre cómo hacer la donación, al final de los artículos que la requieren menciono los pasos.
En absoluto te tomo a mal, esta es una muy buena manera de hacer feedback sobre errores que tiene el sitio y créeme que los tendré en cuenta, sobretodo la recomendación de usabilidad y pasos para hacer donaciones.
Gracias a tí Gabriel. Si tienes cualquier otra sugerencia no dudes en enviarme un mensaje por medio del formulario de contacto o continuar este hilo de comentarios
Gracias por responder tan rápido.
Te comento que hace unos instantes estuve hablando con un familiar, y me presento la oportunidad de irme de mi pueblo a la capital de mi pais (soy de argentina, actualmente vivo en un pueblo rural de 2500 hab…), asi que dentro de poco te estare pidiendo instrucciones para realizar la donación!
Viendo las cosas de la forma que tu las ves, tienes razón. A nadie le gusta encontrar publicidades metidas en todos lados, pero lamentablemente es lo que se utiliza en la mayoria de los sitios.
Me intrigo eso de que lo aprendido aquí podría utilizarlo con fines remunerativos, no habia pensado aun en las oportunidades que se presentan implementando RA, y me di cuenta que tiene infinidad de posibles usos!
Asi que voy a meterle pila y aprender todo lo posible!
Muchas gracias Zoix.
[...] además, para un tutorial más exhaustivo de cómo descargar las últimas librerías por favor ir a ¡Empecemos! Primeros Pasos). Lo que encontraremos en este archivo será entre otras cosas lo [...]
Flaco, buenisimo esto. Me enganchè hace poco con este tema gracias y tu blog es fundamental. Me lo he guardado para investigar este tema porque es fascinante!. Quiero hacerme un ajedrez
Saludos desde Bs. AS.
hola me encanta este blog, estoy tratando de poner en practica todo lo que estoy aprendiendo pero me quede atorado en algo
cuando instalo TortoiseSVN debe de aparecer por defecto SVN Checkout cuando el doy click en una carpeta con el botón derecho del ratón?
porque se instala todo bien pero cuando le doy en una carpeta con el botón derecho no me aparece SVN Checkout, me podrían dar una ayudadita por favor, quiero aprender a hacer esto bien desde cero
gracias de antemano
@neftali, esta pregunta parece más de soporte de los creadores de TortoiseSVN. Efectivamente al instalarlo te debería quedar en el menú del click derecho, al no estarlo, puedes, si existe, preguntar en los foros de soporte de TortoiseSVN o de otro modo buscar en Google.
una pregunta como corro el as, porque me pide que busque un programa, necesito instalar algo mas
Hola, puedes abrir los .as con cualquier editor de texto, pero para compilar necesita Flash, Flex, FTD o algún programa que pueda entender y compilar ActionScript.
Estimado Zoix,
Muchas gracias por la dedicación y por entregar un tutorial tan bueno.
Pato, muchas gracias. Hoy publico un videotutorial con las nuevas funcionalidades de la última versión de FLARToolKit
Estimado Zoix,
Quiero agradecer tu tiempo para responder todas nuestras consultas…..estoy recien partiendo con esto gracias a sketchup y el ARplugin…..por lo que tengo algunos problemas conceptuales aun con los programas o librerias que ustedes comentan…primero quiero saber si puedo instalarlo en mi mac, yo tengo flash instalado….se puede usar el flartoolkit???….y mi otra duda es si puedo subir a mi web el “visualizador” (no se como llamarlo) y dejar cargados los modelos 3d para que otra persona los vea con un codigo……..tal vez estoy pidiendo mucho pero esas son las dudas que tengo….
Gracias
@Seba Manriquez,
Si tienes más dudas sería bueno compartirlas en el foro.
Hola. Si tienes instalado Flash, puedes usar FLARToolKit. Y sí, puedes subir a internet el proyecto que te resulta de compilar tu proyecto de Realidad Aumentada. No pides mucho
hola muy buenos tus tutoriales
una pregunta bro, como puedo descargasr, o mejor dicho en que lugar de la pagina saqoosha se pueden descargar los anteriores archivos de starter kit?
es hay? http://www.libspark.org/wiki/saqoosha/FLARToolKit
porque bajo las 2 versiones pero no salen los archivos que usas, los anteriores.
gracias bro
@luis, al final del artículo, en donde dice “actualización” está el link, es el último de ese párrafo
[...] http://blog.aumentality.com/tutoriales/empecemos-primeros-pasos/ [...]
Hola Zoix.
Gracias por el impulso en el inicio.
Tu post es claro y muy interesante para los que empezamos en esto.
…estoy trasteando y tengo un problema:
No encuentro TortoiseSVN para Mac os x
¿Que alternativas tengo?
http://tinyurl.com/bkr7fk
OK… recbido…
amigo acabo de empezar en estas cosas y no me salio lo del cubito no me reconoce la camara y no me abre los archivos por que pasa eso? tengo instalada la suite de adobe cs5 y no me los abre
hola, recien estoy comenzado en esto de la realidad virtual
ojala puedas ayudarme y sobre todo responder rapido ya quue necesito hacer un proyecto de feria y me gustaria innovar en el campo de realidad aumentada
e intentado seguir tu tutorial porque me interesa pero me han salido archivos .as mientras tu pides .swf que hago
gracias
disculpa amigo tengo una duda como exporto el archivo FLARToolKitExample_ColladaData.as a swf, al intentarlo abrir lo abre en adobe flash pero no me deja compilarlo, me podrias orientar en que ando mal ?
Debes abrir el .fla y exportar desde allí. Adicional, debes en Main.as descomentar la línea que llama esa clase.
genial!!! muchas gracias!!! habia tenido que leer todo esto en ingles. y desactualizado.
Gracias a ti ya lo leo en espa;ol, muchas gracias!!! y sigue adelante
Hola, gracias por el tutorial, me pareció muy bueno.
Quisiera pedirte el favor de que pusieras un ejemplo de como ver un video vinculado al marcador impreso, y por favor subir los archivos de ejemplo para poder descargarlos.
Muchas gracias de nuevo.
Acá el videotutorial.
Hola, estoy aprendiendo de RA pero tengo un problemita, al descargar el lick, la carpeta starter-kit no me aparece, no le encuentro o no me la descargo, como puedo hacer o que estoy haciendo mal, para poder obtenerla.
Ana, han cambiado un poco las versiones, este tutorial es un poco más antiguo, sin embargo puedes descargar el Starter-kit acá. Al final del artículo puse una actualización, allí están las instrucciones.
Como puedo hacerlo pero sin usar flex y si es de version libre, puedo hacerlo con flash?, lo pregunto por que necesito explicar todo esto a la persona que pone los programas en mi trabajo, y para no llamarlo tantas veces que mas voy a necesitar que me instale, ya tengo 3d max, flash, y cuales son de version libre por ejemplo esa flartookit es version gratuita?. sé que son muchas preguntas pero la verdad para hacer el requerimiento necesito saber que no se me escape ningun programa.
Muchas gracias parece tonta la pregunta, pero qu emas puedo hacer. jejeje gracias.
Hola, Flex es libre para estudiantes, pero no necesitas más que Max y Flash. El resto es libre
disculpa pero no encuentro el earth.swf ni el simplecube.swf que puedo acer o como lo corro o q programa necesito?
Luis, por favor lee al final del artículo la Actualización.
hola, tal vez mi pregunta no es buena pero bueno =)
como puedo hacer un marcador con una imagen?
esque e visto videos en que la ra aparece sobre revistas o imágenes normales
como puedo pasar una imagen normal a .pat?
espero pueda responder y gracias n_n
Arturo, no se pueden pasar a .pat. Usualmente las librerías que reconocen imágenes no son gratuitas, a menos que uses por ejemplo ASSURF.