summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPhilippe Normand <philn@igalia.com>2013-03-29 14:56:57 +0100
committerSebastian Dröge <sebastian.droege@collabora.co.uk>2013-04-16 16:52:08 +0200
commit54c678a21ec65d5d4aa82ed18116b1ee9624a5e8 (patch)
tree3f3bb6fd59407f72efa3bf16031f8c25dea5aec3 /docs
parent4997fd9f94aec50157c821d5e7a0ea099b0ecb94 (diff)
query: new _BANDWIDTH_LIMITED flag
Source elements with limited bandwidth capabilities and supporting buffering for downstream elements should set this flag when answering a scheduling query. This is useful for the on-disk buffering scenario of uridecodebin to avoid checking the URI protocol against a list of hardcoded protocols. Bug 693484
Diffstat (limited to 'docs')
-rw-r--r--docs/design/part-scheduling.txt14
1 files changed, 12 insertions, 2 deletions
diff --git a/docs/design/part-scheduling.txt b/docs/design/part-scheduling.txt
index a4fbdb796..c1dd33193 100644
--- a/docs/design/part-scheduling.txt
+++ b/docs/design/part-scheduling.txt
@@ -67,8 +67,9 @@ this with the SCHEDULING query.
(out) "flags", GST_TYPE_SCHEDULING_FLAGS (default 0)
typedef enum {
- GST_SCHEDULING_FLAG_SEEKABLE = (1 << 0),
- GST_SCHEDULING_FLAG_SEQUENTIAL = (1 << 1)
+ GST_SCHEDULING_FLAG_SEEKABLE = (1 << 0),
+ GST_SCHEDULING_FLAG_SEQUENTIAL = (1 << 1),
+ GST_SCHEDULING_FLAG_BANDWIDTH_LIMITED = (1 << 2)
} GstSchedulingFlags;
_SEEKABLE:
@@ -80,6 +81,15 @@ this with the SCHEDULING query.
seeks are allowed but should be avoided. This is common for network
streams.
+ _BANDWIDTH_LIMITED:
+ - suggest the element supports buffering data for downstream to
+ cope with bandwidth limitations. If this flag is on the
+ downstream element might ask for more data than necessary for
+ normal playback. This use-case is interesting for on-disk
+ buffering scenarios for instance. Seek operations might be
+ slow as well so downstream elements should take this into
+ consideration.
+
(out) "minsize", G_TYPE_INT (default 1)
- the suggested minimum size of pull requests