import NVIDIA-FreeBSD-x86-180.29
[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 TV-Out</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 Multiple X Screens on One Card">
16 <link rel="next" href="chapter-14.html" title=
17 "Chapter&nbsp;14.&nbsp;Using the XRandR Extension">
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 TV-Out</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="configtvout" id=
41 "configtvout"></a>Chapter&nbsp;13.&nbsp;Configuring TV-Out</h2>
42 </div>
43 </div>
44 </div>
45 <p>NVIDIA GPU-based graphics cards with a TV-Out connector can use
46 a television as another display device (the same way that it would
47 use a CRT or digital flat panel). The TV can be used by itself, or
48 in conjunction with another display device in a TwinView or
49 multiple X screen configuration. If a TV is the only display device
50 connected to your graphics card, it will be used as the primary
51 display when you boot your system (i.e. the console will come up on
52 the TV just as if it were a CRT).</p>
53 <p>The NVIDIA X driver populates the mode pool for the TV with all
54 the mode sizes that the driver supports with the given TV standard
55 and the TV encoder on the graphics card. These modes are given
56 names that correspond to their resolution; e.g., "800x600".</p>
57 <p>Because these TV modes only depend on the TV encoder and the TV
58 standard, TV modes do not go through normal mode validation. The X
59 configuration options HorizSync and VertRefresh are not used for TV
60 mode validation.</p>
61 <p>Additionally, the NVIDIA driver contains a hardcoded list of
62 mode sizes that it can drive for each combination of TV encoder and
63 TV standard. Therefore, custom modelines in your X configuration
64 file are ignored for TVs.</p>
65 <p>To use your TV with X, there are several relevant X
66 configuration options:</p>
67 <div class="itemizedlist">
68 <ul type="disc">
69 <li>
70 <p>The Modes in the screen section of your X configuration file;
71 you can use these to request any of the modes in the mode pool
72 which the X driver created for this combination of TV standard and
73 TV encoder. Examples include "640x480" and "800x600". If in doubt,
74 use "nvidia-auto-select".</p>
75 </li>
76 <li>
77 <p>The "TVStandard" option should be added to your screen section;
78 valid values are:</p>
79 <div class="informaltable">
80 <table summary="(no summary available)" border="0">
81 <colgroup>
82 <col>
83 <col></colgroup>
84 <thead>
85 <tr>
86 <th>TVStandard</th>
87 <th>Description</th>
88 </tr>
89 </thead>
90 <tbody>
91 <tr>
92 <td>"PAL-B"</td>
93 <td>used in Belgium, Denmark, Finland, Germany, Guinea, Hong Kong,
94 India, Indonesia, Italy, Malaysia, The Netherlands, Norway,
95 Portugal, Singapore, Spain, Sweden, and Switzerland</td>
96 </tr>
97 <tr>
98 <td>"PAL-D"</td>
99 <td>used in China and North Korea</td>
100 </tr>
101 <tr>
102 <td>"PAL-G"</td>
103 <td>used in Denmark, Finland, Germany, Italy, Malaysia, The
104 Netherlands, Norway, Portugal, Spain, Sweden, and Switzerland</td>
105 </tr>
106 <tr>
107 <td>"PAL-H"</td>
108 <td>used in Belgium</td>
109 </tr>
110 <tr>
111 <td>"PAL-I"</td>
112 <td>used in Hong Kong and The United Kingdom</td>
113 </tr>
114 <tr>
115 <td>"PAL-K1"</td>
116 <td>used in Guinea</td>
117 </tr>
118 <tr>
119 <td>"PAL-M"</td>
120 <td>used in Brazil</td>
121 </tr>
122 <tr>
123 <td>"PAL-N"</td>
124 <td>used in France, Paraguay, and Uruguay</td>
125 </tr>
126 <tr>
127 <td>"PAL-NC"</td>
128 <td>used in Argentina</td>
129 </tr>
130 <tr>
131 <td>"NTSC-J"</td>
132 <td>used in Japan</td>
133 </tr>
134 <tr>
135 <td>"NTSC-M"</td>
136 <td>used in Canada, Chile, Colombia, Costa Rica, Ecuador, Haiti,
137 Honduras, Mexico, Panama, Puerto Rico, South Korea, Taiwan, United
138 States of America, and Venezuela</td>
139 </tr>
140 <tr>
141 <td>"HD480i"</td>
142 <td>480 line interlaced</td>
143 </tr>
144 <tr>
145 <td>"HD480p"</td>
146 <td>480 line progressive</td>
147 </tr>
148 <tr>
149 <td>"HD720p"</td>
150 <td>720 line progressive</td>
151 </tr>
152 <tr>
153 <td>"HD1080i"</td>
154 <td>1080 line interlaced</td>
155 </tr>
156 <tr>
157 <td>"HD1080p"</td>
158 <td>1080 line progressive</td>
159 </tr>
160 <tr>
161 <td>"HD576i"</td>
162 <td>576 line interlace</td>
163 </tr>
164 <tr>
165 <td>"HD576p"</td>
166 <td>576 line progressive</td>
167 </tr>
168 </tbody>
169 </table>
170 </div>
171 <p>The line in your X config file should be something like:</p>
172 <pre class="screen">
173     Option "TVStandard" "NTSC-M"
174 </pre>
175 <p>If you do not specify a TVStandard, or you specify an invalid
176 value, the default "NTSC-M" will be used. Note: if your country is
177 not in the above list, select the country closest to your
178 location.</p>
179 </li>
180 <li>
181 <p>The "UseDisplayDevice" option can be used if there are multiple
182 display devices connected, and you want the connected TV to be used
183 instead of the connected CRTs and/or DFPs. E.g.,</p>
184 <pre class="screen">
185     Option "UseDisplayDevice" "TV"
186 </pre>
187 <p>Using the "UseDisplayDevice" option, rather than the
188 "ConnectedMonitor" option, is recommended.</p>
189 </li>
190 <li>
191 <p>The "TVOutFormat" option can be used to force the output format.
192 Without this option, the driver autodetects the output format.
193 Unfortunately, it does not always do this correctly. The output
194 format can be forced with the "TVOutFormat" option; valid values
195 are:</p>
196 <div class="informaltable">
197 <table summary="(no summary available)" border="0">
198 <colgroup>
199 <col>
200 <col></colgroup>
201 <thead>
202 <tr>
203 <th>TVOutFormat</th>
204 <th>Description</th>
205 <th>Supported TV standards</th>
206 </tr>
207 </thead>
208 <tbody>
209 <tr>
210 <td>"AUTOSELECT"</td>
211 <td>The driver autodetects the output format (default value).</td>
212 <td>PAL, NTSC, HD</td>
213 </tr>
214 <tr>
215 <td>"COMPOSITE"</td>
216 <td>Force Composite output format</td>
217 <td>PAL, NTSC</td>
218 </tr>
219 <tr>
220 <td>"SVIDEO"</td>
221 <td>Force S-Video output format</td>
222 <td>PAL, NTSC</td>
223 </tr>
224 <tr>
225 <td>"COMPONENT"</td>
226 <td>Force Component output format, also called YPbPr</td>
227 <td>HD</td>
228 </tr>
229 <tr>
230 <td>"SCART"</td>
231 <td>Force Scart output format, also called Peritel</td>
232 <td>PAL, NTSC</td>
233 </tr>
234 </tbody>
235 </table>
236 </div>
237 <p>The line in your X config file should be something like:</p>
238 <pre class="screen">
239     Option "TVOutFormat" "SVIDEO"
240 </pre>
241 <p></p>
242 </li>
243 <li>
244 <p>The "TVOverScan" option can be used to enable Overscan, when the
245 TV encoder supports it. Valid values are decimal values in the
246 range 1.0 (which means overscan as much as possible: make the image
247 as large as possible) and 0.0 (which means disable overscanning:
248 make the image as small as possible). Overscanning is disabled
249 (0.0) by default.</p>
250 </li>
251 </ul>
252 </div>
253 <p>The NVIDIA X driver may not restore the console correctly with
254 XFree86 versions older than 4.3 when the console is a TV. This is
255 due to binary incompatibilities between XFree86 int10 modules. If
256 you use a TV as your console it is recommended that you upgrade to
257 XFree86 4.3 or later.</p>
258 </div>
259 <div class="navfooter">
260 <hr>
261 <table width="100%" summary="Navigation footer">
262 <tr>
263 <td width="40%" align="left"><a accesskey="p" href=
264 "chapter-12.html">Prev</a>&nbsp;</td>
265 <td width="20%" align="center"><a accesskey="u" href=
266 "part-01.html">Up</a></td>
267 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
268 "chapter-14.html">Next</a></td>
269 </tr>
270 <tr>
271 <td width="40%" align="left" valign="top">
272 Chapter&nbsp;12.&nbsp;Configuring Multiple X Screens on One
273 Card&nbsp;</td>
274 <td width="20%" align="center"><a accesskey="h" href=
275 "index.html">Home</a></td>
276 <td width="40%" align="right" valign="top">
277 &nbsp;Chapter&nbsp;14.&nbsp;Using the XRandR Extension</td>
278 </tr>
279 </table>
280 </div>
281 </body>
282 </html>