import NVIDIA-FreeBSD-x86-180.29
[nvidia.git] / doc / html / chapter-11.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;11.&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-10.html" title=
15 "Chapter&nbsp;10.&nbsp;Configuring TwinView">
16 <link rel="next" href="chapter-12.html" title=
17 "Chapter&nbsp;12.&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;11.&nbsp;Configuring
24 GLX in Xinerama</th>
25 </tr>
26 <tr>
27 <td width="20%" align="left"><a accesskey="p" href=
28 "chapter-10.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-12.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;11.&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>The NVIDIA X driver must be used for all X screens in the
88 server.</p>
89 </li>
90 <li>
91 <p>Only the intersection of capabilities across all GPUs will be
92 advertised.</p>
93 <p>The maximum OpenGL viewport size depends on the hardware used,
94 and is described by the following table. If an OpenGL window is
95 larger than the maximum viewport, regions beyond the viewport will
96 be blank.</p>
97 <div class="informaltable">
98 <table summary="(no summary available)" border="0">
99 <colgroup>
100 <col></colgroup>
101 <thead>
102 <tr>
103 <th>OpenGL Viewport Maximums in Xinerama</th>
104 </tr>
105 </thead>
106 </table>
107 <table summary="(no summary available)" border="0">
108 <colgroup>
109 <col>
110 <col></colgroup>
111 <tbody>
112 <tr>
113 <td>GeForce GPUs before GeForce 8:</td>
114 <td>4096 x 4096 pixels</td>
115 </tr>
116 <tr>
117 <td>GeForce 8 and newer GPUs:</td>
118 <td>8192 x 8192 pixels</td>
119 </tr>
120 <tr>
121 <td>Quadro:</td>
122 <td>as large as the Xinerama desktop</td>
123 </tr>
124 </tbody>
125 </table>
126 </div>
127 <p></p>
128 </li>
129 <li>
130 <p>X configuration options that affect GLX operation (e.g.: stereo,
131 overlays) should be set consistently across all X screens in the X
132 server.</p>
133 </li>
134 </ul>
135 </div>
136 <p></p>
137 <p>Known Issues:</p>
138 <div class="itemizedlist">
139 <ul type="disc">
140 <li>
141 <p>Versions of XFree86 prior to 4.5 and versions of X.Org prior to
142 6.8.0 lack the required interfaces to properly implement overlays
143 with the Xinerama extension. On earlier server versions mixing
144 overlays and Xinerama will result in rendering corruption. If you
145 are using the Xinerama extension with overlays, it is recommended
146 that you upgrade to XFree86 4.5, X.Org 6.8.0, or newer.</p>
147 </li>
148 </ul>
149 </div>
150 <p></p>
151 </div>
152 <div class="navfooter">
153 <hr>
154 <table width="100%" summary="Navigation footer">
155 <tr>
156 <td width="40%" align="left"><a accesskey="p" href=
157 "chapter-10.html">Prev</a>&nbsp;</td>
158 <td width="20%" align="center"><a accesskey="u" href=
159 "part-01.html">Up</a></td>
160 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
161 "chapter-12.html">Next</a></td>
162 </tr>
163 <tr>
164 <td width="40%" align="left" valign="top">
165 Chapter&nbsp;10.&nbsp;Configuring TwinView&nbsp;</td>
166 <td width="20%" align="center"><a accesskey="h" href=
167 "index.html">Home</a></td>
168 <td width="40%" align="right" valign="top">
169 &nbsp;Chapter&nbsp;12.&nbsp;Configuring Multiple X Screens on One
170 Card</td>
171 </tr>
172 </table>
173 </div>
174 </body>
175 </html>