freewrlduneinputdevice.1

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

.\" See section COPYING for conditions for redistribution
.\"
.TH FREEWRLDUNEINPUTDEVICE 1 \*(Dt
.SH NAME
\fBFreeWRLduneInputDevice\fP \- inputdevicedriver for FreeWRL
.SH SYNOPSIS
.br
\fBFreeWRLduneInputDevice inputdeviceoptions
[\fB 
axisoptions
\fP]
.\|.\|.
.SH DESCRIPTION
.B FreeWRLduneInputDevice
inputdevice driver for FreeWRL, based on FreeWRL's "/tmp/inpdev"
joystick input interface and white_dune's inputdevice mechanism.

.P
.SH INPUTDEVICEOPTIONS

The following options are only valid, if FreeWRLduneInputDevice was compiled 
with matching inputdevice driver support (e.g. there is not support for a 
Linux joystick under IRIX).
.TP
.B \-joystick joystickdevice \fP 

\fBjoystickdevice\fP is the device of Linux joystick 
(usually something like /dev/input/js0 or /dev/js0). Only valid under Linux.

.TP
.B \-spaceball spaceballdevice \fP 

\fBspaceballdevice\fP is the serial device connected to the spaceball
(usually something like /dev/ttyd2 or /dev/ttyS0). 
Only valid if binary was compiled with libsball support.

.TP
.B \-xinput xinputname \fP 

\fBxinputname\fP is the devicename supported by the Xinput Protocol 
(usually something like magellan or dialbox). Valid on most 
Unix/X11 implementations.

.TP
.B \-aflock\ aflockdevice\ \fP\ [\fB\ aflockoptions\ \fP]\ \fB\ \-tracker\ birdaddr\

\fBaflockdevice\fP is the serial device connected to the 
Ascension Flock of Birds master transmitter 
(usually something like /dev/ttyd2 or /dev/ttyS0).
FreeWRLduneInputDevice assumes the following configuration: 
Multiple FOBs with single RS232 Interface to Host Computer
(see "The flock of Birds, Installation and Operation Guide, 
Standalone and Multiple Transmitter/Multiple Sensors Configurations", 
Page 3 (chapter "Introduction"), Figure 2).
\fBbirdaddr\fP is the adress of the Bird Unit of the magnetic head tracker
(\fB\-tracker\fP) in the Fast Bird Bus 
(FBB adress) as configured with the dipswitches on the Bird Unit.
This program need to have the Flock of Birds configured in the Normal 
Address Mode only (see Page 12, Figure 4 of the manual decribed above). 

.TP 
.B \-sendalways

Tell FreeWRLduneInputDevice the device sends (almost) always values (do not switch to 
other VRML nodes to make sense of inputvalues). 
Automatically used for Ascension Flock of Birds device (\-aflock).

.TP 
.B \-headnavigation

Use current transformmode when using a headtracker. Default without this
option is using only the translation mode. This default gives you a
very natural reaction, when your head moves, the virtual world moves, but 
if your head only rotates, the virtual world stand still. With the 
headnavigation option, the virtual world reacts to head rotations, depending 
of the current transform mode. Be carefull when you use this feature while 
talking to a audience. Talking cause small and fast head rotations and will 
cause small and fast rotations of the virtual world. 
Your audience may get a impression like in a earthquake and is in danger
to get motion sickness.


.P
.SH AXISOPTIONS
.TP
.B \-x|\-y|\-z|\-xrot|\-yrot|\-zrot=[\-][integer_axisnumber][,[factor][,[accel][,[wheel][,ignore]]]]

.TP
.B \-all|-allxyz|-allrot=[\factor][,[accel][,[wheel][,ignore]]]

.TP
.B -axes=max_number_axes
.P
.SH AXISLEGEND
.TP
.B \- 

used to swap sign of value from axis 

.TP
.B  integer_axisnumber 

Integer with the number of the axis, 
that should be used for the x y z xrot yrot zrot directions.
This number may not be greater than the number of axes of the 
inputdevice

.TP
.B factor 

Float with a multiplicator for the axes

.TP
.B accel 

Float with a expotential accelerator for the axes

.TP
.B wheel 

The string "wheel"
  wheel means this axis of the inputdevice will not deliver zero 
  if released

.TP
.B ignore 

Float with the value (relative to the maximal value
from the device) which will be ignored (insensitivity)

.TP
.B max_number_axes 

Number of used axes, one of (2,3,4,5)
  This must be equal or less to the physical available 
  axes of a device. Main usage of this option is to disable 
  bad designed or mechanical defect axes e.g. when you wish, 
  this axis on a joystick would not exist

.P
.SH AFLOCKOPTIONS

This options are only valid for the Ascension flock of birds magnetic
tracking system.

.TP
.B \-baud baudrate

Baudrate of the serial line communicating with the transmitter.
Default: 38400

.TP
.B \-numbirds numberbirds

Number of "data delivering" birds attached to the transmitter (e.g. not 
counting the transmitter itself, if it is a Extended Range Controller (ERC)). 
Default: 2 (tracker).

.TP
.B \-master birdaddr

Adress of the master transmitter in the Fast Bird Bus (FBB adress) as 
configured with the dipswitches on the transmitter unit.
Default: 1

.TP
.B \-hemisphere\ FRONT_HEM|AFT_HEM|UPPER_HEM|LOWER_HEM|LEFT_HEM|RIGHT_HEM

Hemisphere used. Sit on the antenna block (with the legs near 
on the side of the text) to see, what is left or right 8-)
Default: RIGHT_HEM

