Class AMDQueryBufferObject

java.lang.Object
org.lwjgl.opengl.AMDQueryBufferObject

public final class AMDQueryBufferObject extends Object
Native bindings to the AMD_query_buffer_object extension.

Statistics about the operation of the OpenGL pipeline, such as the number of samples that passed the depth test, the elapsed time between two events or the number of vertices written to a transform feedback buffer may be retrieved from the GL through query objects. The current value of a query object may be retrieved by the application through the OpenGL API. Should the result returned by the API be required for use in a shader, it must be passed back to the GL via a program uniform or some other mechanism. This requires a round-trip from the GPU to the CPU and back.

This extension introduces a mechanism whereby the current value of a query result may be retrieved into a buffer object instead of client memory. This allows the query result to be made available to a shader without a round-trip to the CPU for example by subsequently using the buffer object as a uniform buffer, texture buffer or other data store visible to the shader. This functionality may also be used to place the results of many query objects into a single, large buffer and then map or otherwise read back the entire buffer at a later point in time, avoiding a per-query CPU-GPU synchronization event.

The result of any query object type supported by the GL implementation may be retrieved into a buffer object. The implementation will determine the most efficient method of copying the query result to the buffer.

Requires OpenGL 1.5.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    Accepted by the target parameters of BindBuffer, BufferData, BufferSubData, MapBuffer, UnmapBuffer, MapBufferRange, GetBufferSubData, GetBufferParameteriv and GetBufferPointerv.
    static final int
    Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
    static final int
    Accepted by the pname parameter of GetQueryObjectiv, GetQueryObjectuiv, GetQueryObjecti64v and GetQueryObjectui64v.
  • Method Summary

    Methods inherited from class java.lang.Object

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

    • GL_QUERY_RESULT_NO_WAIT_AMD

      public static final int GL_QUERY_RESULT_NO_WAIT_AMD
      Accepted by the pname parameter of GetQueryObjectiv, GetQueryObjectuiv, GetQueryObjecti64v and GetQueryObjectui64v.
      See Also:
    • GL_QUERY_BUFFER_AMD

      public static final int GL_QUERY_BUFFER_AMD
      Accepted by the target parameters of BindBuffer, BufferData, BufferSubData, MapBuffer, UnmapBuffer, MapBufferRange, GetBufferSubData, GetBufferParameteriv and GetBufferPointerv.
      See Also:
    • GL_QUERY_BUFFER_BINDING_AMD

      public static final int GL_QUERY_BUFFER_BINDING_AMD
      Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
      See Also: