import NVIDIA-FreeBSD-x86-190.42
[nvidia.git] / doc / html / chapter-13.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta name="generator" content=
5 "HTML Tidy for FreeBSD (vers 1 September 2005), see www.w3.org">
6 <meta http-equiv="Content-Type" content=
7 "text/html; charset=us-ascii">
8 <title>Chapter&nbsp;13.&nbsp;Configuring GLX in Xinerama</title>
9 <meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
10 <link rel="start" href="index.html" title=
11 "NVIDIA Accelerated FreeBSD Graphics Driver README and Installation Guide">
12 <link rel="up" href="part-01.html" title=
13 "Part&nbsp;I.&nbsp;Installation and Configuration Instructions">
14 <link rel="prev" href="chapter-12.html" title=
15 "Chapter&nbsp;12.&nbsp;Configuring TwinView">
16 <link rel="next" href="chapter-14.html" title=
17 "Chapter&nbsp;14.&nbsp;Configuring Multiple X Screens on One Card">
18 </head>
19 <body>
20 <div class="navheader">
21 <table width="100%" summary="Navigation header">
22 <tr>
23 <th colspan="3" align="center">Chapter&nbsp;13.&nbsp;Configuring
24 GLX in Xinerama</th>
25 </tr>
26 <tr>
27 <td width="20%" align="left"><a accesskey="p" href=
28 "chapter-12.html">Prev</a>&nbsp;</td>
29 <th width="60%" align="center">Part&nbsp;I.&nbsp;Installation and
30 Configuration Instructions</th>
31 <td width="20%" align="right">&nbsp;<a accesskey="n" href=
32 "chapter-14.html">Next</a></td>
33 </tr>
34 </table>
35 <hr></div>
36 <div class="chapter" lang="en">
37 <div class="titlepage">
38 <div>
39 <div>
40 <h2 class="title"><a name="xineramaglx" id=
41 "xineramaglx"></a>Chapter&nbsp;13.&nbsp;Configuring GLX in
42 Xinerama</h2>
43 </div>
44 </div>
45 </div>
46 <p>The NVIDIA FreeBSD Driver supports GLX when Xinerama is enabled
47 on similar GPUs. The Xinerama extension takes multiple physical X
48 screens (possibly spanning multiple GPUs), and binds them into one
49 logical X screen. This allows windows to be dragged between GPUs
50 and to span across multiple GPUs. The NVIDIA driver supports
51 hardware accelerated OpenGL rendering across all NVIDIA GPUs when
52 Xinerama is enabled.</p>
53 <p>To configure Xinerama</p>
54 <div class="orderedlist">
55 <ol type="1">
56 <li>
57 <p>Configure multiple X screens (refer to the XF86Config(5x) or
58 xorg.conf(5x) man pages for details).</p>
59 </li>
60 <li>
61 <p>Enable Xinerama by adding the line</p>
62 <pre class="screen">
63     Option "Xinerama" "True"
64 </pre>
65 <p>to the "ServerFlags" section of your X config file.</p>
66 </li>
67 </ol>
68 </div>
69 <p></p>
70 <p>Requirements:</p>
71 <div class="itemizedlist">
72 <ul type="disc">
73 <li>
74 <p>Using identical GPUs is recommended. Some combinations of
75 non-identical, but similar, GPUs are supported. If a GPU is
76 incompatible with the rest of a Xinerama desktop then no OpenGL
77 rendering will appear on the screens driven by that GPU. Rendering
78 will still appear normally on screens connected to other supported
79 GPUs. In this situation the X log file will include a message of
80 the form:</p>
81 <pre class="screen">
82 (WW) NVIDIA(2): The GPU driving screen 2 is incompatible with the rest of
83 (WW) NVIDIA(2):      the GPUs composing the desktop.  OpenGL rendering will
84 (WW) NVIDIA(2):      be disabled on screen 2.
85 </pre></li>
86 <li>
87 <p>NVIDIA's GLX implementation only supports Xinerama when physical
88 X screen 0 is driven by the NVIDIA X driver. This is because the
89 X.Org X server bases the visuals of the logical Xinerama X screen
90 on the visuals of physical X screen 0.</p>
91 <p>When physical X screen 0 is not being driven by the NVIDIA X
92 driver and Xinerama is enabled, then GLX will be disabled. If
93 physical X screens other than screen 0 are not being driven by the
94 NVIDIA X driver, OpenGL rendering will be disabled on them.</p>
95 </li>
96 <li>
97 <p>Only the intersection of capabilities across all GPUs will be
98 advertised.</p>
99 <p>The maximum OpenGL viewport size depends on the hardware used,
100 and is described by the following table. If an OpenGL window is
101 larger than the maximum viewport, regions beyond the viewport will
102 be blank.</p>
103 <div class="informaltable">
104 <table summary="(no summary available)" border="0">
105 <colgroup>
106 <col></colgroup>
107 <thead>
108 <tr>
109 <th>OpenGL Viewport Maximums in Xinerama</th>
110 </tr>
111 </thead>
112 </table>
113 <table summary="(no summary available)" border="0">
114 <colgroup>
115 <col>
116 <col></colgroup>
117 <tbody>
118 <tr>
119 <td>GeForce GPUs before GeForce 8:</td>
120 <td>4096 x 4096 pixels</td>
121 </tr>
122 <tr>
123 <td>GeForce 8 and newer GPUs:</td>
124 <td>8192 x 8192 pixels</td>
125 </tr>
126 <tr>
127 <td>Quadro:</td>
128 <td>as large as the Xinerama desktop</td>
129 </tr>
130 </tbody>
131 </table>
132 </div>
133 <p></p>
134 </li>
135 <li>
136 <p>X configuration options that affect GLX operation (e.g.: stereo,
137 overlays) should be set consistently across all X screens in the X
138 server.</p>
139 </li>
140 </ul>
141 </div>
142 <p></p>
143 <p>Known Issues:</p>
144 <div class="itemizedlist">
145 <ul type="disc">
146 <li>
147 <p>Versions of XFree86 prior to 4.5 and versions of X.Org prior to
148 6.8.0 lack the required interfaces to properly implement overlays
149 with the Xinerama extension. On earlier server versions mixing
150 overlays and Xinerama will result in rendering corruption. If you
151 are using the Xinerama extension with overlays, it is recommended
152 that you upgrade to XFree86 4.5, X.Org 6.8.0, or newer.</p>
153 </li>
154 </ul>
155 </div>
156 <p></p>
157 </div>
158 <div class="navfooter">
159 <hr>
160 <table width="100%" summary="Navigation footer">
161 <tr>
162 <td width="40%" align="left"><a accesskey="p" href=
163 "chapter-12.html">Prev</a>&nbsp;</td>
164 <td width="20%" align="center"><a accesskey="u" href=
165 "part-01.html">Up</a></td>
166 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
167 "chapter-14.html">Next</a></td>
168 </tr>
169 <tr>
170 <td width="40%" align="left" valign="top">
171 Chapter&nbsp;12.&nbsp;Configuring TwinView&nbsp;</td>
172 <td width="20%" align="center"><a accesskey="h" href=
173 "index.html">Home</a></td>
174 <td width="40%" align="right" valign="top">
175 &nbsp;Chapter&nbsp;14.&nbsp;Configuring Multiple X Screens on One
176 Card</td>
177 </tr>
178 </table>
179 </div>
180 </body>
181 </html>