readme

FreeWRLduneInputDevice和FreeWRL一起可以让用户用带有6DoF的输入设备检索3D VRML/X3D数据。它基于FreeWRL的"/tmp/inpdev"扩展传感器输入接口和w

What is this:
============

This is a inputdevice driver for FreeWRL, based on FreeWRL's "/tmp/inpdev"
joystick input interface and white_dune's inputdevice mechanism.

Currently supported devices are:

6D joystick devices (e.g. Logitech Wingman Rumblepad)
        supported by the Linux joystick interface

LabTec Spaceball 
        supported by libsball (libsball is software developed by John E. Stone)

Ascension Flock of Birds magnetic headtracker (RS232 master configuration)
        supported by a driver based on sourcecode from Kevin Meinert/VRJuggler

Any device supported by the X11 Xinput protocol
        supported by the Xi library


Installation:
============

If you need LabTec Spaceball support, install libsball first.

   ./configure
   make

If you have a rpm (Redhat Package Manager) based system, you can build
a rpm package with 

   cd packager/rpm
   sh mkpg.sh

You can then install the binary package with a command like

   rpm -i /usr/src/RPM/RPMS/*/FreeWRLduneInputDevice-*.rpm

Running the program:
===================

Select the right commandline parameters for your inputdevice and start
the program. Then Load a VRML/X3D file into FreeWRL and press 
"f" for the "joystick fly mode".

With commandline parameters, you can select the device, assign a scale
for the axes, swap axes, swap axesdirections, deal with axes that do
not set back to zero if you release the device and set a zerorange
(usefull for learning to work with a spaceball or usefull to deal with 
devices, that do not set back exactly to zero if you release the device 
(e.g. joysticks with mechanical problems)).

Take a look at the directory "commandline_examples", if there is
already a example for your inputdevice.

E.g. if you have a Logitech Wingman Rumblepad, you can try the
file commandline_examples/wingmanrumblepad.sh

FreeWRLduneInputDevice -joystick /dev/input/js0 -x=0 -y=1 -z=-4 \
                                        -xrot=6 -yrot=-3 -zrot=5

In this example, the first joystick axis (number 0) is assigned to 
the VRML x-axis, the second joystick axis (number 1) is assigned
to the VRML y-axis and the fourth joystick axis (number 4) has directions
swapped and is assigned to the VRML z-axis and so on.

For more information about commandline paramaters, see the manpage.
If the manpage is not installed yet, you can view it with the command:

  nroff -man FreeWRLduneInputDevice.1 | more

on puristic GNU systems, use something like

  groff -Tascii -man FreeWRLduneInputDevice.1 | more

Copyrights for different parts/files of the program:
===================================================

 * Copyright (C) 1999 FreeWRL/John Stewart and others
 * Copyright (C) 2000 dune/Stephen F. White and others
 * Copyright (C) 2003 J. "MUFTI" Scheurich
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.

For more information about the GNU General Public License, see the file COPYING

 * (C) Copyright 1998-2000 VR Juggler/Kevin Meinert and others
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.

Design principle:
================

If you inspect the source of this program, you will see a lot of things,
which are not really needed. 
A lot of things are only here as supporting files, so the files starting
with "InputDevice" can be copied from white_dune unchanged:

InputDevice.cpp
InputDevice.h
InputDeviceCommandline.cpp 
Aflock.cpp
Aflock.h

If the input device driver of white_dune will be updated, 
it is very easy to update this input device driver of FreeWRL

This version contain the files of white_dune-0.22beta77.

MUFTI ([e-mail])