Environmental Variables

Setup

After downloading a copy of the project, locate the folder "PropertySheets_REFERENCE" and create a copy in the same directory, named "PropertySheets". Open the property sheet PropertySheets/PathMacros.props and set the path variables as described in the list below.

Once you have set your local paths, you can use the .props files to quickly configure your project builds. If you want to use OpenCV in your debug build of your current project, just add the OpenCV_Debug.props sheet to your project using the Visual Studio property manager. You can find more details here.

Please do not add your copy of the PropertySheets to the SVN repository. Doing so would mess up other users' local path variables. If you make any new contributions to the .props collection, please add these over the PropertySheets_REFERENCE directory.

List of required local path variables

All your local paths referenced by Macros in the PathMacros.props file. Never set any local paths in the project files or other .props files - our filesystems are certain to be organized differently!!!

If any new software libraries are introduced, please add them to this list and ensure that they are declared as Macro variables! Also add the libraries' .props file to the reference directory

Syntax:

• Use a descriptive title, e.g. BOOST_ for anything boost-related
• INC denotes an include directory
• LIB denotes a release library directory (may also include differently named debug libraries)
• DLIB denotes a debug library directory (if debug libraries are named exactly as the release libraries

---

Frequently used:

• Common Classes

  • COMMON_CLASSES - Path to the folder containing all multi-purpose classes, such as "NiKinect_ext" etc.

• Boost Paths (1.46.1)

  • BOOST_INC - Boost include paths
  • BOOST_LIB - Boost library paths

• OpenNI Paths (1.3.3) (usually set by installer anyways)

  • OPEN_NI_INCLUDE - OpenNI include path
  • OPEN_NI_LIB - OpenNI lib path
  • OPEN_NI_INSTALL_PATH - basic OpenNI install path

• PointCloud Libary Paths (1.3)

  • PCL_INC - PCL include path (e.g. "C:\Program Files (x86)\PCL 1.3.0\include\pcl-1.3")
  • PCL_LIB - PCL library path (e.g. "C:\Program Files (x86)\PCL 1.3.0\lib")
  • PCL_ROOT - PCL root path (e.g. "C:\Program Files (x86)\PCL 1.3.0")

NB: If the compiler complains about not finding the PCL 3rd party libraries (Eigen etc.), just add the respective paths to these variabales (PCL_INC and PCL_LIB). Entries are eparated by a semicolon. Fortunatley, VS can parse such strings so that we don't need to introduce even more environmental variables...

• OpenCV Paths (2.3)

  • OPENCV_INC - OpenCV include path (e.g. "C:\Program Files\OpenCV2.3\build\include")
  • OPENCV_LIB - OpenCV library path (e.g. "C:\Program Files\OpenCV2.3\build\x86\vc10\lib")
  • OPENCV_LIB9 - OpenCV library path for MSVC9 (e.g. "C:\Program Files\OpenCV2.3\build\x86\vc9\lib")

• VRPN (7.28)

  • VRPN_INC - VRPN include paths (e.g. "C:\Program Files (x86)\VRPN07.28")
  • VRPN_LIB - VRPN library paths (e.g. "C:\Program Files (x86)\VRPN07.28\vrpn\pc_win32\DLL\Release")
  • VRPN_DLIB - Debug VRPN library paths (e.g. "C:\Program Files (x86)\VRPN07.28\vrpn\pc_win32\DLL\Release")
  • VRPNQUAT_LIB - VRPN quaternion library path (e.g. "C:\Program Files (x86)\VRPN07.28\vrpn\quat\pc_win32\Release")
  • VRPNQUAT_DLIB - Debug VRPN quaternion library path (e.g. "C:\Program Files (x86)\VRPN07.28\vrpn\quat\pc_win32\Debug")

• AR Toolkit Plus (2.1.1)

  • ARTKPLUS_INC - ARTK+ include paths (e.g. "C:\Program Files (x86)\ARToolkitPlus\include")
  • ARTKPLUS_LIB - ARTK+ library paths (e.g. "C:\Program Files (x86)\ARToolkitPlus\lib\Win32")

• VTK (5.8.0)

  • TODO: remember to add include path later...
  • VTK_LIB - Release library path (e.g. "C:\Program Files (x86)\VTK\bin\Release\")
  • VTK_DLIB - Debug library path (e.g. "C:\Program Files (x86)\VTK\bin\Debug\")

• Virtools (5.0)

  • VIRTOOLS_INC - include path (e.g. "C:\Program Files (x86)\3DVIA\Virtools 5.0\SDK\Includes"
  • VIRTOOLS_LIB - library path (e.g. "C:\Program Files (x86)\3DVIA\Virtools 5.0\SDK\Lib\Win32\Release")
  • VIRTOOLS_MANAGER - path to managers (e.g. "C:\Program Files (x86)\3DVIA\Virtools 5.0\Managers")

Rare:

• CMINPACK (1.1.3)

  • CMINPACK_INC - include path (e.g. "C:\Program Files (x86)\CMINPACK 1.1.3\include")
  • CMINPACK_LIB - libray path (e.g. "C:\Program Files (x86)\CMINPACK 1.1.3\lib")

• Fast Light Toolkit

  • FLTKDIR - base directory of the Fast Light ToolKit, used by ???

• Kinect SDK

  • KINECT_INC - include path (e.g. "C:\Program Files (x86)\Microsoft Research KinectSDK\inc")
  • KINECT_LIB - library path (e.g. "C:\Program Files (x86)\Microsoft Research KinectSDK\lib")