Monday, March 07, 2005
Installation
ARToolkit 2.70 with VRML support
The latest version is available from http://sourceforge.net/projects/artoolkit and includes the following files:
ARToolkit-2.70.tgz Platform independent
DsVideoLib-0.0.4-win32.zip i386
OpenVRML-0.14.3-win32.zip i386
The ARToolKit is a collection of libraries, utilities applications, and documentation and sample code. The libraries provide the user with a means to capture images from video sources, process those images to optically track markers in the images, and to allow compositing of computer-generated content with the real-world images and display the result using OpenGL (Phillip Lamb, 2004). ARToolKit is designed to build on Windows, Linux, SGI Irix, andMacintosh OS X platforms.
Building on Windows
(Read the full release notes on Sourceforge for other platforms)
Prerequisites:
Build steps:
The latest version is available from http://sourceforge.net/projects/artoolkit and includes the following files:
ARToolkit-2.70.tgz Platform independent
DsVideoLib-0.0.4-win32.zip i386
OpenVRML-0.14.3-win32.zip i386
The ARToolKit is a collection of libraries, utilities applications, and documentation and sample code. The libraries provide the user with a means to capture images from video sources, process those images to optically track markers in the images, and to allow compositing of computer-generated content with the real-world images and display the result using OpenGL (Phillip Lamb, 2004). ARToolKit is designed to build on Windows, Linux, SGI Irix, andMacintosh OS X platforms.
Building on Windows
(Read the full release notes on Sourceforge for other platforms)
Prerequisites:
- Microsoft Visual Studio .NET 2003 or Visual Studio 6.
- DSVideoLib-0.0.4-win32. Download from http://sf.net/projects/artoolkit
- GLUT. Download from http://www.opengl.org/resources/libraries/glut.html
- DirectX 9.0b or later SDK. If you are using VS6, you must use 9.0b as DirectX 9.0c no longer includes support for VS6. Download from http://msdn.microsoft.com/library/default.asp?url=/downloads/list/directx.asp
- (DirectX 9.0c October 2004 or later only) DirectX SDK Extras package. Once downloaded and unzipped, move the "Samples" folder into the top-level of the installed SDK path.
- (Optional, for VRML renderer only) OpenVRML-0.14.3-win32. Downloadfrom http://sf.net/projects/artoolkit.
Build steps:
- Unpack the ARToolKit zip to a convenient location. This location will be referred to below as {ARToolKit}.
- Unpack the DSVideoLib zip into {ARToolKit}.
- Copy the files DSVideoLib.dll and DSVideoLibd.dll from{ARToolKit}\DSVideoLib\bin.vc70 into {ARToolKit}\bin.
- Run the script {ARToolKit}\DSVideoLib\bin.vc70\register_filter.bat.
- Install the GLUT DLL into the Windows System32 folder, and the library and headers into the VS platform SDK folders.
- Run the script {ARToolKit}\Configure.win32.bat to create include/AR/config.h.
- Open the ARToolKit.sln file (VS.NET) or ARToolkit.dsw file (VS6).
- Open the Visual Studio search paths settings(Tools->Options->Directories for VS6, or Tools->Options->Projects->VC++Directories for VS.NET) and add the DirectX SDK Includes\ path and theDirectX Samples\C++\DirectShow\BaseClasses\ path to the top of the search path for headers, and the DirectX SDK Lib\ path to the top of thesearch path for libraries.
- (Optional, only if rebuilding DSVideoLib). Build the DirectShow baseclasses strmbase.lib and strmbasd.lib. (More information can be found atThomas Pintarics homepage for DSVideoLib(http://www.ims.tuwien.ac.at/~thomas/dsvideolib.php)).
- Build the toolkit.The VRML renderering library and example (libARvrml & simpleVRML) are optional builds:
- Unpack the OpenVRML zip into {ARToolKit}.
- Copy js32.dll from {ARToolKit}\OpenVRML\bin into {ARToolKit}\bin.
- Enable the libARvrml and simpleVRML projects in the VS configuration manager and build.