[ HasEmitter ]
[ Version ( since = "1.10" ) ]
public virtual signal Sample try_pull_sample (uint64 timeout)
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 samples 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 samples could consume a lot of memory, especially when dealing with raw video frames. It's possible to control the behaviour of the queue with the "drop" and "max-buffers" properties.
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.
| timeout |
the maximum amount of time to wait for a sample |
|
a Sample or NULL when the appsink is stopped or EOS or the timeout expires. |