| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="guestadd-2d">
|
|---|
| 4 | <title>Hardware 2D Video Acceleration for Windows Guests</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions contain experimental hardware
|
|---|
| 9 | 2D video acceleration support for Windows guests.
|
|---|
| 10 | </p>
|
|---|
| 11 | <p>
|
|---|
| 12 | With this feature, if an application such as a video player
|
|---|
| 13 | inside your Windows VM uses 2D video overlays to play a movie
|
|---|
| 14 | clip, then <ph conkeyref="vbox-conkeyref-phrases/product-name"/> will attempt to use your host's video
|
|---|
| 15 | acceleration hardware instead of performing overlay stretching
|
|---|
| 16 | and color conversion in software, which would be slow. This
|
|---|
| 17 | currently works for Windows, Linux and macOS host platforms,
|
|---|
| 18 | provided that your host operating system can make use of 2D
|
|---|
| 19 | video acceleration in the first place.
|
|---|
| 20 | </p>
|
|---|
| 21 | <p>
|
|---|
| 22 | Hardware 2D video acceleration currently has the following
|
|---|
| 23 | preconditions:
|
|---|
| 24 | </p>
|
|---|
| 25 | <ul>
|
|---|
| 26 | <li>
|
|---|
| 27 | <p>
|
|---|
| 28 | Only available for Windows guests, running Windows XP or
|
|---|
| 29 | later.
|
|---|
| 30 | </p>
|
|---|
| 31 | </li>
|
|---|
| 32 | <li>
|
|---|
| 33 | <p>
|
|---|
| 34 | Guest Additions must be installed.
|
|---|
| 35 | </p>
|
|---|
| 36 | </li>
|
|---|
| 37 | <li>
|
|---|
| 38 | <p>
|
|---|
| 39 | Because 2D support is still experimental at this time, it is
|
|---|
| 40 | disabled by default and must be <i>manually
|
|---|
| 41 | enabled</i> in the VM settings. See
|
|---|
| 42 | <xref href="settings-display.dita#settings-display"/>.
|
|---|
| 43 | </p>
|
|---|
| 44 | </li>
|
|---|
| 45 | </ul>
|
|---|
| 46 | <p>
|
|---|
| 47 | Technically, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> implements this by exposing video
|
|---|
| 48 | overlay DirectDraw capabilities in the Guest Additions video
|
|---|
| 49 | driver. The driver sends all overlay commands to the host
|
|---|
| 50 | through a special communication tunnel implemented by
|
|---|
| 51 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/>. On the host side, OpenGL is then used to
|
|---|
| 52 | implement color space transformation and scaling.
|
|---|
| 53 | </p>
|
|---|
| 54 | </body>
|
|---|
| 55 |
|
|---|
| 56 | </topic>
|
|---|
