Package org.lwjgl.egl

Class ANDROIDPresentationTime

java.lang.Object
org.lwjgl.egl.ANDROIDPresentationTime

public class ANDROIDPresentationTime extends Object
Native bindings to the ANDROID_presentation_time extension.

Often when rendering a sequence of images, there is some time at which each image is intended to be presented to the viewer. This extension allows this desired presentation time to be specified for each frame rendered to an EGLSurface, allowing the native window system to use it.

  • Method Details

    • eglPresentationTimeANDROID

      public static boolean eglPresentationTimeANDROID(long dpy, long surface, long time)
      Specifies the time at which the current color buffer of surface should be presented to the viewer. The time parameter should be a time in nanoseconds, but the exact meaning of the time depends on the native window system's use of the presentation time. In situations where an absolute time is needed such as displaying the color buffer on a display device, the time should correspond to the system monotonic up-time clock. For situations in which an absolute time is not needed such as using the color buffer for video encoding, the presentation time of the first frame may be arbitrarily chosen and those of subsequent frames chosen relative to that of the first frame.

      The presentation time may be set multiple times, with each call to eglPresentationTimeANDROID overriding prior calls. Setting the presentation time alone does not cause the color buffer to be made visible, but if the color buffer is subsequently posted to a native window or copied to a native pixmap then the presentation time of the surface at that time may be passed along for the native window system to use.

      If the surface presentation time is successfully set, TRUE is returned. Otherwise FALSE is returned and an appropriate error is set. If dpy is not the name of a valid, initialized EGLDisplay, an BAD_DISPLAY error is generated. If surface is not a valid EGLSurface then an BAD_SURFACE error is generated.

      Parameters:
      dpy - the EGLDisplay
      surface - the EGLSurface
      time - the presentation time