org.lwjgl.opengl

Class EXTTimerQuery

java.lang.Object

org.lwjgl.opengl.EXTTimerQuery

public class EXTTimerQuery
extends java.lang.Object

Native bindings to the EXT_timer_query extension.

Applications can benefit from accurate timing information in a number of different ways. During application development, timing information can help identify application or driver bottlenecks. At run time, applications can use timing information to dynamically adjust the amount of detail in a scene to achieve constant frame rates. OpenGL implementations have historically provided little to no useful timing information. Applications can get some idea of timing by reading timers on the CPU, but these timers are not synchronized with the graphics rendering pipeline. Reading a CPU timer does not guarantee the completion of a potentially large amount of graphics work accumulated before the timer is read, and will thus produce wildly inaccurate results. glFinish() can be used to determine when previous rendering commands have been completed, but will idle the graphics pipeline and adversely affect application performance.

This extension provides a query mechanism that can be used to determine the amount of time it takes to fully complete a set of GL commands, and without stalling the rendering pipeline. It uses the query object mechanisms first introduced in the occlusion query extension, which allow time intervals to be polled asynchronously by the application.

Requires OpenGL 1.5.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_TIME_ELAPSED_EXT Accepted by the target parameter of BeginQuery, EndQuery, and GetQueryiv.

Method Summary

Modifier and Type	Method and Description
static long	glGetQueryObjecti64EXT(int id, int pname)
static void	glGetQueryObjecti64vEXT(int id, int pname, long[] params) Array version of: GetQueryObjecti64vEXT
static void	glGetQueryObjecti64vEXT(int id, int pname, java.nio.LongBuffer params)
static long	glGetQueryObjectui64EXT(int id, int pname)
static void	glGetQueryObjectui64vEXT(int id, int pname, long[] params) Array version of: GetQueryObjectui64vEXT
static void	glGetQueryObjectui64vEXT(int id, int pname, java.nio.LongBuffer params)
static void	nglGetQueryObjecti64vEXT(int id, int pname, long params)
static void	nglGetQueryObjectui64vEXT(int id, int pname, long params)

Methods inherited from class java.lang.Object

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

Field Detail

GL_TIME_ELAPSED_EXT

public static final int GL_TIME_ELAPSED_EXT

Accepted by the target parameter of BeginQuery, EndQuery, and GetQueryiv.

See Also:

Constant Field Values

Method Detail

nglGetQueryObjecti64vEXT

public static void nglGetQueryObjecti64vEXT(int id,
                                            int pname,
                                            long params)

glGetQueryObjecti64vEXT

public static void glGetQueryObjecti64vEXT(int id,
                                           int pname,
                                           java.nio.LongBuffer params)

glGetQueryObjecti64EXT

public static long glGetQueryObjecti64EXT(int id,
                                          int pname)

nglGetQueryObjectui64vEXT

public static void nglGetQueryObjectui64vEXT(int id,
                                             int pname,
                                             long params)

glGetQueryObjectui64vEXT

public static void glGetQueryObjectui64vEXT(int id,
                                            int pname,
                                            java.nio.LongBuffer params)

glGetQueryObjectui64EXT

public static long glGetQueryObjectui64EXT(int id,
                                           int pname)

glGetQueryObjecti64vEXT

public static void glGetQueryObjecti64vEXT(int id,
                                           int pname,
                                           long[] params)

Array version of: GetQueryObjecti64vEXT

glGetQueryObjectui64vEXT

public static void glGetQueryObjectui64vEXT(int id,
                                            int pname,
                                            long[] params)

Array version of: GetQueryObjectui64vEXT