VR support for 6DoF interaction

[saxondigital]

Support 6DoF input devices such as the zSpace stylus.

Current interaction is limited to two dimensions based on mouse emulation.

[saxondigital]

NEW support for 3Dconnexion SpaceMouse

ANTz-msw_2019-10-03 (v 0.213.1)

Currently supporting the 3Dconnexion SpaceMouse (aka: SpaceBall, SpaceMouse Wireless/Pro/Enterprise/Explorer, etc.) using freeglut version 3.2, which (as of 2014) has 3Dconnexion support via glutSpaceBall() event callbacks. Note that the system will see a 'Logitech SpaceNavigator' device driver, which MUST be separately downloaded and installed:

Download OS driver from: https://www.3dconnexion.com/

IMPORTANT SETTINGS!!!!

TO AVOID strange behavior (like scrollwheel from the SpaceMouse), you MIGHT NEED to config the 3Dconnexion settings.

• 1st - MAKE SURE that 'antz' app is running and IS the MOST RECENT active window (will be displayed within the 3Dconnexion dialog) when changing the settings. This is because 3Dconnexion settings are NOT global, but instead specific to each app.

• 2nd - Deselect ALL 'Navigation' checkboxes in the 3Dconnexion 'Advanced Settings' preferences (to prevent unwanted scrollwheel behavior.)

• 3rd - Set both L&R buttons to 'Disabled' (to prevent floating utility dialogs from popping up).

*Default 3Dconnexion Button configurations vary with the model.

---

SpaceMouse (standard edition) - Uncheck ALL boxes in 'Advanced Settings'

---

SpaceMouse (standard edition) - Disable both L&R 'Buttons'

---

SpaceMouse (standard edition)

Example of Floating Dialog triggered by button config.

---

Developers

You can activate the 3Dconnexion lib by:

• Comment back-in: #define NP_ADDON_3DX' located in 'nptypes.h'
• Configuring your (OS specific) build environment.

MSW Visual Studio (2013) project settings:

• vcproj...->C/C++->General->Additional Include Directories
  '../../libs/3dx/Inc'
• vcproj...->Linker->General->additional library directories
  '../../libs/3dx/Lib/x86'
• vcproj...->Linker->Input->Additional Dependecies
  'siapp.lib'
• vcproj...->Linker->General->Output File
  'inherent...'

Linux:

• See the 3Dconnexion SDK docs to configure your makefile.

OSX:

• See the 3Dconnexion SDK docs on adding the framework to Xcode.

*3Dconnexion SDK can be found at https://www.3dconnexion.com/

---

Known Bug:
Continual drift occurs if the scope of the current object(s) change while manipulating them. This is due to the velocity rates (move/rotate/scale) not being reset to zero when another object is selected. This can also be used as a feature, such as setting a continual rotation rate.

[saxondigital]

Add DLL driver detection to avoid (S!.appdll.dll) error dialog on launch for when 3Dconnexion drivers are NOT installed on the system.

[saxondigital]

Fix Spacemouse (wireless and enterprise versions)

[saxondigital]

Support for the newer 3Dconnexion devices has been added with a custom patch to the freeglut.dll and minor changes to the antz core code. Tested with SpaceMouse Wireless and Enterprise editions. Additional info is on the wiki page 3D Mouse.