mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-19 23:06:49 +00:00
docs: update for 1.0
This commit is contained in:
parent
579458f613
commit
370d336e9e
3 changed files with 12 additions and 12 deletions
|
@ -1,11 +1,9 @@
|
|||
===============================================================
|
||||
Subtitle overlays, hardware-accelerated decoding and playbin2
|
||||
Subtitle overlays, hardware-accelerated decoding and playbin
|
||||
===============================================================
|
||||
|
||||
Status: EARLY DRAFT / BRAINSTORMING
|
||||
|
||||
The following text will use "playbin" synonymous with "playbin2".
|
||||
|
||||
=== 1. Background ===
|
||||
|
||||
Subtitles can be muxed in containers or come from an external source.
|
||||
|
@ -30,7 +28,7 @@ us to allocate and blend whole pictures (1920x1080 AYUV = 8MB,
|
|||
is only a small rectangle at the bottom. This wastes memory and CPU.
|
||||
We could do something better by introducing a new format that only
|
||||
encodes the region(s) of interest, but we don't have such a format yet, and
|
||||
are not necessarily keen to rewrite this part of the logic in playbin2
|
||||
are not necessarily keen to rewrite this part of the logic in playbin
|
||||
at this point - and we can't change existing elements' behaviour, so would
|
||||
need to introduce new elements for this.
|
||||
|
||||
|
@ -58,7 +56,7 @@ map the data back into system memory (and then later back to the GPU).
|
|||
It's much better to upload the much smaller encoded data to the GPU/DSP
|
||||
and then leave it there until rendered.
|
||||
|
||||
Currently playbin2 only supports subtitles on top of raw decoded video.
|
||||
Currently playbin only supports subtitles on top of raw decoded video.
|
||||
It will try to find a suitable overlay element from the plugin registry
|
||||
based on the input subtitle caps and the rank. (It is assumed that we
|
||||
will be able to convert any raw video format into any format required
|
||||
|
@ -66,7 +64,7 @@ by the overlay using a converter such as videoconvert.)
|
|||
|
||||
It will not render subtitles if the video sent to the sink is not
|
||||
raw YUV or RGB or if conversions have been disabled by setting the
|
||||
native-video flag on playbin2.
|
||||
native-video flag on playbin.
|
||||
|
||||
Subtitle rendering is considered an important feature. Enabling
|
||||
hardware-accelerated decoding by default should not lead to a major
|
||||
|
@ -174,7 +172,7 @@ Multiple possible solutions come to mind:
|
|||
to buffers seems more intuitive than sending it interleaved as
|
||||
events. And buffers stored or passed around (e.g. via the
|
||||
"last-buffer" property in the sink when doing screenshots via
|
||||
playbin2) always contain all the information needed.
|
||||
playbin) always contain all the information needed.
|
||||
|
||||
|
||||
(d) create a video/x-raw-*-delta format and use a backend-specific videomixer
|
||||
|
@ -185,7 +183,7 @@ Multiple possible solutions come to mind:
|
|||
in the video backend plugin. It would also add a concept that
|
||||
might be generally useful (think ximagesrc capture with xdamage).
|
||||
However, it would require adding foorender variants of all the
|
||||
existing overlay elements, and changing playbin2 to that new
|
||||
existing overlay elements, and changing playbin to that new
|
||||
design, which is somewhat intrusive. And given the general
|
||||
nature of such a new format/API, we would need to take a lot
|
||||
of care to be able to accommodate all possible use cases when
|
||||
|
|
|
@ -3,7 +3,9 @@ Video Acceleration
|
|||
|
||||
Status:
|
||||
|
||||
DRAFT.
|
||||
DRAFT. Outdated for 1.0, we want to use video/x-raw in order to
|
||||
interoperate with all elements that handle video. Optimized handling of
|
||||
the VA surfaces can be done with the metadata.
|
||||
|
||||
Purpose:
|
||||
|
||||
|
|
|
@ -1,4 +1,4 @@
|
|||
playbin2
|
||||
playbin
|
||||
--------
|
||||
|
||||
The purpose of this element is to decode and render the media contained in a
|
||||
|
@ -48,7 +48,7 @@ Components
|
|||
- allows for configuration of visualisation element.
|
||||
- allows for enable/disable of visualisation, audio and video.
|
||||
|
||||
* playbin2
|
||||
* playbin
|
||||
|
||||
- combination of one or more uridecodebin elements to read the uri and subtitle
|
||||
uri.
|
||||
|
@ -61,7 +61,7 @@ Components
|
|||
Gapless playback
|
||||
----------------
|
||||
|
||||
playbin2 has an "about-to-finish" signal. The application should configure a new
|
||||
playbin has an "about-to-finish" signal. The application should configure a new
|
||||
uri (and optional suburi) in the callback. When the current media finishes, this
|
||||
new media will be played next.
|
||||
|
||||
|
|
Loading…
Reference in a new issue