struct GstAppSrc

struct GstAppSrc;

The "block" property

  "block"                    gboolean              : Read / Write

Block push-buffer when max-bytes are queued.

Default value: FALSE

The "caps" property

  "caps"                     GstCaps*              : Read / Write

The allowed caps for the src pad.

The "format" property

  "format"                   GstFormat             : Read / Write

The format of the segment events and seek.

Default value: GST_FORMAT_BYTES

The "is-live" property

  "is-live"                  gboolean              : Read / Write

Whether to act as a live source.

Default value: FALSE

The "max-bytes" property

  "max-bytes"                guint64               : Read / Write

The maximum number of bytes to queue internally (0 = unlimited).

Default value: 200000

The "max-latency" property

  "max-latency"              gint64                : Read / Write

The maximum latency (-1 = unlimited).

Allowed values: >= G_MAXULONG

Default value: -1

The "min-latency" property

  "min-latency"              gint64                : Read / Write

The minimum latency (-1 = default).

Allowed values: >= G_MAXULONG

Default value: -1

The "size" property

  "size"                     gint64                : Read / Write

The size of the data stream in bytes (-1 if unknown).

Allowed values: >= G_MAXULONG

Default value: -1

The "stream-type" property

  "stream-type"              GstAppStreamType      : Read / Write

the type of the stream.

Default value: GST_APP_STREAM_TYPE_STREAM

The "emit-signals" property

  "emit-signals"             gboolean              : Read / Write

Emit need-data, enough-data and seek-data signals.

Default value: TRUE

The "min-percent" property

  "min-percent"              guint                 : Read / Write

Emit need-data when queued bytes drops below this percent of max-bytes.

Allowed values: <= 100

Default value: 0

The "end-of-stream" signal

GstFlowReturn       user_function                      (GstAppSrc *appsrc,
                                                        gpointer   user_data)      : Action

Notify appsrc that no more buffer are available.

The "enough-data" signal

void                user_function                      (GstAppSrc *appsrc,
                                                        gpointer   user_data)      : Run Last

Signal that the source has enough data. It is recommended that the application stops calling push-buffer until the need-data signal is emited again to avoid excessive buffer queueing.

The "need-data" signal

void                user_function                      (GstAppSrc *appsrc,
                                                        guint      length,
                                                        gpointer   user_data)      : Run Last

Signal that the source needs more data. In the callback or from another thread you should call push-buffer or end-of-stream.

length is just a hint and when it is set to -1, any number of bytes can be pushed into appsrc.

You can call push-buffer multiple times until the enough-data signal is fired.

The "push-buffer" signal

GstFlowReturn       user_function                      (GstAppSrc *appsrc,
                                                        GstBuffer *buffer,
                                                        gpointer   user_data)      : Action

Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function does not take ownership of the buffer so the buffer needs to be unreffed after calling this function.

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

The "seek-data" signal

gboolean            user_function                      (GstAppSrc *appsrc,
                                                        guint64    offset,
                                                        gpointer   user_data)      : Run Last

Seek to the given offset. The next push-buffer should produce buffers from the new offset. This callback is only called for seekable stream types.