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

Pré-requisitos

ARToolKit

GLUT

Bibliotecas

OpenVRML

Compilar Exemplos e libs ARToolKit

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Visual Studio 2005 Trial ◦ http://ziggi.uol.com.br/downloads/visual-studio-2005-professional-edition

ARToolKit - ARToolKit-2.72.1-bin-win32.zip ◦ http://sourceforge.net/projects/artoolkit/files/artoolkit/2.72.1/ARToolKit-2.72.1-bin-

win32.zip/download

GLUT - glut-3.7.6-bin.zip ◦ http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip

msvcp71d.dll ◦ http://www.dll-files.com/dllindex/dll-files.shtml?msvcp71d

msvcr71d.dll ◦ http://www.dll-files.com/dllindex/dll-files.shtml?msvcr71d

Libpng - libpng-1.2.37-setup.exe ◦ http://sourceforge.net/projects/gnuwin32/files/libpng/1.2.37/libpng-1.2.37-

setup.exe/download

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.3-win32.zip/download

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Sugestão de organização de diretórios: X:\DEVEL Diretório raiz para o desenvolvimento. X:\DEVEL\ARToolKit_BACKUP_LIBs Diretório backup. X:\DEVEL\ARToolKit_DOCS Diretório contendo documentos sobre o ARToolKit

Neste documento será usado{ARToolKit} como simplificação para o caminho do diretório x:\DEVEL\ARToolKit e {OpenVRML} como simplificação para o caminho x:\DEVEL\ARToolKit\OpenVRML.

É aconselhável salvar os Downloads dos pré-requisitos no diretório x:\DEVEL\ARToolKit_BACKUP_LIBs. Para simplificar este será chamado de {Backup}

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

1. Fazer downloads dos pré-requisitos e salvar em

{BACKUP}:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

2. Copiar ARToolKit-2.72.1-bin-win32.zip de

{BACKUP} para o diretório raiz x:\DEVEL:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

3. Descompactar o ARToolKit. Na figura a estrutura de

arquivos descompactados.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Breve descrição de cada diretório:

◦ ARToolKit.xcodeproj contém informações sobre a solução de desenvolvimento do Visual

Studio

◦ bin contém o resultado da compilação dos exemplos e utilitários. De imediato contém versões pré-

compiladas.

◦ doc contém uma série de definições das funções e estruturas de dados do ARToolKit.

◦ DSVL contém a biblioteca de processamento de vídeo DirectShow.

◦ exemplos contém o código fonte dos 16 exemplos de aplicações

◦ include contém as cabeçalhos das bibliotecas de RA e de acesso ao vídeo.

◦ lib contém as bibliotecas de RA e de acesso a vídeo. O código fonte destas bibliotecas também está

presente no subdiretório SRC desta pasta.

◦ patterns contém exemplos de marcadores para serem utilizados para teste dos exemplos.

◦ util contém 6 aplicativos auxiliares para calibração, testes e cadastro de marcadores.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

4. Como teste inicial é possível

executar os programas pré-compilados

no diretório {ARToolKit}\bin.

◦ Para os testes são necessários os

marcadores contidos na pasta

{ARToolKit}\patterns.

◦ É possível imprimir ou direcionar a câmera

para o monitor.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

5. Finalizando o teste inicial apague todos os arquivos

executáveis da pasta {ARToolKit}\bin pois estes

serão recompilados ao final deste documento.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

6. No diretório {BACKUP} descompacte o arquivo glut-

3.7.6-bin.zip. Descompactará os arquivos, como na figura:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

7. Fazer cópia para a estrutura do ARToolKit:

◦ Copiar glut32.dll para {ARToolKit}\bin

◦ Copiar glut32.lib para {ARToolKit}\lib

◦ Criar um diretório GL dentro de {ARToolKit}\include

◦ Copiar glut.h para {ARToolKit}\include\GL

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