.TP
.B \-sync 0|1

Synchronise (1) or not (0) data output to a CRT (Monitor) or 
your host computer.
Synchronisation is used to elimiate magnetic effects of a Monitor 
using the CRT sync cable.
Default: 0

.TP
.B \-block 0|1

Set (1) or do not set (0) the FNDELAY flag to the filedescriptor of
the serial port.
Default: 0


.TP
.B \-filter AC_NARROW | AC_WIDE | DC_FILTER

Enable different filters. Read the Flock of Birds manuals for more 
information.
This option can be repeated to use multiple filters.
Default: no filter set, using filter set by Flock autoconfiguration.

.TP
.B \-suddenchangelock 0|1

Allow (0) or disallow (1) setting of messured position and orientation 
when a sudden large messurement occure. 
Default: 1

.TP
.B \-calfile calibrationfile

Use a VR Juggler style file to calibrate position messurement.

.SH EXAMPLES
.P
.LP
.TP
FreeWRLduneInputDevice -xinput magellan -allxyz=10,100,,0.0000002 -xinput dialbox-1 -x=0 -y=2 -z=4 -xrot=1 -yrot=3 -zrot=5 -all=1000,,wheel
.br
starts FreeWRLduneInputDevice with a magellan xinputdevice with factor 10, 
acceleration 100 and a ignore value of 0.0000002 on the xyz axes 
and a dialbox device with 
.br
x axis = 0. axis 
.br
y axis = 2. axis 
.br
z axis = 4. axis
.br
rotation around x axis = 1. axis 
.br
rotation around y axis = 3. axis 
.br
rotation around y axis = 5. axis
.br
all axes use factor 1000 and all to not deliver zero if released
.LP
.TP
FreeWRLduneInputDevice -joystick /dev/input/js0 -z=,3 -axes=3
starts FreeWRLduneInputDevice with a linux joystick, set acceleration of 
the z axis to 3 and disables the 4. (5., 6., ...) axis.
.LP
.TP
FreeWRLduneInputDevice -aflock /dev/ttyS1 -numbirds 2 -master 1 -tracker 3
starts FreeWRLduneInputDevice with a Ascension Flock of Birds, master 
transmitter (a Extended Range Controller (ERC)) 
at FBB adress 1 connected to the serial device /dev/ttyS1. Use 2 Birds, 
one attached to a head tracking device at FBB adress 3.
.P
.SH FILES
.nf
.ta
.B /tmp/inpdev
stores vector/quaternion information for the VRML viewpoint of FreeWRL
.nf
.ta
.P
.SH COPYRIGHT

    Copyright (C) 1999  John Stewart and others
    Copyright (C) 2000  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.
.P
.SH BUGS
There is no support yet for restricted modes (e.g. Translation, Rotation only)
.SH "EXIT STATUS"
This program do not exit by itself.... 
.SH "SEE ALSO"
FreeWRL(1),
dune(1)