ARToolKit uses video libraries as a standardized way of accessing video capture hardware (like webcams) on your computer. On Windows, you have the option of using QuickTime or DirectShow. On OS X, we use QuickTime.
DirectShow is Microsoft's media-handling library on the Windows Platform. While the DirectShow libraries are in every release of Windows, and can be used right away, compiling applications that use the DirectShow SDK is difficult. This is mostly due to Microsoft's determination to force all users of video into using its digital rights management model (as found in Windows Vista's Media Foundation library) and the consequent withdrawal of the DirectShow SDK from the larger DirectX SDK and Visual Studio SDKs.
Because the process of installing the DirectShow SDK is tiresome, we supply compiled binaries of ARToolKit to customers - unless customers want to recompile libARvideo on Windows, installing the DirectShow SDK is unnecessary. For customers who do wish to recompile libARvideo for their own purposes, the following guide should be of help.
QuickTime is Apple's media-handling library, available on both Mac OS X and the Windows platforms. One benefit QuickTime has over DirectShow is the ability to read pre-recorded video from files on disk or via network streaming (for uses such as calibrating a camera on a device which the tools do not run).
While the QuickTime libraries and SDK are in every release of Mac OS X, and can be used right away; they are not installed by default on Windows. Every user who wants to run an ARToolKit application that uses QuickTime for video capture on Windows will need to install QuickTime. This is not onerous - any user who already has iTunes for Windows installed will have QuickTime installed already. Other users should visit the QuickTime for Windows download page.
Additionally, for customers using Windows who do wish to recompile libARvideo for their own purposes, the QuickTime SDK must be downloaded and installed.
Visual Studio 2013 is supplied with Windows SDK 8.1, which includes the required DirectShow link libraries, and some of the required headers. Interestingly, it also includes strmbase.lib, the library implementing the DirectShow base classes, but unfortunately does not include either the Debug version of this library (strmbasd.lib) or the header files. These would normally be required to be manually installed from the Windows SDK 7.1 samples package. However, we have made a package which includes the DirectShow base classes source and compiled libraries for 32-bit and 64-bit architectures.
If the package is un-RARed retaining the absolute paths, the final package path will be something similar to:
C:\Program Files\Microsoft SDKs\Windows\v7.1\Samples\multimedia\directshow\baseclasses\. No further configuration is required.
Depending on which version of the Microsoft developer tools and/or SDK version you are using, the components of the DirectShow SDK may be split across two packages. These instructions are targeted at the simplest way to get the SDK working.
You can only use the “Standard” or above version of Microsoft Visual Studio to compile libARvideo's DirectShow modules. Visual Studio “Express Edition” will not work, since the Express Edition does not support ATL (which is used by the DirectShow code) 1
Once you have installed the DirectX SDK (and Platform SDK if using VS2005), you need to tell Visual Studio where to find their header and library directories. Otherwise, when the ARToolKit source tries to include these files, Visual Studio won't know where to look for them. The way to tell VS where to look for files is to add them to the “search path” in the VS options.
Mac OS X: The QuickTime SDK is installed by default along with XCode, and no further action should be needed.
Windows: Download the QuickTime SDK for Windows. We recommend installing the SDK to the default location,
C:\\Program Files\\QuickTime SDK. This is because the paths in ARToolKit’s build files expect this location.
ARToolKit's build files expect to find QuickTime at
C:\\Program Files\\QuickTime SDK. Unless you change this location, no further setup is required.
libARvideo will include the video interface defined in
AR/config.h. To use DirectShow (default), define
AR_INPUT_WINDOWS_DIRECTSHOW. To use QuickTime, define
AR_INPUT_QUICKTIME. To define a constant, open
AR/config.h', locate the desired constant block, and change the #undef
in front of the variable to #define
*Note: Defining ARINPUTQUICKTIME
enables the use of QuickTime, but does not make it the default video interface.* If you also wish to have the QuickTime module used by default, locate the constant AR_DEFAULT_INPUT_QUICKTIME in AR/config.h
and enable it as described above. The QuickTime module can be selected at runtime by passing -device=QUICKTIME
in the video config string (the parameter to arVideoOpen()`).
From there, compiling should be just a matter of right-clicking on “ARVideo” in the solution explorer and choosing “Build.”
If you are having difficulty with these instructions, please post a message on the forum.
Last modified: 2016/02/15 05:41 (external edit)