org.lwjgl.egl

Class NVStreamReset

java.lang.Object

org.lwjgl.egl.NVStreamReset

public class NVStreamReset
extends java.lang.Object

Native bindings to the NV_stream_reset extension.

The base stream extension requires that, once the producer inserts the first frame into the stream, at least one frame is always available to be acquired by the consumer until the stream disconnects. However, there are some use cases in which the producer or the consumer may wish to allow the stream to empty without permanently disconnecting.

An example of a use case where the producer may wish to empty the stream is a security or rear-view camera which temporarily stops producing new frames, perhaps due to a hardware reset. Continuing to display the last frame available would produce a false impression of the current state, and should be avoided for safety reasons. A better solution would be to let the consumer know there was no available image, so that it could take appropriate actions, and then recover when the camera begins streaming again.

This use case could be handled with existing functionality by disconnecting and destroying the stream and then recreating and reconnecting it when new frames are available. However, this can be burdensome, particularly when the producer and consumer reside in separate processes.

An example of a use case where the consumer may wish to empty the stream is an image processer which operates on each frame exactly once. After processing, it will not waste resources operating on the same frame a second time. This use case can be handled by carefully monitoring the availability of a new frame before performing an acquire operation. But returning the buffer(s) as soon as they are no longer needed allows for better resource management.

This extension allows a stream to be completely drained of existing frames by the consumer or flushed of existing frames by the producer without disconnecting, so that processing may continue again when new frames are produced.

Requires KHR_stream.

Field Summary

Fields

Modifier and Type	Field and Description
static int	EGL_SUPPORT_RESET_NV Accepted as an attribute in the attrib_list parameter of CreateStreamKHR and the attrib parameter of QueryStreamKHR.
static int	EGL_SUPPORT_REUSE_NV Accepted as an attribute in the attrib_list parameter of CreateStreamKHR and the attrib parameter of QueryStreamKHR.

Method Summary

Modifier and Type	Method and Description
static boolean	eglResetStreamNV(long dpy, long stream)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EGL_SUPPORT_RESET_NV

public static final int EGL_SUPPORT_RESET_NV

Accepted as an attribute in the attrib_list parameter of CreateStreamKHR and the attrib parameter of QueryStreamKHR.

See Also:

Constant Field Values

EGL_SUPPORT_REUSE_NV

public static final int EGL_SUPPORT_REUSE_NV

Accepted as an attribute in the attrib_list parameter of CreateStreamKHR and the attrib parameter of QueryStreamKHR.

See Also:

Constant Field Values

Method Detail

eglResetStreamNV

public static boolean eglResetStreamNV(long dpy,
                                       long stream)