summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorWim Taymans <wim.taymans@collabora.co.uk>2012-10-01 11:58:36 +0200
committerWim Taymans <wim.taymans@collabora.co.uk>2012-10-01 11:58:36 +0200
commit370d336e9e35a10d18bc98fa31120302b2febbc8 (patch)
tree4988b830fb09645a5028e38720a44839548b57f9 /docs
parent579458f61373ef60fdc19c5fb46528d085c932cb (diff)
docs: update for 1.0
Diffstat (limited to 'docs')
-rw-r--r--docs/design/draft-subtitle-overlays.txt14
-rw-r--r--docs/design/draft-va.txt4
-rw-r--r--docs/design/part-playbin.txt6
3 files changed, 12 insertions, 12 deletions
diff --git a/docs/design/draft-subtitle-overlays.txt b/docs/design/draft-subtitle-overlays.txt
index b2e080dde..87f2c2c61 100644
--- a/docs/design/draft-subtitle-overlays.txt
+++ b/docs/design/draft-subtitle-overlays.txt
@@ -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
diff --git a/docs/design/draft-va.txt b/docs/design/draft-va.txt
index be02706cf..2bff4bc3e 100644
--- a/docs/design/draft-va.txt
+++ b/docs/design/draft-va.txt
@@ -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:
diff --git a/docs/design/part-playbin.txt b/docs/design/part-playbin.txt
index 195d04889..232ac0cd2 100644
--- a/docs/design/part-playbin.txt
+++ b/docs/design/part-playbin.txt
@@ -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.