PageRenderTime 30ms CodeModel.GetById 11ms RepoModel.GetById 0ms app.codeStats 0ms

Plain Text | 78 lines | 59 code | 19 blank | 0 comment | 0 complexity | d2fa800464f501732f99aaeaa0c4c477 MD5 | raw file
Possible License(s): LGPL-2.1
  1. Second Life - Joystick & SpaceNavigator Support README
  2. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  3. WHAT IS IT?
  4. -=-=-=-=-=-
  5. This feature allows the use of a joystick or other supported multi-axis
  6. device for controlling your avatar and camera.
  8. -=-=-=-=-=-=
  9. * A joystick or other generic multi-axis input device supported by your chosen
  10. version of Linux
  11. - OR -
  12. * A SpaceNavigator device (additional configuration may be required, see below)
  13. Success has been reported on the following systems so far:
  14. * Ubuntu 7.04 (Feisty) with a generic USB joystick
  15. * Ubuntu 7.04 (Feisty) with a USB 3DConnexion SpaceNavigator
  16. * Ubuntu 6.06 (Dapper) with a generic USB joystick
  17. * Ubuntu 6.06 (Dapper) with a USB 3DConnexion SpaceNavigator
  19. -=-=-=-=-=-=-
  20. SPACE NAVIGATOR: *Important* - do not install the Linux SpaceNavigator
  21. drivers from the disk included with the device - these are problematic.
  22. Some distributions of Linux (such as Ubuntu, Gentoo and Mandriva) will
  23. need some system configuration to make the SpaceNavigator usable by
  24. applications such as the Second Life Viewer, as follows:
  25. * Mandriva Linux Configuration:
  26. You need to add two new files to your system. This only needs to be
  27. done once. These files are available at the 'SpaceNavigator support with
  28. udev and Linux input framework' section of
  29. <>
  30. * Ubuntu or Gentoo Linux Configuration:
  31. For a quick start, you can simply paste the following line into a terminal
  32. before plugging in your SpaceNavigator - this only needs to be done once:
  33. 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'
  34. For more comprehensive Linux SpaceNavigator configuration information please
  35. see the section 'Installing SpaceNavigator without the official driver' here:
  36. <>
  37. JOYSTICKS: These should be automatically detected and configured on all
  38. modern distributions of Linux.
  39. ALL: Your joystick or SpaceNavigator should be plugged-in before you start the
  40. Second Life Viewer, so that it may be detected. If you have multiple input
  41. devices attached, only the first detected SpaceNavigator or joystick device
  42. will be available.
  43. Once your system recognises your joystick or SpaceNavigator correctly, you
  44. can go into the Second Life Viewer's Preferences dialog, click the 'Input &
  45. Camera' tab, and click the 'Joystick Setup' button. From here you may enable
  46. and disable joystick support and change some configuration settings such as
  47. sensitivity. SpaceNavigator users are recommended to click the
  48. 'SpaceNavigator Defaults' button.
  50. -=-=-=-=-=-=-=
  51. * If your chosen version of Linux treats your joystick/SpaceNavigator as
  52. if it were a mouse when you plug it in (i.e. it is automatically used to control
  53. your desktop cursor), then the SL Viewer may detect this device *but* will be
  54. unable to use it properly.
  56. -=-=-=-=-=-=-=-=-
  57. Please report further issues to the public Second Life issue-tracker
  58. at <> (please note, however, that this is not
  59. a support forum).