Christopher Shneider Cerqueira

christophercerqueira@gmail.com https://sites.google.com/site/christophercerqueira/ UNIFEI Universidade Federal de Itajub Orientador: Prof. Dr. Edison Oliveira de Jesus e Prof. Dr. Roberto Affonso da Costa Junior

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Pr-requisitos ARToolKit GLUT Bibliotecas OpenVRML Compilar Exemplos e libs ARToolKit

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Visual Studio 2005 Trial

http://ziggi.uol.com.br/downloads/visual-studio-2005-professional-edition http://sourceforge.net/projects/artoolkit/files/artoolkit/2.72.1/ARToolKit-2.72.1-binwin32.zip/download http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip http://www.dll-files.com/dllindex/dll-files.shtml?msvcp71d http://www.dll-files.com/dllindex/dll-files.shtml?msvcr71d http://sourceforge.net/projects/gnuwin32/files/libpng/1.2.37/libpng-1.2.37setup.exe/download

ARToolKit - ARToolKit-2.72.1-bin-win32.zip GLUT - glut-3.7.6-bin.zip msvcp71d.dll msvcr71d.dll

Libpng - libpng-1.2.37-setup.exe Libpng - jpeg-6b-4.exe

Download: http://sourceforge.net/projects/gnuwin32/files/jpeg/6b-4/jpeg-6b-4.exe/download

OpenVRML - OpenVRML-0.14.3-win32.zip http://sourceforge.net/projects/artoolkit/files/artoolkit/2.72.1/OpenVRML-0.14.3win32.zip/download

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Sugesto de organizao de diretrios:

X:\DEVEL X:\DEVEL\ARToolKit_BACKUP_LIBs X:\DEVEL\ARToolKit_DOCS Diretrio raiz para o desenvolvimento. Diretrio backup. Diretrio contendo documentos sobre o ARToolKit

Neste documento ser usado{ARToolKit} como simplificao para o caminho do diretrio x:\DEVEL\ARToolKit e {OpenVRML} como simplificao para o caminho x:\DEVEL\ARToolKit\OpenVRML. aconselhvel salvar os Downloads dos pr-requisitos no diretrio x:\DEVEL\ARToolKit_BACKUP_LIBs. Para simplificar este ser chamado de {Backup}

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

1. Fazer downloads dos pr-requisitos e salvar em {BACKUP}:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

2. Copiar ARToolKit-2.72.1-bin-win32.zip de {BACKUP} para o diretrio raiz x:\DEVEL:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

3. Descompactar o ARToolKit. Na figura a estrutura de arquivos descompactados.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Breve descrio de cada diretrio:

ARToolKit.xcodeproj contm informaes sobre a soluo de desenvolvimento do Visual Studio bin contm o resultado da compilao dos exemplos e utilitrios. De imediato contm verses prcompiladas. doc contm uma srie de definies das funes e estruturas de dados do ARToolKit. DSVL contm a biblioteca de processamento de vdeo DirectShow. exemplos contm o cdigo fonte dos 16 exemplos de aplicaes include contm as cabealhos das bibliotecas de RA e de acesso ao vdeo. lib contm as bibliotecas de RA e de acesso a vdeo. O cdigo fonte destas bibliotecas tambm est presente no subdiretrio SRC desta pasta. patterns contm exemplos de marcadores para serem utilizados para teste dos exemplos. util contm 6 aplicativos auxiliares para calibrao, testes e cadastro de marcadores.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

4. Como teste inicial possvel executar os programas pr-compilados no diretrio {ARToolKit}\bin.

Para os testes so necessrios os marcadores contidos na pasta {ARToolKit}\patterns. possvel imprimir ou direcionar a cmera para o monitor.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

5. Finalizando o teste inicial apague todos os arquivos executveis da pasta {ARToolKit}\bin pois estes sero recompilados ao final deste documento.

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

6. No diretrio {BACKUP} descompacte o arquivo glut3.7.6-bin.zip. Descompactar os arquivos, como na figura:

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

7. Fazer cpia para a estrutura do ARToolKit:

Copiar glut32.dll para {ARToolKit}\bin Copiar glut32.lib para {ARToolKit}\lib Criar um diretrio GL dentro de {ARToolKit}\include Copiar glut.h para {ARToolKit}\include\GL

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

8. No diretrio {BACKUP} descompacte os arquivos msvcp71d.zip e msvcr71d.zip extraindo os arquivos msvcp71d.dll e msvcr71d.dll. 9. Copiar as bibliotecas msvcp71d.dll e msvcr71d.dll para {ARToolKit}\bin OBS.: Neste ponto possvel compilar todos os exemplos que no usam OpenVRML.

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

10. Copie o arquivo OpenVRML-0.14.3-win32.zip de {BACKUP} para {ARToolKit}. 11. Descompacte OpenVRML-0.14.3-win32.zip. Isto criar o diretrio OpenVRML:

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

12. Copie o arquivo js32.dll da pasta {OpenVRML}\bin para {ARToolKit}\bin 13. Execute os programas jpeg-6b-4.exe e libpng-1.2.37setup.exe contidos no diretrio {BACKUP}. Isto criar e copiar para o System bibliotecas de manuseio de imagens jpeg e png.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

