>Psychtoolbox>PsychDocumentation

NVision3D - Support for NVidia NVision stereo goggles.

Psychtoolbox supports use of USB driven stereo shutter glasses from
NVidia’s NVision stereo kit. The support for USB is currently limited to
64-Bit Linux systems, ie., 64-Bit Octave and 64-Bit Matlab on Linux.

If you want to drive such shutter glasses via a suitable NVidia Quadro
series GPU or AMD Fire series GPU that has a 3-Pin-Mini-DIN stereo output
connector then you can simply connect the stereo emitter to that
connector, setup your graphics card for it, and select stereomode 1 in
Psychtoolbox.

If you want to drive such shutter glasses via any graphics card from any
vendor via the USB connector, then you will have to select stereomode 11
in your scripts and perform the following setup steps beforehand. This
functionality is currently limited to 64-Bit Linux only, and highly
experimental in nature, without any guarantees that this will work
reliably - or at all - for you.

Use of USB driven stereo goggles is enabled by use of the LGPL licensed
open-source library nvstusb from …
http://sourceforge.net/projects/libnvstusb\ … thank you!
A copy of the libraries source code can be found in the
PsychSourceGL/Cohorts/libnvstusb-code-32/ subfolder or the original code
in the libnvstusb-code-32.zip file in that folder. See “help
UseTheSource” on how to get the PsychSourceGL folder with Psychtoolbox
source code.

Setup steps:

1. Run PsychLinuxConfiguration if you installed PTB from your
   Linux distributions package manager, or from NeuroDebian. If you
   installed via DownloadPsychtoolbox or UpdatePsychtoolbox,
   PsychLinuxConfiguration will have been executed for you already. Make
   sure to answer with yes when the function asks you for approval to
   update the udev rules file.

2. Reboot your machine.

3. Connect the stereo emitter to a suitable USB port.

4. Get the nvstusb.fw file from somewhere. You can find it either
   on the Internet via a Google search, or you can use the
   nvstusb-extractfw tool in the Psychtoolbox/PsychHardware folder from a
   terminal window. It needs to be pointed to a file of the installed
   NVidia stereo driver for Microsoft Windows, which obviously requires
   you to have a working MS-Windows installation with a NVidia card.
   Alternatively follow the instructions about generating nvstusb.fw from
   this website: http://nvstusb.gnu-log.net/\

5. Copy the nvstusb.fw file into your home directory, e.g., if your
   user name is mathilde: /home/mathilde/nvstusb.fw or even better into
   the Psychtoolbox configuration directory, e.g.,
   /home/mathilde/.Psychtoolbox/nvstusb.fw

6. You should be set. Run, e.g., StereoDemo(11) or ImagingStereoDemo(11).