Class NVDrawVulkanImage

java.lang.Object
org.lwjgl.opengles.NVDrawVulkanImage

public class NVDrawVulkanImage extends Object
Native bindings to the NV_draw_vulkan_image extension.

This extension provides a new function, DrawVkImageNV, allowing applications to draw a screen-aligned rectangle displaying some or all of the contents of a two-dimensional Vulkan VkImage. Callers specify a Vulkan VkImage handle, an optional OpenGL sampler object, window coordinates of the rectangle to draw, and texture coordinates corresponding to the corners of the rectangle. For each fragment produced by the rectangle, DrawVkImageNV interpolates the texture coordinates, performs a texture lookup, and uses the texture result as the fragment color.

No shaders are used by DrawVkImageNV; the results of the texture lookup are used in lieu of a fragment shader output. The fragments generated are processed by all per-fragment operations. In particular, DrawVkImageNV() fully supports blending and multisampling.

In order to synchronize between Vulkan and OpenGL there are three other functions provided; WaitVkSemaphoreNV, SignalVkSemaphoreNV and SignalVkFenceNV. These allow OpenGL to wait for Vulkan to complete work and also Vulkan to wait for OpenGL to complete work. Together OpenGL and Vulkan can synchronize on the server without application interation.

Finally the function GetVkProcAddrNV() is provided to allow the OpenGL context to query the Vulkan entry points directly and avoid having to load them through the typical Vulkan loader.

  • Method Summary

    Modifier and Type
    Method
    Description
    static void
    glDrawVkImageNV(long vkImage, int sampler, float x0, float y0, float x1, float y1, float z, float s0, float t0, float s1, float t1)
    Draws a screen-aligned rectangle displaying a portion of the contents of the Vulkan VkImage.
    static long
    Queries the Vulkan function entry points from within an OpenGL context.
    static long
    Queries the Vulkan function entry points from within an OpenGL context.
    static void
    glSignalVkFenceNV(long vkFence)
    Causes the GL server to signal the Vulkan VkFence object when it executes this command.
    static void
    glSignalVkSemaphoreNV(long vkSemaphore)
    Causes the GL server to signal the Vulkan VkSemaphore when it executes this command.
    static void
    glWaitVkSemaphoreNV(long vkSemaphore)
    Causes the GL server to block until the Vulkan VkSemaphore is signalled.
    static long
    nglGetVkProcAddrNV(long name)
    Unsafe version of: GetVkProcAddrNV

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • glDrawVkImageNV

      public static void glDrawVkImageNV(long vkImage, int sampler, float x0, float y0, float x1, float y1, float z, float s0, float t0, float s1, float t1)
      Draws a screen-aligned rectangle displaying a portion of the contents of the Vulkan VkImage.
      Parameters:
      vkImage - the Vulkan image handle
      sampler - an optional sampler object
      x0 - the rectangle left window coordinate
      y0 - the rectangle bottom window coordinate
      x1 - the rectangle right window coordinate
      y1 - the rectangle top window coordinate
      z - the Z window coordinate
      s0 - the left texture coordinate
      t0 - the bottom texture coordinate
      s1 - the right texture coordinate
      t1 - the top texture coordinate
    • nglGetVkProcAddrNV

      public static long nglGetVkProcAddrNV(long name)
      Unsafe version of: GetVkProcAddrNV
    • glGetVkProcAddrNV

      public static long glGetVkProcAddrNV(ByteBuffer name)
      Queries the Vulkan function entry points from within an OpenGL context.
      Parameters:
      name - name of the Vulkan function
    • glGetVkProcAddrNV

      public static long glGetVkProcAddrNV(CharSequence name)
      Queries the Vulkan function entry points from within an OpenGL context.
      Parameters:
      name - name of the Vulkan function
    • glWaitVkSemaphoreNV

      public static void glWaitVkSemaphoreNV(long vkSemaphore)
      Causes the GL server to block until the Vulkan VkSemaphore is signalled. No GL commands after this command are executed by the server until the semaphore is signaled.
      Parameters:
      vkSemaphore - a valid Vulkan VkSemaphore non-dispatchable handle otherwise the operation is undefined
    • glSignalVkSemaphoreNV

      public static void glSignalVkSemaphoreNV(long vkSemaphore)
      Causes the GL server to signal the Vulkan VkSemaphore when it executes this command. The semaphore is not signalled by GL until all commands issued before this have completed execution on the GL server.
      Parameters:
      vkSemaphore - a valid Vulkan VkSemaphore non-dispatchable handle otherwise the operation is undefined
    • glSignalVkFenceNV

      public static void glSignalVkFenceNV(long vkFence)
      Causes the GL server to signal the Vulkan VkFence object when it executes this command. The fence is not signalled by the GL until all commands issued before this have completed execution on the GL server.
      Parameters:
      vkFence - a valid Vulkan VkFence non-dispatcable handle otherwise the operation is undefined