PageRenderTime 21ms CodeModel.GetById 16ms app.highlight 1ms RepoModel.GetById 1ms app.codeStats 1ms

/indra/newview/linux_tools/client-readme-joystick.txt

https://bitbucket.org/lindenlab/viewer-beta/
Plain Text | 78 lines | 59 code | 19 blank | 0 comment | 0 complexity | d2fa800464f501732f99aaeaa0c4c477 MD5 | raw file
 1Second Life - Joystick & SpaceNavigator Support README
 2-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 3
 4WHAT IS IT?
 5-=-=-=-=-=-
 6
 7This feature allows the use of a joystick or other supported multi-axis
 8device for controlling your avatar and camera.
 9
10REQUIREMENTS
11-=-=-=-=-=-=
12
13* A joystick or other generic multi-axis input device supported by your chosen
14  version of Linux
15
16- OR -
17
18* A SpaceNavigator device (additional configuration may be required, see below)
19
20Success has been reported on the following systems so far:
21* Ubuntu 7.04 (Feisty) with a generic USB joystick
22* Ubuntu 7.04 (Feisty) with a USB 3DConnexion SpaceNavigator
23* Ubuntu 6.06 (Dapper) with a generic USB joystick
24* Ubuntu 6.06 (Dapper) with a USB 3DConnexion SpaceNavigator
25
26CONFIGURATION
27-=-=-=-=-=-=-
28
29SPACE NAVIGATOR: *Important* - do not install the Linux SpaceNavigator
30drivers from the disk included with the device - these are problematic.
31Some distributions of Linux (such as Ubuntu, Gentoo and Mandriva) will
32need some system configuration to make the SpaceNavigator usable by
33applications such as the Second Life Viewer, as follows:
34
35* Mandriva Linux Configuration:
36  You need to add two new files to your system.  This only needs to be
37  done once.  These files are available at the 'SpaceNavigator support with
38  udev and Linux input framework' section of
39  <http://www.aaue.dk/~janoc/index.php?n=Personal.Downloads>
40
41* Ubuntu or Gentoo Linux Configuration:
42  For a quick start, you can simply paste the following line into a terminal
43  before plugging in your SpaceNavigator - this only needs to be done once:
44  sudo bash -c 'echo KERNEL==\"event[0-9]*\", SYSFS{idVendor}==\"046d\", SYSFS{idProduct}==\"c626\", SYMLINK+=\"input/spacenavigator\", GROUP=\"plugdev\", MODE=\"664\" > /etc/udev/rules.d/91-spacenavigator-LL.rules ; echo "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?><deviceinfo version=\"0.2\"><device><match key=\"info.product\" contains=\"3Dconnexion SpaceNavigator\"><merge key=\"input.x11_driver\" type=\"string\"></merge></match></device></deviceinfo>" > /etc/hal/fdi/policy/3Dconnexion_SpaceNavigator_LL.fdi'
45
46For more comprehensive Linux SpaceNavigator configuration information please
47see the section 'Installing SpaceNavigator without the official driver' here:
48<http://www.aaue.dk/~janoc/index.php?n=Personal.3DConnexionSpaceNavigatorSupport>
49
50JOYSTICKS: These should be automatically detected and configured on all
51modern distributions of Linux.
52
53ALL: Your joystick or SpaceNavigator should be plugged-in before you start the
54Second Life Viewer, so that it may be detected.  If you have multiple input
55devices attached, only the first detected SpaceNavigator or joystick device
56will be available.
57
58Once your system recognises your joystick or SpaceNavigator correctly, you
59can go into the Second Life Viewer's Preferences dialog, click the 'Input &
60Camera' tab, and click the 'Joystick Setup' button.  From here you may enable
61and disable joystick support and change some configuration settings such as
62sensitivity.  SpaceNavigator users are recommended to click the
63'SpaceNavigator Defaults' button.
64
65KNOWN PROBLEMS
66-=-=-=-=-=-=-=
67
68* If your chosen version of Linux treats your joystick/SpaceNavigator as
69if it were a mouse when you plug it in (i.e. it is automatically used to control
70your desktop cursor), then the SL Viewer may detect this device *but* will be
71unable to use it properly.
72
73FURTHER PROBLEMS?
74-=-=-=-=-=-=-=-=-
75
76Please report further issues to the public Second Life issue-tracker
77at <http://jira.secondlife.com/> (please note, however, that this is not
78a support forum).