doc/html/appendix-g.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>Appendix&nbsp;G.&nbsp;VDPAU Support</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-02.html" title=
  13 "Part&nbsp;II.&nbsp;Appendices">
  14 <link rel="prev" href="appendix-f.html" title=
  15 "Appendix&nbsp;F.&nbsp;XvMC Support">
  16 <link rel="next" href="appendix-g-section-02.html" title=
  17 "Performance Levels">
  18 </head>
  19 <body>
  20 <div class="navheader">
  21 <table width="100%" summary="Navigation header">
  22 <tr>
  23 <th colspan="3" align="center">Appendix&nbsp;G.&nbsp;VDPAU
  24 Support</th>
  25 </tr>
  26 <tr>
  27 <td width="20%" align="left"><a accesskey="p" href=
  28 "appendix-f.html">Prev</a>&nbsp;</td>
  29 <th width="60%" align="center">Part&nbsp;II.&nbsp;Appendices</th>
  30 <td width="20%" align="right">&nbsp;<a accesskey="n" href=
  31 "appendix-g-section-02.html">Next</a></td>
  32 </tr>
  33 </table>
  34 <hr></div>
  35 <div class="appendix" lang="en">
  36 <div class="titlepage">
  37 <div>
  38 <div>
  39 <h2 class="title"><a name="vdpausupport" id=
  40 "vdpausupport"></a>Appendix&nbsp;G.&nbsp;VDPAU Support</h2>
  41 </div>
  42 </div>
  43 </div>
  44 <div class="toc">
  45 <p><b>Table of Contents</b></p>
  46 <dl>
  47 <dt><span class="section"><a href=
  48 "appendix-g.html#vdpau-implementation-limits">Implementation
  49 Limits</a></span></dt>
  50 <dd>
  51 <dl>
  52 <dt><span class="section"><a href=
  53 "appendix-g.html#vdpau-implementation-limits-video-surface">VdpVideoSurface</a></span></dt>
  54 <dt><span class="section"><a href=
  55 "appendix-g.html#vdpau-implementation-limits-bitmap-surface">VdpBitmapSurface</a></span></dt>
  56 <dt><span class="section"><a href=
  57 "appendix-g.html#vdpau-implementation-limits-output-surface">VdpOutputSurface</a></span></dt>
  58 <dt><span class="section"><a href=
  59 "appendix-g.html#vdpau-implementation-limits-decoder">VdpDecoder</a></span></dt>
  60 <dt><span class="section"><a href=
  61 "appendix-g.html#vdpau-implementation-limits-video-mixer">VdpVideoMixer</a></span></dt>
  62 <dt><span class="section"><a href=
  63 "appendix-g.html#vdpau-implementation-limits-presentation-queue">VdpPresentationQueue</a></span></dt>
  64 </dl>
  65 </dd>
  66 <dt><span class="section"><a href=
  67 "appendix-g-section-02.html">Performance Levels</a></span></dt>
  68 <dt><span class="section"><a href=
  69 "appendix-g-section-03.html">Getting the Best Performance from the
  70 API</a></span></dt>
  71 <dt><span class="section"><a href=
  72 "appendix-g-section-04.html">Additional Notes</a></span></dt>
  73 <dt><span class="section"><a href=
  74 "appendix-g-section-05.html">Debugging and Tracing</a></span></dt>
  75 </dl>
  76 </div>
  77 <p>This release includes support for the Video Decode and
  78 Presentation API for Unix-like systems (VDPAU) on most GeForce 8
  79 series and newer add-in cards, as well as motherboard chipsets with
  80 integrated graphics that have PureVideo support based on these
  81 GPUs.</p>
  82 <div class="section" lang="en">
  83 <div class="titlepage">
  84 <div>
  85 <div>
  86 <h2 class="title" style="clear: both"><a name=
  87 "vdpau-implementation-limits" id=
  88 "vdpau-implementation-limits"></a>Implementation Limits</h2>
  89 </div>
  90 </div>
  91 </div>
  92 <p>VDPAU is specified as a generic API - the choice of which
  93 features to support, and performance levels of those features, is
  94 left up to individual implementations. The details of NVIDIA's
  95 implementation are provided below.</p>
  96 <div class="section" lang="en">
  97 <div class="titlepage">
  98 <div>
  99 <div>
 100 <h3 class="title"><a name=
 101 "vdpau-implementation-limits-video-surface" id=
 102 "vdpau-implementation-limits-video-surface"></a>VdpVideoSurface</h3>
 103 </div>
 104 </div>
 105 </div>
 106 <p>The maximum supported resolution is 4096x4096.</p>
 107 <p>The following surface formats and get-/put-bits combinations are
 108 supported:</p>
 109 <div class="itemizedlist">
 110 <ul type="disc">
 111 <li>
 112 <p>VDP_CHROMA_TYPE_420 (Supported get-/put-bits formats are
 113 VDP_YCBCR_FORMAT_NV12, VDP_YCBCR_FORMAT_YV12)</p>
 114 </li>
 115 <li>
 116 <p>VDP_CHROMA_TYPE_422 (Supported get-/put-bits formats are
 117 VDP_YCBCR_FORMAT_UYVY, VDP_YCBCR_FORMAT_YUYV)</p>
 118 </li>
 119 </ul>
 120 </div>
 121 <p></p>
 122 </div>
 123 <div class="section" lang="en">
 124 <div class="titlepage">
 125 <div>
 126 <div>
 127 <h3 class="title"><a name=
 128 "vdpau-implementation-limits-bitmap-surface" id=
 129 "vdpau-implementation-limits-bitmap-surface"></a>VdpBitmapSurface</h3>
 130 </div>
 131 </div>
 132 </div>
 133 <p>The maximum supported resolution is 8192x8192.</p>
 134 <p>The following surface formats are supported:</p>
 135 <div class="itemizedlist">
 136 <ul type="disc">
 137 <li>
 138 <p>VDP_RGBA_FORMAT_B8G8R8A8</p>
 139 </li>
 140 <li>
 141 <p>VDP_RGBA_FORMAT_R8G8B8A8</p>
 142 </li>
 143 <li>
 144 <p>VDP_RGBA_FORMAT_B10G10R10A2</p>
 145 </li>
 146 <li>
 147 <p>VDP_RGBA_FORMAT_R10G10B10A2</p>
 148 </li>
 149 <li>
 150 <p>VDP_RGBA_FORMAT_A8</p>
 151 </li>
 152 </ul>
 153 </div>
 154 <p></p>
 155 <p>Note that VdpBitmapSurfaceCreate's frequently_accessed parameter
 156 directly controls whether the bitmap data will be placed into video
 157 RAM (VDP_TRUE) or system memory (VDP_FALSE). Note that if the
 158 bitmap data cannot be placed into video RAM when requested due to
 159 resource constraints, the implementation will automatically fall
 160 back to placing the data into system RAM.</p>
 161 </div>
 162 <div class="section" lang="en">
 163 <div class="titlepage">
 164 <div>
 165 <div>
 166 <h3 class="title"><a name=
 167 "vdpau-implementation-limits-output-surface" id=
 168 "vdpau-implementation-limits-output-surface"></a>VdpOutputSurface</h3>
 169 </div>
 170 </div>
 171 </div>
 172 <p>The maximum supported resolution is 8192x8192.</p>
 173 <p>The following surface formats are supported:</p>
 174 <div class="itemizedlist">
 175 <ul type="disc">
 176 <li>
 177 <p>VDP_RGBA_FORMAT_B8G8R8A8</p>
 178 </li>
 179 <li>
 180 <p>VDP_RGBA_FORMAT_R10G10B10A2</p>
 181 </li>
 182 </ul>
 183 </div>
 184 <p></p>
 185 <p>For all surface formats, the following get-/put-bits indexed
 186 formats are supported:</p>
 187 <div class="itemizedlist">
 188 <ul type="disc">
 189 <li>
 190 <p>VDP_INDEXED_FORMAT_A4I4</p>
 191 </li>
 192 <li>
 193 <p>VDP_INDEXED_FORMAT_I4A4</p>
 194 </li>
 195 <li>
 196 <p>VDP_INDEXED_FORMAT_A8I8</p>
 197 </li>
 198 <li>
 199 <p>VDP_INDEXED_FORMAT_I8A8</p>
 200 </li>
 201 </ul>
 202 </div>
 203 <p></p>
 204 <p>For all surface formats, the following get-/put-bits YCbCr
 205 formats are supported:</p>
 206 <div class="itemizedlist">
 207 <ul type="disc">
 208 <li>
 209 <p>VDP_YCBCR_FORMAT_Y8U8V8A8</p>
 210 </li>
 211 <li>
 212 <p>VDP_YCBCR_FORMAT_V8U8Y8A8</p>
 213 </li>
 214 </ul>
 215 </div>
 216 <p></p>
 217 </div>
 218 <div class="section" lang="en">
 219 <div class="titlepage">
 220 <div>
 221 <div>
 222 <h3 class="title"><a name="vdpau-implementation-limits-decoder" id=
 223 "vdpau-implementation-limits-decoder"></a>VdpDecoder</h3>
 224 </div>
 225 </div>
 226 </div>
 227 <p>In all cases, VdpDecoder objects solely support 8-bit 4:2:0
 228 streams, and only support writing to VDP_CHROMA_TYPE_420
 229 surfaces.</p>
 230 <p>The exact set of supported VdpDecoderProfile values depends on
 231 the GPU in use. <a href="appendix-a.html" title=
 232 "Appendix&nbsp;A.&nbsp;Supported NVIDIA GPU Products">Appendix&nbsp;A,
 233 <i>Supported NVIDIA GPU Products</i></a> lists which GPUs support
 234 which video feature set. An explanation of each video feature set
 235 may be found below. When reading these lists, please note that
 236 VC1_SIMPLE and VC1_MAIN may be referred to as WMV, WMV3, or WMV9 in
 237 other contexts. Partial acceleration means that VLD (bitstream)
 238 decoding is performed on the CPU, with the GPU performing IDCT and
 239 motion compensation. Complete acceleration means that the GPU
 240 performs all of VLD, IDCT, and motion compensation.</p>
 241 <div class="section" lang="en">
 242 <div class="titlepage">
 243 <div>
 244 <div>
 245 <h4 class="title"><a name="id2658249" id="id2658249"></a>VDPAU
 246 Feature Set A</h4>
 247 </div>
 248 </div>
 249 </div>
 250 <p>GPUs with VDPAU feature set A support at least the following
 251 VdpDecoderProfile values, and associated limits:</p>
 252 <div class="itemizedlist">
 253 <ul type="disc">
 254 <li>
 255 <p>VDP_DECODER_PROFILE_MPEG1, VDP_DECODER_PROFILE_MPEG2_SIMPLE,
 256 VDP_DECODER_PROFILE_MPEG2_MAIN:</p>
 257 <div class="itemizedlist">
 258 <ul type="circle">
 259 <li>
 260 <p>Partial acceleration.</p>
 261 </li>
 262 <li>
 263 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 264 </li>
 265 <li>
 266 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 267 </li>
 268 <li>
 269 <p>Maximum macroblocks: 8192</p>
 270 </li>
 271 </ul>
 272 </div>
 273 <p></p>
 274 </li>
 275 <li>
 276 <p>VDP_DECODER_PROFILE_H264_MAIN,
 277 VDP_DECODER_PROFILE_H264_HIGH:</p>
 278 <div class="itemizedlist">
 279 <ul type="circle">
 280 <li>
 281 <p>Complete acceleration.</p>
 282 </li>
 283 <li>
 284 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 285 </li>
 286 <li>
 287 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 288 </li>
 289 <li>
 290 <p>Maximum macroblocks: 8192</p>
 291 </li>
 292 </ul>
 293 </div>
 294 <p></p>
 295 </li>
 296 <li>
 297 <p>VDP_DECODER_PROFILE_VC1_SIMPLE, VDP_DECODER_PROFILE_VC1_MAIN,
 298 VDP_DECODER_PROFILE_VC1_ADVANCED:</p>
 299 <div class="itemizedlist">
 300 <ul type="circle">
 301 <li>
 302 <p>Partial acceleration.</p>
 303 </li>
 304 <li>
 305 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 306 </li>
 307 <li>
 308 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 309 </li>
 310 <li>
 311 <p>Maximum macroblocks: 8190</p>
 312 </li>
 313 </ul>
 314 </div>
 315 <p></p>
 316 </li>
 317 </ul>
 318 </div>
 319 <p></p>
 320 </div>
 321 <div class="section" lang="en">
 322 <div class="titlepage">
 323 <div>
 324 <div>
 325 <h4 class="title"><a name="id2658406" id="id2658406"></a>VDPAU
 326 Feature Set B</h4>
 327 </div>
 328 </div>
 329 </div>
 330 <p>GPUs with VDPAU feature set B support at least the following
 331 VdpDecoderProfile values, and associated limits:</p>
 332 <div class="itemizedlist">
 333 <ul type="disc">
 334 <li>
 335 <p>VDP_DECODER_PROFILE_MPEG1, VDP_DECODER_PROFILE_MPEG2_SIMPLE,
 336 VDP_DECODER_PROFILE_MPEG2_MAIN:</p>
 337 <div class="itemizedlist">
 338 <ul type="circle">
 339 <li>
 340 <p>Complete acceleration.</p>
 341 </li>
 342 <li>
 343 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 344 </li>
 345 <li>
 346 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 347 </li>
 348 <li>
 349 <p>Maximum macroblocks: 8192</p>
 350 </li>
 351 </ul>
 352 </div>
 353 <p></p>
 354 </li>
 355 <li>
 356 <p>VDP_DECODER_PROFILE_H264_MAIN,
 357 VDP_DECODER_PROFILE_H264_HIGH:</p>
 358 <div class="itemizedlist">
 359 <ul type="circle">
 360 <li>
 361 <p>Complete acceleration.</p>
 362 </li>
 363 <li>
 364 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 365 </li>
 366 <li>
 367 <p>Maximum width: 127 macroblocks (2032 pixels).</p>
 368 </li>
 369 <li>
 370 <p>Maximum height: 128 macroblocks (2048 pixels).</p>
 371 </li>
 372 <li>
 373 <p>Maximum macroblocks: 8190</p>
 374 </li>
 375 </ul>
 376 </div>
 377 <p></p>
 378 </li>
 379 <li>
 380 <p>VDP_DECODER_PROFILE_VC1_SIMPLE, VDP_DECODER_PROFILE_VC1_MAIN,
 381 VDP_DECODER_PROFILE_VC1_ADVANCED:</p>
 382 <div class="itemizedlist">
 383 <ul type="circle">
 384 <li>
 385 <p>Complete acceleration.</p>
 386 </li>
 387 <li>
 388 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 389 </li>
 390 <li>
 391 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 392 </li>
 393 <li>
 394 <p>Maximum macroblocks: 8190</p>
 395 </li>
 396 </ul>
 397 </div>
 398 <p></p>
 399 </li>
 400 </ul>
 401 </div>
 402 <p></p>
 403 </div>
 404 <div class="section" lang="en">
 405 <div class="titlepage">
 406 <div>
 407 <div>
 408 <h4 class="title"><a name="id2658502" id="id2658502"></a>VDPAU
 409 Feature Set C</h4>
 410 </div>
 411 </div>
 412 </div>
 413 <p>GPUs with VDPAU feature set C support at least the following
 414 VdpDecoderProfile values, and associated limits:</p>
 415 <div class="itemizedlist">
 416 <ul type="disc">
 417 <li>
 418 <p>VDP_DECODER_PROFILE_MPEG1, VDP_DECODER_PROFILE_MPEG2_SIMPLE,
 419 VDP_DECODER_PROFILE_MPEG2_MAIN:</p>
 420 <div class="itemizedlist">
 421 <ul type="circle">
 422 <li>
 423 <p>Complete acceleration.</p>
 424 </li>
 425 <li>
 426 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 427 </li>
 428 <li>
 429 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 430 </li>
 431 <li>
 432 <p>Maximum macroblocks: 8192</p>
 433 </li>
 434 </ul>
 435 </div>
 436 <p></p>
 437 </li>
 438 <li>
 439 <p>VDP_DECODER_PROFILE_H264_MAIN,
 440 VDP_DECODER_PROFILE_H264_HIGH:</p>
 441 <div class="itemizedlist">
 442 <ul type="circle">
 443 <li>
 444 <p>Complete acceleration.</p>
 445 </li>
 446 <li>
 447 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 448 </li>
 449 <li>
 450 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 451 </li>
 452 <li>
 453 <p>Maximum macroblocks: 8192</p>
 454 </li>
 455 </ul>
 456 </div>
 457 <p></p>
 458 </li>
 459 <li>
 460 <p>VDP_DECODER_PROFILE_VC1_SIMPLE, VDP_DECODER_PROFILE_VC1_MAIN,
 461 VDP_DECODER_PROFILE_VC1_ADVANCED:</p>
 462 <div class="itemizedlist">
 463 <ul type="circle">
 464 <li>
 465 <p>Complete acceleration.</p>
 466 </li>
 467 <li>
 468 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 469 </li>
 470 <li>
 471 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 472 </li>
 473 <li>
 474 <p>Maximum macroblocks: 8190</p>
 475 </li>
 476 </ul>
 477 </div>
 478 <p></p>
 479 </li>
 480 <li>
 481 <p>VDP_DECODER_PROFILE_MPEG4_PART2_SP,
 482 VDP_DECODER_PROFILE_MPEG4_PART2_ASP,
 483 VDP_DECODER_PROFILE_DIVX4_QMOBILE,
 484 VDP_DECODER_PROFILE_DIVX4_MOBILE,
 485 VDP_DECODER_PROFILE_DIVX4_HOME_THEATER,
 486 VDP_DECODER_PROFILE_DIVX4_HD_1080P,
 487 VDP_DECODER_PROFILE_DIVX5_QMOBILE,
 488 VDP_DECODER_PROFILE_DIVX5_MOBILE,
 489 VDP_DECODER_PROFILE_DIVX5_HOME_THEATER,
 490 VDP_DECODER_PROFILE_DIVX5_HD_1080P</p>
 491 <div class="itemizedlist">
 492 <ul type="circle">
 493 <li>
 494 <p>Complete acceleration.</p>
 495 </li>
 496 <li>
 497 <p>Minimum width or height: 3 macroblocks (48 pixels).</p>
 498 </li>
 499 <li>
 500 <p>Maximum width or height: 128 macroblocks (2048 pixels).</p>
 501 </li>
 502 <li>
 503 <p>Maximum macroblocks: 8192</p>
 504 </li>
 505 </ul>
 506 </div>
 507 <p>The following features are currently not supported:</p>
 508 <div class="itemizedlist">
 509 <ul type="circle">
 510 <li>
 511 <p>GMC (Global Motion Compensation)</p>
 512 </li>
 513 <li>
 514 <p>Data partitioning</p>
 515 </li>
 516 <li>
 517 <p>reversible VLC</p>
 518 </li>
 519 </ul>
 520 </div>
 521 <p></p>
 522 </li>
 523 </ul>
 524 </div>
 525 <p></p>
 526 <p>These GPUs also support
 527 VDP_VIDEO_MIXER_FEATURE_HIGH_QUALITY_SCALING_L1.</p>
 528 </div>
 529 <div class="section" lang="en">
 530 <div class="titlepage">
 531 <div>
 532 <div>
 533 <h4 class="title"><a name="id2658709" id="id2658709"></a>VDPAU
 534 Features Note 1</h4>
 535 </div>
 536 </div>
 537 </div>
 538 <p>GPUs with this note may not support H.264 streams with the
 539 following widths: 49, 54, 59, 64, 113, 118, 123, 128 macroblocks
 540 (769-784, 849-864, 929-944, 1009-1024, 1793-1808, 1873-1888,
 541 1953-1968, 2033-2048 pixels).</p>
 542 </div>
 543 </div>
 544 <div class="section" lang="en">
 545 <div class="titlepage">
 546 <div>
 547 <div>
 548 <h3 class="title"><a name="vdpau-implementation-limits-video-mixer"
 549 id="vdpau-implementation-limits-video-mixer"></a>VdpVideoMixer</h3>
 550 </div>
 551 </div>
 552 </div>
 553 <p>The maximum supported resolution is 4096x4096.</p>
 554 <p>The video mixer supports all video and output surface
 555 resolutions and formats that the implementation supports.</p>
 556 <p>The video mixer supports at most 4 auxiliary layers.</p>
 557 <p>The following features are supported:</p>
 558 <div class="itemizedlist">
 559 <ul type="disc">
 560 <li>
 561 <p>VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL</p>
 562 </li>
 563 <li>
 564 <p>VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL_SPATIAL</p>
 565 </li>
 566 <li>
 567 <p>VDP_VIDEO_MIXER_FEATURE_INVERSE_TELECINE</p>
 568 </li>
 569 <li>
 570 <p>VDP_VIDEO_MIXER_FEATURE_NOISE_REDUCTION</p>
 571 </li>
 572 <li>
 573 <p>VDP_VIDEO_MIXER_FEATURE_SHARPNESS</p>
 574 </li>
 575 <li>
 576 <p>VDP_VIDEO_MIXER_FEATURE_LUMA_KEY</p>
 577 </li>
 578 </ul>
 579 </div>
 580 <p></p>
 581 <p>In order for either VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL
 582 or VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL_SPATIAL to operate
 583 correctly, the application must supply at least 2 past and 1 future
 584 fields to each VdpMixerRender call. If those fields are not
 585 provided, the VdpMixer will fall back to bob de-interlacing.</p>
 586 <p>Both regular de-interlacing and half-rate de-interlacing are
 587 supported. Both have the same requirements in terms of the number
 588 of past/future fields required. Both modes should produce
 589 equivalent results.</p>
 590 <p>In order for VDP_VIDEO_MIXER_FEATURE_INVERSE_TELECINE to have
 591 any effect, one of VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL or
 592 VDP_VIDEO_MIXER_FEATURE_DEINTERLACE_TEMPORAL_SPATIAL must be
 593 requested and enabled. Inverse telecine has the same requirement on
 594 the minimum number of past/future fields that must be provided.
 595 Inverse telecine will not operate when "half-rate" de-interlacing
 596 is used.</p>
 597 <p>While is is possible to apply de-interlacing algorithms to
 598 progressive streams using the techniques outlined in the VDPAU
 599 documentation, NVIDIA does not recommend doing so. One is likely to
 600 introduce more artifacts due to the inverse telecine process than
 601 are removed by detection of bad edits etc.</p>
 602 </div>
 603 <div class="section" lang="en">
 604 <div class="titlepage">
 605 <div>
 606 <div>
 607 <h3 class="title"><a name=
 608 "vdpau-implementation-limits-presentation-queue" id=
 609 "vdpau-implementation-limits-presentation-queue"></a>VdpPresentationQueue</h3>
 610 </div>
 611 </div>
 612 </div>
 613 <p>The resolution of VdpTime is approximately 10 nanoseconds. At
 614 some arbitrary point during system startup, the initial value of
 615 this clock is synchronized to the system's real-time clock, as
 616 represented by nanoseconds since since Jan 1, 1970. However, no
 617 attempt is made to keep the two time-bases synchronized after this
 618 point. Divergence can and will occur.</p>
 619 <p>NVIDIA's VdpPresentationQueue supports two mechanisms for
 620 displaying surfaces; overlay and blit-based. The overlay path will
 621 be used wherever possible, with the blit path acting as a more
 622 general fallback. At present, the selection of overlay v.s. blit
 623 path is made at the time of presentation queue creation.</p>
 624 <p>The following conditions or system configurations will prevent
 625 usage of the overlay path:</p>
 626 <div class="itemizedlist">
 627 <ul type="disc">
 628 <li>
 629 <p>Overlay hardware already in use, e.g. by another VDPAU, GL, or
 630 X11 application, or by SDI output.</p>
 631 </li>
 632 <li>
 633 <p>SLI or Multi-GPU enabled on the given X screen.</p>
 634 </li>
 635 <li>
 636 <p>Desktop rotation enabled on the given screen.</p>
 637 </li>
 638 <li>
 639 <p>X composite extension enabled on the given screen. Note that
 640 simply having the extension enabled is enough to prevent overlay
 641 usage; running an actual compositing manager is not required.</p>
 642 </li>
 643 <li>
 644 <p>The environment variable VDPAU_NVIDIA_NO_OVERLAY is set to a
 645 string representation of a non-zero integer.</p>
 646 </li>
 647 <li>
 648 <p>The driver determines that the performance requirements of
 649 overlay usage cannot be met by the current hardware
 650 configuration.</p>
 651 </li>
 652 </ul>
 653 </div>
 654 <p></p>
 655 <p>Both the overlay and blit path sync to VBLANK.</p>
 656 <p>When TwinView is enabled, the blit path can only sync to one of
 657 the display devices; this may cause tearing corruption on the
 658 display device to which VDPAU is not syncing. You can use the
 659 environment variable VDPAU_NVIDIA_SYNC_DISPLAY_DEVICE to specify
 660 the display device to which VDPAU should sync. You should set this
 661 environment variable to the name of a display device; for example
 662 "CRT-1". Look for the line "Connected display device(s):" in your X
 663 log file for a list of the display devices present and their names.
 664 You may also find it useful to review <a href="chapter-12.html"
 665 title="Chapter&nbsp;12.&nbsp;Configuring TwinView">Chapter&nbsp;12,
 666 <i>Configuring TwinView</i></a> "Configuring Twinview" and the
 667 section on Ensuring Identical Mode Timings in <a href=
 668 "chapter-18.html" title=
 669 "Chapter&nbsp;18.&nbsp;Programming Modes">Chapter&nbsp;18,
 670 <i>Programming Modes</i></a>.</p>
 671 </div>
 672 </div>
 673 </div>
 674 <div class="navfooter">
 675 <hr>
 676 <table width="100%" summary="Navigation footer">
 677 <tr>
 678 <td width="40%" align="left"><a accesskey="p" href=
 679 "appendix-f.html">Prev</a>&nbsp;</td>
 680 <td width="20%" align="center"><a accesskey="u" href=
 681 "part-02.html">Up</a></td>
 682 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
 683 "appendix-g-section-02.html">Next</a></td>
 684 </tr>
 685 <tr>
 686 <td width="40%" align="left" valign="top">
 687 Appendix&nbsp;F.&nbsp;XvMC Support&nbsp;</td>
 688 <td width="20%" align="center"><a accesskey="h" href=
 689 "index.html">Home</a></td>
 690 <td width="40%" align="right" valign="top">&nbsp;Performance
 691 Levels</td>
 692 </tr>
 693 </table>
 694 </div>
 695 </body>
 696 </html>