VTK/3DConnexion Devices Support: Difference between revisions

From KitwarePublic
< VTK
Jump to navigationJump to search
Line 14: Line 14:
== Install the 3DConnexion Device driver ==
== Install the 3DConnexion Device driver ==
=== Linux ===
=== Linux ===
* Download the driver from the 3DConnexion wesbite: http://www.3dconnexion.com/support/downloads.php
** Select the product, (example SpaceNavigator SE),
** select the OS (Linux),
** select the driver file for the architecture (3DxWare for Linux (i386) for 32-bit, 3DxWare for Linux (x86_64) for 64-bit )
For example, for Linux 64-bit, we will get the 3 following files:
* 3dxware-linux-v1-4-3.x86_64.tar.gz,
* InstallationInstructions_Linux.txt,
* Release_Notes-All_Platforms-20090806.pdf


=== Windows ===
=== Windows ===

Revision as of 18:34, 21 August 2009

Support for 3DConnexion Devices (SpaceNavigator, SpacePilot) inside VTK

THIS IS EXPERIMENTAL WORK

Naming convention

We pick the name TDx to refer to classes or types to support 3DConnexion Devices. "T" stands for "Three", "x" stands for "connexion". Why? because 3DConnexion calls its software 3DxWare but we cannot have types and classes starting with a number in C++, so we chose "T" instead of "3".

Supported Platform

  • Linux: yes (tested with Ubuntu GNU/Linux 9.04 x86_64, gcc, with a 3DConnexion SpaceNavigator)
  • Windows: yes (tested with Windows Vista Ultimate SP2 64-bit, Visual Studio 9 SP1, with a 3DConnexion SpaceNavigator)
  • Mac: no yet

How to use it

Install the 3DConnexion Device driver

Linux

  • Download the driver from the 3DConnexion wesbite: http://www.3dconnexion.com/support/downloads.php
    • Select the product, (example SpaceNavigator SE),
    • select the OS (Linux),
    • select the driver file for the architecture (3DxWare for Linux (i386) for 32-bit, 3DxWare for Linux (x86_64) for 64-bit )

For example, for Linux 64-bit, we will get the 3 following files:

  • 3dxware-linux-v1-4-3.x86_64.tar.gz,
  • InstallationInstructions_Linux.txt,
  • Release_Notes-All_Platforms-20090806.pdf

Windows

Easy. Nothing to add about it.

Install the 3DConnexion SDK

Linux

Windows

Easy. There is nothing to install

Configure VTK

Launch cmake and set the advanced option VTK_USE_TDx to TRUE

Linux

Set the advanced variables:

  • VTK_TDX_INCLUDE_PATH to point to the path of xdrvlib.h (without mentioning xdrvlib.h)
  • VTK_TDX_OBJECT_PATH to the full path to xdrvlib.a (mentioning xdrvlib.a)

Windows

Easy. There is nothing else to set.

Build VTK

Just build vtk.

Test it

Launch TestTDx in interactive mode 1. Get the full command line of the test with:

$ ctest -R TestTDx -V -N

2. Copy the full command line in the prompt and add -I at the end, to run the test in interactive mode

3. Enjoy