mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-01 22:21:13 +00:00
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:
parent
83a0232225
commit
04bb1ac3ef
1 changed files with 29 additions and 18 deletions
|
@ -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 it’s 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`
|
||||||
|
|
Loading…
Reference in a new issue