AppSink.tryPullSample

This function blocks until a sample or EOS becomes available or the appsink element is set to the READY/NULL state or the timeout expires.

This function will only return samples when the appsink is in the PLAYING state. All rendered buffers will be put in a queue so that the application can pull samples at its own rate. Note that when the application does not pull samples fast enough, the queued buffers could consume a lot of memory, especially when dealing with raw video frames.

If an EOS event was received before any buffers or the timeout expires, this function returns NULL. Use gst_app_sink_is_eos () to check for the EOS condition.

class AppSink
tryPullSample

Parameters

timeout GstClockTime

the maximum amount of time to wait for a sample

Return Value

Type: Sample

a gstreamer.Sample or NULL when the appsink is stopped or EOS or the timeout expires. Call Sample.unref after usage.

Meta

Since

1.10