public class QOSEvent extends Event
See upstream documentation at https://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/GstEvent.html#gst-event-new-qos
proportion indicates the real-time performance of the streaming in the element that generated the QoS event (usually the sink). The value is generally computed based on more long term statistics about the streams timestamps compared to the clock.
A value < 1.0 indicates that the upstream element is producing data faster than real-time. A value > 1.0 indicates that the upstream element is not producing data fast enough. 1.0 is the ideal proportion value. The proportion value can safely be used to lower or increase the quality of the element.
difference is the difference against the clock in running time of the last buffer that caused the element to generate the QOS event. A negative value means that the buffer with timestamp arrived in time. A positive value indicates how late the buffer with timestamp was.
timestamp is the timestamp of the last buffer that cause the element to generate the QOS event. It is expressed in running time and thus an ever increasing value.
The upstream element can use the diff and timestamp values to decide whether to process more buffers. For positive difference, all buffers with timestamp <= timestamp + difference will certainly arrive late in the sink as well.
The application can use general event probes to intercept the QoS event and implement custom application specific QoS handling.
Event.TypesMiniObject.HandleNativeObject.Initializer, NativeObject.TypeProvider, NativeObject.TypeRegistration<T extends NativeObject>GTYPE_NAME| Constructor and Description |
|---|
QOSEvent(QOSType type,
double proportion,
long difference,
long timestamp)
Creates a new quality-of-service event.
|
| Modifier and Type | Method and Description |
|---|---|
long |
getDifference()
Gets the difference value of this event.
|
double |
getProportion()
Gets the proportion value of this event.
|
long |
getTimestamp()
Gets the timestamp from this event.
|
QOSType |
getType() |
getStructurecopy, getRefCount, isWritable, makeWritableclose, disown, dispose, equals, getPointer, getRawPointer, hashCode, invalidate, toStringpublic QOSEvent(QOSType type, double proportion, long difference, long timestamp)
proportion - the proportion of the qos messagedifference - the time difference of the last Clock synctimestamp - the timestamp of the bufferpublic QOSType getType()
public double getProportion()
The proportion indicates the real-time performance of the streaming in the element that generated the QoS event (usually the sink). The value is generally computed based on more long term statistics about the streams timestamps compared to the clock.
public long getDifference()
This is the difference against the clock in running time of the last buffer that caused the element to generate the QOS event. A negative value means that the buffer with timestamp arrived in time. A positive value indicates how late the buffer with timestamp was.
public long getTimestamp()
This is the timestamp of the last buffer that caused the element to generate the QOS event. It is expressed in running time and thus an ever increasing value.
Copyright © 2021 gstreamer-java. All rights reserved.