stereo(1X) — Commands
Name
XDECStereoQueryExtension, XDECStereoQueryVersion, XDECStereoSetMode, XDECStereoQueryMode − stereo operations
Syntax
#include "X11/DECStereo.h"
#include "X11/DECStereostr.h"
Bool XDECStereoQueryExtension(display, event_base, error_base)
Display∗display;
int∗event_base;
int∗error_base;
Status XDECStereoQueryVersion(display, major_version, minor_version)
Display∗display;
int∗major_version;
int∗minor_version;
void XDECStereoSetMode(display, drawable, mode)
Display ∗display;
Drawable drawable;
int mode;
Status XDECStereoQueryMode(display, drawable, mode, stereoCapable)
Display ∗display;
Drawable drawable;
int ∗mode;
int ∗stereoCapable;
Description
The PixelVision graphics option posesses stereo capabilities. To enable this functionality, the DECStereo X Extension has been created. This consists of a simple set of library routines that will:
- Query/Load the extension (XDECStereoQueryExtension)
- Query the extension version (XDECStereoQueryVersion)
- Set the stereo mode (XDECStereoSetMode)
- Query the current stereo mode (XDECStereoQueryMode)
The constant, structure and function prototype definitions are found in:
/usr/include/X11/extensions/DECStereo.h
/usr/include/X11/extensions/DECStereostr.h
The client side library for use is in /usr/lib/libDECStereo.a. The shareable image version of this library is found in /usr/shlib/libDECStereo.so.
A helper program is supplied in /usr/bin/X11/xstereo which exercises all the functions of the DECStereo extension. A man page is also supplied.
XDECStereoQueryExtension will query the X server and attempt to load the DECStereo extension and will return False if it cannot load the extension, and return True and the event_base and error_base codes if the query/load is successful.
XDECStereoQueryVersion will return 0 upon failure, and return 1 and the major and minor version number of the DECStereo protocol if successful.
XDECStereoSetMode will set the stereo mode of the server and PixelVision hardware, where mode is either StereoOn or StereoOff. This routine will have no effect on screens which do not support stereo mode. Furthermore, there will be no indication if this success or fails.
XDECStereoQueryMode will query the stereo mode of the server and PixelVision hardware. If this query fails, the returned value is 0. If this query succeeds, the function value is 1 and the mode is either StereoOn or StereoOff. Additionally, the flag stereoCapable is set to the value 1 if the screen for this drawable is stereo capable or not.