14. Copie do Diretrio criado pela execuo dos programas (C:\Program Files (x86)\GnuWin32\lib) as libs jpeg.lib e libpng.lib para o diretrio de dependncias {OpenVRML}\dependencies\lib. 15. Renomear jpeg.lib para libjpeg.lib. (Sobrescrevendo a libjpeg.lib existente) Isto substituir as duas libs que j estavam nesta pasta. 16. Copie do diretrio C:\Program Files (x86)\GnuWin32\bin as DLLs jpeg62.dll, libpng3.dll, libpng12.dll, zlib1.dll para {ARToolKit}\bin

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Alteraes no Cdigo do OpenVRML 17. V ao diretrio {OpenVRML}\src\openvrml0.14.3\ideprojects\Windows\VisualC7\OpenVRML e entre na soluo OpenVRML.sln. 18. Execute o Wizard de converso.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Modificar regerror.c 19. Abra regerror.c em regex->Source Files->regerror.c no Solution Explorer do VS2005:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

20. Altere o cabealho da funo regerror() 21. Salve e feche o arquivo regerror.c.

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Modificar AST.hpp 22. Abra AST.hpp em antlr->Header Files-> AST.hpp no Solution Explorer do VS2005:

Christopher Shneider Cerqueira

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

23. Modifique o operador inline operator<(RefAST l,RefAST r) : 24. Salve e feche o arquivo AST.hpp.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Modificar Token.hpp 25. Abra Token.hpp em antlr->Header Files-> Token.hpp no Solution Explorer do VS2005:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

26. Modifique o operador inline operator<(RefAST l,RefAST r) : 27. Salve e feche o arquivo Token.hpp.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Compile as bibliotecas antlr, openvrml, openvrml-gl e regex. 28. Para isto clique com o boto direito sobre cada projeto de soluo do Solution Explorer do VS2005 e v a Project Only -> Build Only <nomedoprojeto>. Lembrando que todos os projetos devem ser compilados para verso Release.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Neste ponto no devem ocorrer erros de compilao, gerando com sucesso as libs.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

29. Com as novas libs necessrio substituir as verses prcompiladas do diretrio {OpenVRML}\lib. Desta forma deve-se realizar as quatro copias a seguir:

Copiar {OpenVRML}\src\openvrml-0.14.3\ideprojects\Windows\VisualC7\OpenVRML\antlr\Relea se\antlr.lib para {OpenVRML}\lib Copiar {OpenVRML}\src\openvrml-0.14.3\ideprojects\Windows\VisualC7\OpenVRML\openvrml\Re lease\openvrml.lib para {OpenVRML}\lib Copiar {OpenVRML}\src\openvrml-0.14.3\ideprojects\Windows\VisualC7\OpenVRML\openvrmlgl\Release\openvrml-gl.lib para {OpenVRML}\lib Copiar {OpenVRML}\src\openvrml-0.14.3\ideprojects\Windows\VisualC7\OpenVRML\regex\Relea se\regex.lib para {OpenVRML}\lib

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Aps estes passos possvel compilar todos os exemplos do ARToolKit. Neste momento o diretrio {ARToolKit}\bin contm apenas as DLLs copiadas durante o processo:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

30. Entre na soluo ARToolKit.sln no diretrio {ARToolKit} para carregar o Visual Studio 2005. 31. Passe pelo Wizard de converso. Abrir uma soluo com todos os projetos, como na figura:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

32. necessrio passar os projetos de Debug para Release, basta alterar no toolbar:

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

33. possvel compilar cada projeto individualmente, clicando com o boto direito sobre cada projeto do Solution Explorer do VS2005 e escolher Project Only -> Build Only <nomedoprojeto>.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Compilando um a um, ser notado que alguns projetos no so compilados, pois como estes so dependncias de outros o Visual Studio j os compila. Os exemplos PaddleInteractionTest e PaddleTest no vo compilar da primeira vez, basta fechar o Visual Studio, abrir de novo e recompilar os dois. Verificando o diretrio {ARToolKit}\bin possvel testar todas as compilaes.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

A figura exemplifica a sada do programa simpleVRML.

Tutorial de Instalao do ARToolKit 2.72.1 com VS2005

Este tutorial foi feito com base nos seguintes documentos:

http://www.cin.ufpe.br/~lsf/Multim%EDdia/ARToolkit/ARToolki t_final.doc http://calmarea.net/?p=167 http://www.hitlabnz.org/forum/archive/index.php/t-93.html http://www.hitl.washington.edu/artoolkit/documentation/usersetu p.htm http://www.ckirner.com/download/capitulos/Cap-5-ARToolKitLivroTecno.pdf

Qualquer dvida entre em contato.

Christopher Shneider Cerqueira
christophercerqueira@gmail.com https://sites.google.com/site/christophercerqueira/ UNIFEI Universidade Federal de Itajub Orientador: Prof. Dr. Edison Oliveira de Jesus e Prof. Dr. Roberto Affonso da Costa Junior