From: Wim Taymans Date: Mon, 1 Oct 2012 09:58:36 +0000 (+0200) Subject: docs: update for 1.0 X-Git-Tag: 1.19.3~511^2~5868^2~4 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=370d336e9e35a10d18bc98fa31120302b2febbc8;p=platform%2Fupstream%2Fgstreamer.git docs: update for 1.0 --- diff --git a/docs/design/draft-subtitle-overlays.txt b/docs/design/draft-subtitle-overlays.txt index b2e080d..87f2c2c 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 be02706..2bff4bc 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 195d048..232ac0c 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.