8. No diretório {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 é possível compilar todos os

exemplos que não usam OpenVRML.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

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 diretório OpenVRML:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

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.37-

setup.exe contidos no diretório {BACKUP}. Isto criará e

copiará para o System bibliotecas de manuseio de imagens

jpeg e png.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

14. Copie do Diretório criado pela execução dos programas (C:\Program Files (x86)\GnuWin32\lib) as libs jpeg.lib e libpng.lib para o diretório de dependências {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 diretório C:\Program Files (x86)\GnuWin32\bin as DLLs jpeg62.dll, libpng3.dll, libpng12.dll, zlib1.dll para {ARToolKit}\bin

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Alterações no Código do OpenVRML

17. Vá ao diretório {OpenVRML}\src\openvrml-

0.14.3\ide-

projects\Windows\VisualC7\OpenVRML e

entre na solução OpenVRML.sln.

18. Execute o Wizard de conversão.

Tutorial de Instalação 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 Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

20. Altere o cabeçalho da função regerror()

21. Salve e feche o arquivo

regerror.c.

Tutorial de Instalação 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:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Christopher Shneider Cerqueira

23. Modifique o operador inline operator<(RefAST l,RefAST

r) : 24. Salve e feche o arquivo

AST.hpp.

Tutorial de Instalação 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 Instalação 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 Instalação do ARToolKit 2.72.1 com VS2005

Compile as bibliotecas antlr, openvrml, openvrml-gl e regex.

28. Para isto clique com o botão direito sobre cada projeto de solução do Solution Explorer do VS2005 e vá a Project Only -> Build Only <nomedoprojeto>.

Lembrando que todos os projetos devem ser compilados para versão Release.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Neste ponto não devem ocorrer erros de compilação, gerando

com sucesso as libs.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

29. Com as novas libs é necessário substituir as versões pré-compiladas do diretório {OpenVRML}\lib. Desta forma deve-se realizar as quatro copias a seguir: ◦ Copiar {OpenVRML}\src\openvrml-0.14.3\ide-projects\Windows\VisualC7\OpenVRML\antlr\Release\antlr.lib para {OpenVRML}\lib

◦ Copiar {OpenVRML}\src\openvrml-0.14.3\ide-projects\Windows\VisualC7\OpenVRML\openvrml\Release\openvrml.lib para {OpenVRML}\lib

◦ Copiar {OpenVRML}\src\openvrml-0.14.3\ide-projects\Windows\VisualC7\OpenVRML\openvrml-gl\Release\openvrml-gl.lib para {OpenVRML}\lib

◦ Copiar {OpenVRML}\src\openvrml-0.14.3\ide-projects\Windows\VisualC7\OpenVRML\regex\Release\regex.lib para {OpenVRML}\lib

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Após estes passos é possível compilar

todos os exemplos do ARToolKit.

Neste momento o diretório

{ARToolKit}\bin contém apenas

as DLLs copiadas durante o processo:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

30. Entre na solução

ARToolKit.sln no

diretório

{ARToolKit} para

carregar o Visual Studio

2005.

31. Passe pelo Wizard de

conversão. Abrirá uma

solução com todos os

projetos, como na figura:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

32. É necessário passar os projetos de Debug para Release,

basta alterar no toolbar:

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

33. É possível compilar

cada projeto

individualmente, clicando

com o botão direito sobre

cada projeto do Solution

Explorer do VS2005 e

escolher Project Only ->

Build Only

<nomedoprojeto>.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

Compilando um a um, será notado que alguns projetos não

são compilados, pois como estes são dependências de outros o

Visual Studio já os compila.

Os exemplos PaddleInteractionTest e PaddleTest não

vão compilar da primeira vez, basta fechar o Visual Studio,

abrir de novo e recompilar os dois.

Verificando o diretório {ARToolKit}\bin é possível

testar todas as compilações.

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

A figura exemplifica a saída do programa simpleVRML.

Tutorial de Instalação 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-ARToolKit-

LivroTecno.pdf

Tutorial de Instalação do ARToolKit 2.72.1 com VS2005

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

Qualquer dúvida entre em contato.