Difference between revisions of "3Dconnexion input devices"

From FreeCAD Documentation
Jump to: navigation, search
m (added known issue title)
m (space)
 
(2 intermediate revisions by 2 users not shown)
Line 134: Line 134:
 
As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed.
 
As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed.
  
==== Known Issue ====
+
==== Known Issue ==== <!--T:26-->
 
There is an issue where 3Dconnexion sends duplicate scroll events to FreeCAD, which causes the view to jump. To fix it:
 
There is an issue where 3Dconnexion sends duplicate scroll events to FreeCAD, which causes the view to jump. To fix it:
  
 +
<!--T:27-->
 
# Open 3Dconnexion Properties. You can double-click its icon in the Taskbar, next to the Windows clock.
 
# Open 3Dconnexion Properties. You can double-click its icon in the Taskbar, next to the Windows clock.
 
# Click on the Advanced Settings button.
 
# Click on the Advanced Settings button.
Line 142: Line 143:
 
# Switch back to 3Dconnexion Advanced Settings. Confirm that it says "FreeCAD" in the heading.
 
# Switch back to 3Dconnexion Advanced Settings. Confirm that it says "FreeCAD" in the heading.
 
# Uncheck all boxes on the page.
 
# Uncheck all boxes on the page.
 +
 +
<!--T:28-->
 +
<small>ref: https://freecadweb.org/tracker/view.php?id=1893</small>
  
 
== Setting up FreeCAD == <!--T:17-->
 
== Setting up FreeCAD == <!--T:17-->
Line 176: Line 180:
 
<!--T:22-->
 
<!--T:22-->
 
[[Category:User Documentation]]
 
[[Category:User Documentation]]
 +
 
</translate>
 
</translate>

Latest revision as of 14:22, 25 September 2019

Other languages:
čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎română • ‎русский • ‎Türkçe
3Dconnexion SpaceNavigator

Driver installation

Linux

FreeCAD supports drivers from project Spacenav. This is a project aiming to create an open-sourced driver which is compatible with the proprietary drivers from 3Dconnexion.

Install from repo

Ubuntu
sudo apt-get install spacenavd
Fedora
sudo yum install spacenavd
Debian
apt-get install spacenavd libspnav-dev
  • spacenav needs these permissions
cp ~/.Xauthority /root/
  • Restart spnavd and FreeCAD
/usr/bin/spnavd_ctl x11 stop
/usr/bin/spnavd_ctl x11 start

Compile Spacenav from source

This is recommended if your distribution might provide an outdated version.

./configure
make
  • If this was successful, run the following commands as root (or prefix with sudo.)
make install
./setup_init
/etc/init.d/spacenavd start
  • This installs the spacenav daemon, configures it to automatically load on system boot, and starts the daemon without having to reboot.
  • Now it is time to check that your device is properly detected. With your device unplugged, run the following command and then plug it in.
tail -n100 -f /var/log/spnavd.log
  • If the output looks something like this, you can continue.
Device detection, parsing /proc/bus/input/devices
trying alternative detection, querying /dev/input/eventX device names...
  trying "/dev/input/event1" ... Power Button
  trying "/dev/input/event2" ... 3Dconnexion SpaceNavigator
using device: /dev/input/event2
device name: 3Dconnexion SpaceNavigator
  • Now enter the directory named libspnav-0.2.2 and run the following commands:
./configure
make
  • If make fails with the following error: ...
fatal error: gtk/gtk.h: No such file or directory
  • ... then you need to install libgtkmm-2.4-dev. Under Ubuntu, this is done like this:
sudo apt-get install libgtkmm-2.4-dev
  • When make has completed successfully, run the following command as root (or prefix with sudo.)
make install
  • Look in the directory libspnav-0.2.2/examples/. If you want to test your device, compile and run either one of the two examples.
  • Follow the same pattern to compile and install spnavcfg. Make sure to run spnavcfg as root, or no settings will be saved!

Restart

If sometimes navigator stops working, it is good to restart driver. To restart it, go to Terminal and execute:

sudo xhost +
sudo /etc/init.d/spacenavd restart

After that restart FreeCAD. On some distros this is necessary at each boot.

OSX

3Dconnexion input devices are supported on OS X, provided that FreeCAD is built and used on a system with the 3Dconnexion drivers installed.

Windows

As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed.

Known Issue

There is an issue where 3Dconnexion sends duplicate scroll events to FreeCAD, which causes the view to jump. To fix it:

  1. Open 3Dconnexion Properties. You can double-click its icon in the Taskbar, next to the Windows clock.
  2. Click on the Advanced Settings button.
  3. Open FreeCAD or switch to an already-open FreeCAD window.
  4. Switch back to 3Dconnexion Advanced Settings. Confirm that it says "FreeCAD" in the heading.
  5. Uncheck all boxes on the page.

ref: https://freecadweb.org/tracker/view.php?id=1893

Setting up FreeCAD

3D mouse support was made with spnav project on Linux, and on a very low level on Windows. This means there was no support for any settings for a device, since on Linux there is no good support for this, and on Windows it is overridden. This is why two additional pages were added to "Customize" dialog.

Spaceball Motion.png Spaceball Buttons.png

Spaceball Motion

In this tab you have ability to set up some of general space mouse settings. They include:

  • Global Sensitivity - Slider with ability to set global sensitivity
  • Dominant - if you enable dominant mode, only axes with highest move will be considered
  • Flip YZ - This option enables you to flip Y and Z axes on 3D mouse
  • Enable Translations - easy way to enable/disable translations
  • Enable Rotations - easy way to enable/disable rotations
  • Calibrate - enables you to calibrate space navigator. It is pressed while space navigator is not moved.
  • Set To Default - removes all settings and sets them to default.

Other than this, for each axes you have ability to set:

  • Enabled - Enable/Disable axes
  • Reverse - Reverse movement on axes
  • Sensitivity - slider with ability to set sensitivity

Spaceball Buttons

When you open this tab for the first time, it will be empty and unavailable. To activate it, you must press one of your space mouse buttons. After you do, list of buttons will appear on the left side, and list of commands will be available on the right side.

To connect certain command with a button, select button on the left side, and it's command on the right side. To clear commands from button, press "Clear".