spacenavd/README

65 wiersze
3.0 KiB
Plaintext
Czysty Zwykły widok Historia

spacenavd - 0.3
---------------
1. About
Spacenavd, is a free software replacement user-space driver (daemon), for
3Dconnexion's space-something 6dof input devices. It's compatible with the
original 3dxsrv proprietary daemon provided by 3Dconnexion, and works
perfectly with any program that was written for the 3Dconnexion driver.
For more info on the spacenav project, visit: http://spacenav.sourceforge.net
2. Dependencies
In order to compile the spacenavd daemon, you'll need the following:
* GNU C Compiler
* GNU make
* Xlib headers (optional)
You can compile the daemon without Xlib, but it won't be compatible with
applications that where written for the original proprietary 3Dconnexion
driver (e.g. blender, maya, etc). The 3dxsrv compatibility interface needs to
go through the X window system.
3. Installation
If you have the dependencies installed, just run ``make'' to compile the
daemon, and ``make install'', to install it. The default installation prefix
is ``/usr/local''. If you wish to install somewhere else, just change the
PREFIX variable in the first line of the Makefile.
4. Running spacenavd
If your system uses SysV init, then everything should be set up to have
spacenavd start automatically during system startup. However, for now, you
won't have to reboot, just type ``/etc/init.d/spacenavd start'' as root, to
start the daemon immediately.
If your system uses BSD init (you can tell if you *don't* have a series of
directories called rc0.d, rc1.d, and so on, in /etc), then you'll have to
follow your init documentation and set this up yourself. You may be able to
use the provided init_script file as a starting point.
Depending on how your system startup process is set up, it might be the case
that the spacenavd daemon starts before the X server (for instance if you
don't use a graphical login). In that case the daemon will start properly, but
won't connect to the X server until explicitly told to do so. You can do that
by running ``spnavd_ctl x11 start'' as root, or by using the graphical
spnavcfg program. You don't really want to have to do that all the time
though, so it's a better idea to add the aforementioned spnavd_ctl command to
either your ~/.xsession or ~/.xinitrd file, or the system-wide
/etc/X11/Xsession file.
5. Configuration
The spacenavd daemon reads a number of options from the /etc/spnavrc file. If
that file doesn't exist, then it uses default values for everything. You may
use the graphical spnavcfg program to interactively set any of these options.
The daemon should respond immediately to your changes, and also the
configuration file should be updated automatically.
6. Troubleshooting
If you're having trouble running spacenavd, read the up to date FAQ on the
spacenav website: http://spacenav.sourceforge.net/faq.html
If you're still having trouble, send a description of your problem at
nuclear@member.fsf.org along with a copy of your /tmp/spnav.log and any other
relevant information.