semvec/pypi-packages huggingface dataset:
spnav 0.9
ctypes wrapper around libspnav, a client for reading events from a Space Navigator 3D mouse
License: BSD license

spnav: a ctypes wrapper for libspnav, a Space Navigator 3D mouse client

Introduction
------------

The spnav module provides a Python interface to the libspnav C
library, which allows you to read events from a Space Navigator 3D
mouse on Linux systems.  These input devices simultaneously report
linear force and rotational torque applied by the user to the device,
along with button events. See:

        http://www.3dconnexion.com/products/spacenavigator.html

for more information about the 3D navigator.


Prerequisites
-------------

As a general prerequisite to using the spnav module, you need to
install libspnav and spacenavd, available from:

        http://spacenav.sourceforge.net/

Then you need to connect a supported 3D mouse to your system.
Spacenavd supports USB devices with no configuration, but serial-based
devices will need a /etc/spnavrc configuration file.

The spnav module requires ctypes, which is standard in Python 2.5 and
later, although I have only tested spnav with Python 2.7.


Installation
------------

The spnav module installs like any other python package.  You can
install the package from the unpacked source directory by running

  sudo python setup.py install

Quick Test
----------

To see if your installation is working, spnav comes with a test script
in the module:

  python -m spnav

This will print motion and button events from your Space Navigator to
the console.

For more information and example code, see the documentation:

  http://spnav.readthedocs.org/