Skip to main content
Help us improve Python packaging – donate today!

ctypes wrapper around libspnav, a client for reading events from a Space Navigator 3D mouse

Project Description

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/

Release history Release notifications

This version
History Node

0.9

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
spnav-0.9.tar.gz (7.1 kB) Copy SHA256 hash SHA256 Source None Sep 16, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page