[教程] ARToolKit 非官方安装指南（转载）

在Linux / SGI Irix中安装

安装前的准备：

需满足的软件包	安装指导
OpenGL and GLUT	确定OpenGL和GLUT运行期包都安装好了。一般来说，是在/usr/X11R6/lib，/usr/lib或 /usr/local/lib内查找是否存在opengl.so，glu.so和glut.so。 确定OpenGL和GLUT SDKs都被安装好了。一般来说，是在/usr/X11R6/include，/usr/include或/usr/local/include内查找是否存在opengl.h，glu.h，和glut.h。
Video Library	确定视频库已经安装好了： 在Linux下，确保V4L RunTime 和 SDK 都安装好，或者确保 dv1394，dv1394 RunTime 和 SDK都安装好了。 在SGI下，只在SGI O2 models下测试过ARToolKit，不过按理来说，对于采用类似的视频输入设备的其他SGI机型，也应该能正常工作。
（可选项，用于VRML渲染） OpenVRML-0.14.3	可以在ARToolKit downloads page on sourceforge下载OpenVRML的源代码包。

编译ARToolKit：

1。打开控制台，准备开始编译ARToolKit。

2。输入

tar zxvf ARToolKit-2.71.tgz

把ARToolKit-2.71.tgz解压到任意目录。为叙述方便起见，后面称该目录为{ARToolKit}。

3。配置并编译。

输入以下命令进行配置：

cd {ARToolKit}

./Configure

在Linux下编译时，支持多种视频输入：Video4Linux，IIDC- compliant或者DV camera connected via IEEE-1394, 或者Sony EyeToy camera connected via USB。具体选择什么，配置的时候会提示你进行选择。

 

配置成功后，输入以下命令开始编译：

make

如果编译成功的话，输入以下命令来运行一个简单的测试程序：

cd {ARToolKit}/bin

./simpleTest

VRML渲染库和例子（libARvrml & simpleVRML）根据具体需要，选择性的编译：

cd {ARToolKit}/lib/SRC/ARvrml

make

cd {ARToolKit}/examples/simpleVRML

make

cd {ARToolKit}/bin

./simpleVRML

在MAC OS X中安装：

安装前的准备：

 

需满足的软件包	安装指导
Apple Developer Tools	XCode Tools安装盘已经包含在Mac OS X的安装盘中，也可以从下面连接中下在安装镜像： http://developer.apple.com/tools/xcode/

在MAC OS X中安装：

安装前的准备：

 

需满足的软件包	安装指导
Apple Developer Tools	XCode Tools安装盘已经包含在Mac OS X的安装盘中，也可以从下面连接中下在安装镜像： http://developer.apple.com/tools/xcode/

在XCode IDE中编译（略，因为没用过）：

1. Unpack the archive to a convenient location using StuffIt Expander, and open the ARToolKit.xcodeproj.
2. Builds include a script target "Configure" which enables accelerated and rectangular texturing by default. If you wish to change these defaults, manually run the ./Configure script from Terminal as for a command-line build (below).
3. Executables are built as bundled applications into ARToolKit/bin, with the Data/ directory copied into the application bundle so that they may be moved from this location to other locations.

The VRML renderering library and example (libARvrml & simpleVRML) are optional builds:

4. Using FinkCommander, do a binary install of mozilla-dev, followed by an install of openvrml4-dev and openvrml-gl5-dev.
5. Select the ARToolKit extensions target, and build.

Alternately, ARToolKit can be built from the Terminal, using the Unix makefiles.

Drop the ARToolKit into a convenient location, e.g. your Desktop, then open a Terminal window and type:

cd ~/Desktop

tar zxvf ARToolKit-2.71.tgz

Configure and build

cd ~/ARToolKit

./Configure

make

Following a successful build, to run a binary such as simpleTest, add these commands:

cd bin

./simpleTest

The VRML renderering library and example (libARvrml & simpleVRML) are optional builds:

fink -b install mozilla-dev

fink install openvrml4-dev openvrml-gl5-dev

cd ~/Desktop/ARToolKit/lib/SRC/ARvrml

make

cd ~/Desktop/ARToolKit/examples/simpleVRML

make

cd ~/Desktop/ARToolKit/bin

./simpleVRML

 

（原文链接）

运行例子和工具

当前的ARToolKit发布版本并没有要求把ARToolKit安装在特定的位置。在你编译自己的应用程序的时候，应该保证能找到ARToolKit。如果把ARToolKit编译为静态库，它将会被连接到所有你编译的程序中去。

为了使用ARToolKit，你需要有做一些“标志物”：例子程序使用的标志物放在 patterns目录下。你可以用把它打印出来。这些标志对你以后的开发也是有用的。ARToolKit需要一个不易形变的标志物，所以简单的做法是把标志物粘在硬卡片上。然后，使用/bin目录下的graphicsTest来测试ARToolKit的图形部分是否正常工作。如果工作正常的话，应该显示一个旋转的茶壶。

这个测试用来测试你的摄像头对ARToolKit的的图形模块的支持。图形模块使用了OpenGL。最小的允许幀率是15fps。低于这个数值会明显的限制ARToolKit渲染模块的正常工作（参考FAQ）。除此之外，还需要测试视频熟如是否正常、视频是否能显示。在/bin目录下的videoTest可以完成上述测试。如果没有错误的话，应该出现一个视频窗口，显示出摄像头采集的内容。这个测试用来测试你的摄像头对ARToolKit视频模块和图形模块的支持。

如果没有显示，可能是你的摄像头没有正确配置导致其不能正常工作（参考FAQ）

第一个例子

• 介绍
  
• 运行ARToolKit
  
• simpleTest的输出