• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    WGL_3DL_stereo_control
4
5Name Strings
6
7    WGL_3DL_stereo_control
8
9Contact
10
11    Seth Williams, 3Dlabs (seth.williams 'at' 3dlabs.com)
12    Harald Smit, 3Dlabs (harald.smit 'at' 3dlabs.com)
13
14Status
15
16    Complete
17
18Version
19
20    Date: 10/05/2005   Revision 1.0
21
22Number
23
24    313
25
26Dependencies
27
28    The extension is written against the OpenGL 2.0 Specification
29    although it should work on any previous OpenGL specification.
30
31    The WGL_EXT_extensions_string extension is required.
32
33Overview
34
35    The stereo extension provides an interface for manipulating the
36    emitter signal from the video adapter used to drive lcd shutter
37    glasses used for stereoscopic viewing.
38
39IP Status
40
41    None
42
43Issues
44
45    None
46
47New Procedures and Functions
48
49    BOOL wglSetStereoEmitterState3DL(HDC hDC, UINT uState)
50
51New Tokens
52
53   Accepted by the <uState> parameter:
54
55      WGL_STEREO_EMITTER_ENABLE_3DL        0x2055
56      WGL_STEREO_EMITTER_DISABLE_3DL       0x2056
57      WGL_STEREO_POLARITY_NORMAL_3DL       0x2057
58      WGL_STEREO_POLARITY_INVERT_3DL       0x2058
59
60Additions to Chapter 2 of the OpenGL 2.0 Specification (OpenGL Operation)
61
62    None
63
64Additions to Chapter 3 of the OpenGL 2.0 Specification (Rasterization)
65
66    None
67
68Additions to Chapter 4 of the OpenGL 2.0 Specification (Per-Fragment
69Operations and the Frame Buffer)
70
71    None
72
73Additions to Chapter 5 of the OpenGL 2.0 Specification (Special Functions)
74
75    None
76
77Additions to Chapter 6 of the OpenGL 2.0 Specification (State and
78State Requests)
79
80    None
81
82Additions to Appendix A of the OpenGL 2.0 Specification (Invariance)
83
84    None
85
86Additions to the WGL Specification
87
88    The state of the stereo emitter for video adapters that support
89    stereoscopic headsets can be modified using the following function:
90
91    BOOL wglSetStereoEmitterState3DL(HDC hDC, UINT uState)
92
93    <hDC> is a device context for the graphics adapter or a window
94    residing on a monitor whose graphics adapter supports the stereo
95    extension.
96
97    <uState> is the new state requested and is one and only one of
98    the following values:
99
100      WGL_STEREO_EMITTER_ENABLE_3DL
101        Turn the stereo emitter output from the video adapter ON.
102
103      WGL_STEREO_EMITTER_DISABLE_3DL
104        Turn the stereo emitter output from the video adapter OFF.
105
106      WGL_STEREO_POLARITY_NORMAL_3DL
107        Generate an emitter signal for the stereoscopic headset to show
108        the scene from the left eye's point of view while the right eye's
109        shutter is closed and vice versa.
110
111      WGL_STEREO_POLARITY_INVERT_3DL
112        Generate an emitter signal for the stereoscopic headset to show
113        the scene from the left eye's point of view while the left eye's
114        shutter is closed and vice versa.
115
116    A call to wglSetStereoEmitterState is necessary for each state transition
117    required.
118
119Dependencies on WGL_EXT_extensions_string
120
121    Because there is no way to extend wgl, these calls are defined in
122    the ICD and can be called by obtaining the address with
123    wglGetProcAddress.  Because this extension is a WGL extension, it
124    is not included in the GL_EXTENSIONS string.  Its existence can be
125    determined with the WGL_EXT_extensions_string extension.
126
127Errors
128
129    If the function succeeds, a value of TRUE is returned.  If the
130    function fails, a value of FALSE is returned.  To get extended
131    error information, call GetLastError.
132
133      ERROR_DC_NOT_FOUND         <hDC> is invalid.
134
135      ERROR_INVALID_DATA         <uState> is invalid.
136
137New State
138
139    None
140
141New Implementation Dependent State
142
143    None
144
145Revision History
146
147    09/28/2005  0.1  First draft.
148    10/05/2005  1.0  Initial public release.
149