event: add SELECT and UNSELECT stream flags for stream-start event

So demuxers can signal which audio/video/subtitle streams should
be selected by default and which should not be selected
automatically.

API: GST_STREAM_FLAG_SELECT
API: GST_STREAM_FLAG_UNSELECT

https://bugzilla.gnome.org/show_bug.cgi?id=695968
https://bugzilla.gnome.org/show_bug.cgi?id=690911
This commit is contained in:
Tim-Philipp Müller 2013-03-31 15:30:19 +01:00
parent 0e5c1dcf64
commit caa06788c3

View file

@ -372,12 +372,22 @@ typedef enum {
* @GST_STREAM_FLAG_SPARSE: This stream is a sparse stream (e.g. a subtitle * @GST_STREAM_FLAG_SPARSE: This stream is a sparse stream (e.g. a subtitle
* stream), data may flow only in irregular intervals with large gaps in * stream), data may flow only in irregular intervals with large gaps in
* between. * between.
* @GST_STREAM_FLAG_SELECT: This stream should be selected by default. This
* flag may be used by demuxers to signal that a stream should be selected
* by default in a playback scenario.
* @GST_STREAM_FLAG_UNSELECT: This stream should not be selected by default.
* This flag may be used by demuxers to signal that a stream should not
* be selected by default in a playback scenario, but only if explicitly
* selected by the user (e.g. an audio track for the hard of hearing or
* a director's commentary track).
* *
* Since: 1.2 * Since: 1.2
*/ */
typedef enum { typedef enum {
GST_STREAM_FLAG_NONE, GST_STREAM_FLAG_NONE,
GST_STREAM_FLAG_SPARSE = (1 << 0) GST_STREAM_FLAG_SPARSE = (1 << 0),
GST_STREAM_FLAG_SELECT = (1 << 1),
GST_STREAM_FLAG_UNSELECT = (1 << 2)
} GstStreamFlags; } GstStreamFlags;
/** /**