GstStreamCollection

GstStreamCollection

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstStreamCollection

A collection of GstStream that are available.

A GstStreamCollection will be provided by elements that can make those streams available. Applications can use the collection to show the user what streams are available by using gst_stream_collection_get_stream()

Once posted, a GstStreamCollection is immutable. Updates are made by sending a new GstStreamCollection message, which may or may not share some of the GstStream objects from the collection it replaces. The receiver can check the sender of a stream collection message to know which collection is obsoleted.

Several elements in a pipeline can provide GstStreamCollection.

Applications can activate streams from a collection by using the GST_EVENT_SELECT_STREAMS event on a pipeline, bin or element.

Since : 1.10


Class structure

GstStreamCollectionClass

GstStreamCollection class structure

Fields
parent_class (GstObjectClass) –

the parent class structure


Constructors

gst_stream_collection_new

GstStreamCollection *
gst_stream_collection_new (const gchar * upstream_id)

Create a new GstStreamCollection.

Parameters:

upstream_id ( [allow-none])

The stream id of the parent stream

Returns ( [transfer: full])

The new GstStreamCollection.

Since : 1.10


Methods

gst_stream_collection_add_stream

gboolean
gst_stream_collection_add_stream (GstStreamCollection * collection,
                                  GstStream * stream)

Add the given stream to the collection.

Parameters:

collection

a GstStreamCollection

stream ( [transfer: full])

the GstStream to add

Returns

TRUE if the stream was properly added, else FALSE

Since : 1.10


gst_stream_collection_get_size

guint
gst_stream_collection_get_size (GstStreamCollection * collection)

Get the number of streams this collection contains

Parameters:

collection

a GstStreamCollection

Returns

The number of streams that collection contains

Since : 1.10


gst_stream_collection_get_stream

GstStream *
gst_stream_collection_get_stream (GstStreamCollection * collection,
                                  guint index)

Retrieve the GstStream with index index from the collection.

The caller should not modify the returned GstStream

Parameters:

collection

a GstStreamCollection

index

Index of the stream to retrieve

Returns ( [transfer: none][nullable])

A GstStream

Since : 1.10


gst_stream_collection_get_upstream_id

const gchar *
gst_stream_collection_get_upstream_id (GstStreamCollection * collection)

Returns the upstream id of the collection.

Parameters:

collection

a GstStreamCollection

Returns ( [transfer: none][nullable])

The upstream id

Since : 1.10


Signals

stream-notify

stream_notify_callback (GstStreamCollection * self,
                        GstStream * prop_stream,
                        GParamSpec * prop,
                        gpointer user_data)

The stream notify signal is used to be notified of property changes to streams within the collection.

Parameters:

self
No description available
prop_stream

the GstStream that originated the signal

prop

the property that changed

user_data
No description available

Flags: Run First / No Hooks


Properties

upstream-id

“upstream-id” gchar *

stream-id

Flags : Read / Write / Construct


Virtual Methods

stream_notify

stream_notify (GstStreamCollection * collection,
               GstStream * stream,
               GParamSpec * pspec)

default signal handler for the stream-notify signal

Parameters:

collection
No description available
stream
No description available
pspec
No description available

Function Macros

GST_STREAM_COLLECTION_CAST

#define GST_STREAM_COLLECTION_CAST(obj)        ((GstStreamCollection*)(obj))

The results of the search are