4. 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:DEVELARToolKit_BACKUP_LIBs Diretório backup.
X:DEVELARToolKit_DOCS Diretório contendo documentos sobre o ARToolKit
Neste documento será usado{ARToolKit} como
simplificação para o caminho do diretório
x:DEVELARToolKit e {OpenVRML} como
simplificação para o caminho
x:DEVELARToolKitOpenVRML.
É aconselhável salvar os Downloads dos pré-requisitos no
diretório x:DEVELARToolKit_BACKUP_LIBs.
Para simplificar este será chamado de {Backup}
5. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
1. Fazer downloads dos pré-requisitos e salvar em
{BACKUP}:
6. 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:
7. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
3. Descompactar o ARToolKit. Na figura a estrutura de
arquivos descompactados.
8. 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.
9. 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.
10. 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.
Christopher Shneider Cerqueira
11. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
6. No diretório {BACKUP} descompacte o arquivo glut-
3.7.6-bin.zip. Descompactará os arquivos, como na figura:
Christopher Shneider Cerqueira
12. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
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}includeGL
Christopher Shneider Cerqueira
13. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
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.
Christopher Shneider Cerqueira
14. Tutorial de Instalação 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 diretório OpenVRML:
Christopher Shneider Cerqueira
15. Tutorial de Instalação 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.37-
setup.exe contidos no diretório {BACKUP}. Isto criará e
copiará para o System bibliotecas de manuseio de imagens
jpeg e png.
16. 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)GnuWin32lib)
as libs jpeg.lib e libpng.lib para o diretório de
dependências {OpenVRML}dependencieslib.
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)GnuWin32bin as DLLs jpeg62.dll,
libpng3.dll, libpng12.dll, zlib1.dll para
{ARToolKit}bin
17. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
Alterações no Código do OpenVRML
17. Vá ao diretório {OpenVRML}srcopenvrml-
0.14.3ide-
projectsWindowsVisualC7OpenVRML e
entre na solução OpenVRML.sln.
18. Execute o Wizard de conversão.
18. 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:
19. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
20. Altere o cabeçalho da função regerror()
21. Salve e feche o arquivo
regerror.c.
Christopher Shneider Cerqueira
20. 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:
Christopher Shneider Cerqueira
21. Tutorial de Instalação 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.
22. 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:
23. 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.
24. 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.
25. 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.
26. 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}srcopenvrml-0.14.3ide-
projectsWindowsVisualC7OpenVRMLantlrRelea
seantlr.lib para {OpenVRML}lib
◦ Copiar {OpenVRML}srcopenvrml-0.14.3ide-
projectsWindowsVisualC7OpenVRMLopenvrmlRe
leaseopenvrml.lib para {OpenVRML}lib
◦ Copiar {OpenVRML}srcopenvrml-0.14.3ide-
projectsWindowsVisualC7OpenVRMLopenvrml-
glReleaseopenvrml-gl.lib para {OpenVRML}lib
◦ Copiar {OpenVRML}srcopenvrml-0.14.3ide-
projectsWindowsVisualC7OpenVRMLregexRelea
seregex.lib para {OpenVRML}lib
27. 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:
28. 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:
29. 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:
30. 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>.
31. 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.
32. Tutorial de Instalação do ARToolKit 2.72.1 com VS2005
A figura exemplifica a saída do programa simpleVRML.
33. 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
34. Qualquer dúvida 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