docs: Update for Windows specific parts

* glimagesink is not a recommended one on Windows
* Remove directdrawsink section
* d3dvideosink is legacy and should not be recommended
* Add d3d11videosink part
* directsoundsink should be deprecated
* Add wasapisink/wasapi2sink part

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2144>
This commit is contained in:
Seungha Yang 2022-04-10 04:11:02 +09:00
parent 83a0232225
commit 04bb1ac3ef

View file

@ -20,7 +20,8 @@ This video sink is based on
and filtering of the scaled image to alleviate aliasing. It implements and filtering of the scaled image to alleviate aliasing. It implements
the VideoOverlay interface, so the video window can be re-parented the VideoOverlay interface, so the video window can be re-parented
(embedded inside other windows). This is the video sink recommended on (embedded inside other windows). This is the video sink recommended on
most platforms. In particular, on Android and iOS, it is the only most platforms except for Windows (On Windows, `d3d11videosink` is recommended).
In particular, on Android and iOS, it is the only
available video sink. It can be decomposed into available video sink. It can be decomposed into
`glupload ! glcolorconvert ! glimagesinkelement` to insert further OpenGL `glupload ! glcolorconvert ! glimagesinkelement` to insert further OpenGL
hardware accelerated processing into the pipeline. hardware accelerated processing into the pipeline.
@ -73,14 +74,24 @@ This is the only audio sink available to GStreamer on Mac OS X.
## Windows ## Windows
### `directdrawsink` ### `d3d11videosink`
This is the oldest of the Windows video sinks, based on [Direct This video sink is based on [Direct3D11](https://en.wikipedia.org/wiki/Direct3D#Direct3D_11)
Draw](http://en.wikipedia.org/wiki/DirectDraw). It requires DirectX 7, and is the recommended element on Windows.
so it is available on almost every current Windows platform. It supports It supports VideoOverlay interface and rescaling/colorspace conversion
rescaling and filtering of the scaled image to alleviate aliasing. in [zero-copy](https://en.wikipedia.org/wiki/Zero-copy) manner. This element
is the most performant and featureful video sink element on Windows.
### `dshowvideosink` ### `d3dvideosink`
This video sink is based on
[Direct3D9](https://en.wikipedia.org/wiki/Direct3D#Direct3D_9).
It supports rescaling and filtering of the scaled image to alleviate aliasing.
It implements the VideoOverlay interface, so the video window can be re-parented (embedded inside other windows).
This element is not recommended for applications targetting Windows 8 or more recent.
### `dshowvideosink (deprecated)`
This video sink is based on [Direct This video sink is based on [Direct
Show](http://en.wikipedia.org/wiki/Direct_Show). It can use different Show](http://en.wikipedia.org/wiki/Direct_Show). It can use different
@ -92,21 +103,21 @@ or
EVR only being available on Windows Vista or more recent. It supports EVR only being available on Windows Vista or more recent. It supports
rescaling and filtering of the scaled image to alleviate aliasing. It rescaling and filtering of the scaled image to alleviate aliasing. It
implements the VideoOverlay interface, so the video window can be implements the VideoOverlay interface, so the video window can be
re-parented (embedded inside other windows). re-parented (embedded inside other windows). This element is not recommended
in most cases.
### `d3dvideosink` ### `wasapisink` and `wasapi2sink`
This video sink is based on Those elements are the default audio sink elements on Windows, based on
[Direct3D](http://en.wikipedia.org/wiki/Direct3D) and its the most [WASAPI](https://docs.microsoft.com/en-us/windows/win32/coreaudio/wasapi),
recent Windows video sink. It supports rescaling and filtering of the which is available on Vista or more recent. Note that `wasapi2sink` is
scaled image to alleviate aliasing. It implements the VideoOverlay a replacement of `wasapisink` and `wasapi2sink` is default for Windows 8 or
interface, so the video window can be re-parented (embedded inside other more recent. Otherwise `wasapisink` will be default audio sink element.
windows).
### `directsoundsink` ### `directsoundsink (deprecated)`
This is the default audio sink for Windows, based on [Direct This audio sink element is based on
Sound](http://en.wikipedia.org/wiki/DirectSound), which is available in [DirectSound](http://en.wikipedia.org/wiki/DirectSound), which is available in
all Windows versions. all Windows versions.
### `dshowdecwrapper` ### `dshowdecwrapper`