GstAppSrc

typedef struct {
  GstBaseSrc basesrc;
} GstAppSrc;

enum GstAppStreamType

typedef enum
{
  GST_APP_STREAM_TYPE_STREAM,
  GST_APP_STREAM_TYPE_SEEKABLE,
  GST_APP_STREAM_TYPE_RANDOM_ACCESS
} GstAppStreamType;

The stream type.

gst_app_src_set_caps ()

void                gst_app_src_set_caps                (GstAppSrc *appsrc,
                                                         const GstCaps *caps);

Set the capabilities on the appsrc element. This function takes a copy of the caps structure. After calling this method, the source will only produce caps that match caps. caps must be fixed and the caps on the buffers must match the caps or left NULL.

Since 0.10.22

gst_app_src_get_caps ()

GstCaps*            gst_app_src_get_caps                (GstAppSrc *appsrc);

Get the configured caps on appsrc.

Since 0.10.22

gst_app_src_get_latency ()

void                gst_app_src_get_latency             (GstAppSrc *appsrc,
                                                         guint64 *min,
                                                         guint64 *max);

Retrieve the min and max latencies in min and max respectively.

Since 0.10.22

gst_app_src_set_latency ()

void                gst_app_src_set_latency             (GstAppSrc *appsrc,
                                                         guint64 min,
                                                         guint64 max);

Configure the min and max latency in src. If min is set to -1, the default latency calculations for pseudo-live sources will be used.

Since 0.10.22

gst_app_src_set_size ()

void                gst_app_src_set_size                (GstAppSrc *appsrc,
                                                         gint64 size);

Set the size of the stream in bytes. A value of -1 means that the size is not known.

Since 0.10.22

gst_app_src_get_size ()

gint64              gst_app_src_get_size                (GstAppSrc *appsrc);

Get the size of the stream in bytes. A value of -1 means that the size is not known.

Since 0.10.22

gst_app_src_set_stream_type ()

void                gst_app_src_set_stream_type         (GstAppSrc *appsrc,
                                                         GstAppStreamType type);

Set the stream type on appsrc. For seekable streams, the "seek" signal must be connected to.

A stream_type stream

Since 0.10.22

gst_app_src_get_stream_type ()

GstAppStreamType    gst_app_src_get_stream_type         (GstAppSrc *appsrc);

Get the stream type. Control the stream type of appsrc with gst_app_src_set_stream_type().

Since 0.10.22

gst_app_src_set_max_bytes ()

void                gst_app_src_set_max_bytes           (GstAppSrc *appsrc,
                                                         guint64 max);

Set the maximum amount of bytes that can be queued in appsrc. After the maximum amount of bytes are queued, appsrc will emit the "enough-data" signal.

Since 0.10.22

gst_app_src_get_max_bytes ()

guint64             gst_app_src_get_max_bytes           (GstAppSrc *appsrc);

Get the maximum amount of bytes that can be queued in appsrc.

Since 0.10.22

gst_app_src_get_emit_signals ()

gboolean            gst_app_src_get_emit_signals        (GstAppSrc *appsrc);

Check if appsrc will emit the "new-preroll" and "new-buffer" signals.

Since 0.10.23

gst_app_src_set_emit_signals ()

void                gst_app_src_set_emit_signals        (GstAppSrc *appsrc,
                                                         gboolean emit);

Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is by default disabled because signal emission is expensive and unneeded when the application prefers to operate in pull mode.

Since 0.10.23

GstAppSrcCallbacks

typedef struct {
  void      (*need_data)    (GstAppSrc *src, guint length, gpointer user_data);
  void      (*enough_data)  (GstAppSrc *src, gpointer user_data);
  gboolean  (*seek_data)    (GstAppSrc *src, guint64 offset, gpointer user_data);
} GstAppSrcCallbacks;

A set of callbacks that can be installed on the appsrc with gst_app_src_set_callbacks().

Since 0.10.23

gst_app_src_set_callbacks ()

void                gst_app_src_set_callbacks           (GstAppSrc *appsrc,
                                                         GstAppSrcCallbacks *callbacks,
                                                         gpointer user_data,
                                                         GDestroyNotify notify);

Set callbacks which will be executed when data is needed, enough data has been collected or when a seek should be performed. This is an alternative to using the signals, it has lower overhead and is thus less expensive, but also less flexible.

If callbacks are installed, no signals will be emited for performance reasons.

Since 0.10.23

gst_app_src_push_buffer ()

GstFlowReturn       gst_app_src_push_buffer             (GstAppSrc *appsrc,
                                                         GstBuffer *buffer);

Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function takes ownership of the buffer.

When the block property is TRUE, this function can block until free space becomes available in the queue.

Since 0.10.22

gst_app_src_end_of_stream ()

GstFlowReturn       gst_app_src_end_of_stream           (GstAppSrc *appsrc);

Indicates to the appsrc element that the last buffer queued in the element is the last buffer of the stream.

Since 0.10.22