Skip to content

Building on Windows

Jump to bottom
Thorsten Bux edited this page Dec 5, 2017 · 1 revision

Requirements

A supported IDE

Microsoft Visual Studio 2013 and Microsoft Visual Studio 2010 SP1 are supported. The free Microsoft Visual Studio Express Edition will also work.

OpenGL

OpenGL is provided as part of your graphic card diver.

libjpeg

libjpeg headers and libraries are supplied with ARToolKit.

GLUT

Required to build libARgsub and the utilities and examples. Note: libARgsub_lite provides equivalent functionality to libARgsub without requiring GLUT.

GLUT 3.7.6 is included with ARToolKit.

Video capture libraries

By default, on Windows ARToolKit's video library (libARvideo) uses Microsoft's DirectShow libraries. Unfortunately, this requires an installation of the DirectX SDK and either the Windows SDK or the DirectShow package from the Microsoft Platform SDK to compile libARvideo. Please see the separate page Building libARvideo. Alternative video sources on Windows include: QuickTime, either using the VideoDigitizer or movie files or streams. Please see the separate page Building libARvideo. Thomas Pintaric's DSVideoLib, which was the default video source for ARToolKit v2.x, is now LGPL licensed and may be used in proprietary software. Point Grey's flycapture SDK (only for use with Point Grey Cameras). Canon's HDCam64 camera control library (Canon HDCam64 users only).

OpenSceneGraph (OSG)

For details see OSG

ARToolKit supplies binaries of OSG 3.0.1

Set the environment variable OSG_ROOT=Path to where you extracted OSG files to

Compiling ARToolKit

Windows

After unpacking ARToolKit, run the configure-win32 script. This generates AR/config.h for Windows builds. If you wish to change the default video library or enable extra video libraries such as QuickTime, see Building libARvideo. Open the ARToolKit5.sln file inside the appropriate directory inside of the “VisualStudio” directory. Build the ToolKit and the sample applications. The OSG renderers are not built by default but can be manually selected and built.

Verify the compilation

Run simpleLite can be opened by double-clicking its icon in the ARToolKit5\bin directory. Alternately, you can run it from the command line:

Windows: simpleLite can be opened by double-clicking its icon in the ARToolKit5\bin directory. Alternately, you can run it from the command line:

  • Open a command-line window (cmd.exe)
  • Navigate to your ARToolKit5\bin directory
  • Type: simpleLite.exe
Clone this wiki locally