Home Page
Products & Services Industries Support & Resources News & Events Company
Overview
FreeForm Systems
ClayTools System
Haptic Devices
OpenHaptics Toolkit
System Requirements
FAQs
Haptic Projects & Papers
Haptic Application Gallery
Haptic Application Videos
Custom Development
OEMs & System Integrators
Product Data Sheets
Where to Buy

OpenHaptics Toolkit for Windows® - FAQs

How do I install my license for the OpenHaptics toolkit for Windows
Pick a directory to store your license file. This file has the filename license.lic. Now set an environment variable named OH_SDK_LICENSE_PATH to be the path to that directory. For example, if your license key is stored in the directory C:\OpenHapticsLicense, and your license key is in C:\OpenHapticsLicense\license.lic, then OH_SDK_LICENSE_PATH should have the value C:\OpenHapticsLicense

How do I set environment variables?
There are several ways. For Windows users, the most convenient way is probably through the System control panel. Go to Control Panel and select the System control panel (or right click on My Computer and select Properties). In the System control panel, go to the Advanced tab and press the Environment Variables button. You can add the OH_SDK_LICENSE_PATH environment variable to either User Variables or System Variables.

Do I have to set an environment variable?
No, but we recommend it. You can also place the license.lic file in the same directory as your OpenHaptics program. However, if you're working with more than one OpenHaptics application, it gets tedious to have to copy license.lic to every application directory. That's why we recommend the environment variable approach.

Can I use the OpenHaptics toolkit with the Visual C++ .NET 2003 compiler?
You might have noticed linker errors when building some of the OpenHaptics example programs with Visual C++ .NET 2003. Fortunately, OpenHaptics for Windows can be used with the Microsoft Visual C++ .NET 2003 compiler with a little effort. When you install OpenHaptics, the Haptic Device Utility (HDU) Haptic Library Utility (HLU), and SnapConstraints libraries have been built for Microsoft Visual C++ 6.0. Due to compatibility issues with the C++ standard library, these libraries need to be recompiled in order to work with the .NET C++ compiler. Fortunately, this is straightforward and only has to be done once.

The source code for the HDU and HLU libraries is included with your OpenHaptics installation, and so have the Microsoft Visual C++ 6.0 project files. To convert these libraries for use with Visual C++ .NET 2003, perform the following steps:

  1. Go to the OpenHaptics utilities directory. If you installed OpenHaptics in C:\Program Files\OpenHaptics, then this directory is C:\Program Files\OpenHaptics\utilities.
  2. Go to the utilities\src\HDU directory and open HDU.dsw with Visual C++ .NET 2003. Visual C++ will ask you if you want to convert the project file to the newer .sln format. Say yes.
  3. Rebuild Release and Debug versions of the HDU library. Using the Build/Batch Build menu item, and then pressing the Rebuild button, is probably easiest way to do this. It won't take long to rebuild the library.
  4. Copy the newly rebuilt hdu.lib and hdud.lib files from the Debug and Release directories in src/HDU to the utilities/lib directory. This will overwrite the lib files built for Visual C++ 6.0.  Note: hdud.lib is the debug version and hdu.lib is the release version. 
  5. Repeat this process with the SnapConstraints library (SnapContraints.lib and SnapContaintsD.lib). You may wish to do this with the HLU and HapticMouse libraries as well.

You should now be able to successfully link the OpenHaptics examples.

back to top