LWJGL 3.3.3 · org.lwjgl.opengles.INTELPerformanceQuery

Native bindings to the INTEL_performance_query extension.

The purpose of this extension is to expose Intel proprietary hardware performance counters to the OpenGL applications. Performance counters may count:

number of hardware events such as number of spawned vertex shaders. In this case the results represent the number of events.
duration of certain activity, like time took by all fragment shader invocations. In that case the result usually represents the number of clocks in which the particular HW unit was busy. In order to use such counter efficiently, it should be normalized to the range of <0,1> by dividing its value by the number of render clocks.
used throughput of certain memory types such as texture memory. In that case the result of performance counter usually represents the number of bytes transferred between GPU and memory.

This extension specifies universal API to manage performance counters on different Intel hardware platforms. Performance counters are grouped together into proprietary, hardware-specific, fixed sets of counters that are measured together by the GPU.

It is assumed that performance counters are started and ended on any arbitrary boundaries during rendering.

A set of performance counters is represented by a unique query type. Each query type is identified by assigned name and ID. Multiple query types (sets of performance counters) are supported by the Intel hardware. However each Intel hardware generation supports different sets of performance counters. Therefore the query types between hardware generations can be different. The definition of query types and their results structures can be learned through the API. It is also documented in a separate document of Intel OGL Performance Counters Specification issued per each new hardware generation.

The API allows to create multiple instances of any query type and to sample different fragments of 3D rendering with such instances. Query instances are identified with handles.

Field Summary

Modifier and Type	Field and Description
public static final int	GL_PERFQUERY_COUNTER_DATA_BOOL32_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DATA_DOUBLE_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DATA_FLOAT_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DATA_UINT32_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DATA_UINT64_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DESC_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.
public static final int	GL_PERFQUERY_COUNTER_DURATION_NORM_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_DURATION_RAW_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_EVENT_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_NAME_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.
public static final int	GL_PERFQUERY_COUNTER_RAW_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_THROUGHPUT_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_COUNTER_TIMESTAMP_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.
public static final int	GL_PERFQUERY_DONOT_FLUSH_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.
public static final int	GL_PERFQUERY_FLUSH_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.
public static final int	GL_PERFQUERY_GLOBAL_CONTEXT_INTEL Returned by the capsMask parameter of GetPerfQueryInfoINTEL.
public static final int	GL_PERFQUERY_GPA_EXTENDED_COUNTERS_INTEL Accepted by the `pname` parameter of GetBooleanv.
public static final int	GL_PERFQUERY_QUERY_NAME_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.
public static final int	GL_PERFQUERY_SINGLE_CONTEXT_INTEL Returned by the capsMask parameter of GetPerfQueryInfoINTEL.
public static final int	GL_PERFQUERY_WAIT_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.

Access	Constructor and Description
protected	INTELPerformanceQuery()

Method Summary

Modifier and Type	Method and Description
public static native void	glBeginPerfQueryINTEL(int queryHandle)
public static void	glCreatePerfQueryINTEL(int queryId, IntBuffer queryHandle)
public static int	glCreatePerfQueryINTEL(int queryId)
public static void	glCreatePerfQueryINTEL(int queryId, int[] queryHandle) Array version of: `CreatePerfQueryINTEL`
public static native void	glDeletePerfQueryINTEL(int queryHandle)
public static native void	glEndPerfQueryINTEL(int queryHandle)
public static void	glGetFirstPerfQueryIdINTEL(IntBuffer queryId)
public static int	glGetFirstPerfQueryIdINTEL()
public static void	glGetFirstPerfQueryIdINTEL(int[] queryId) Array version of: `GetFirstPerfQueryIdINTEL`
public static void	glGetNextPerfQueryIdINTEL(int queryId, IntBuffer nextQueryId)
public static int	glGetNextPerfQueryIdINTEL(int queryId)
public static void	glGetNextPerfQueryIdINTEL(int queryId, int[] nextQueryId) Array version of: `GetNextPerfQueryIdINTEL`
public static void	glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, IntBuffer counterOffset, IntBuffer counterDataSize, IntBuffer counterTypeEnum, IntBuffer counterDataTypeEnum, LongBuffer rawCounterMaxValue)
public static void	glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, int[] counterOffset, int[] counterDataSize, int[] counterTypeEnum, int[] counterDataTypeEnum, long[] rawCounterMaxValue) Array version of: `GetPerfCounterInfoINTEL`
public static void	glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, IntBuffer bytesWritten)
public static void	glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, int[] bytesWritten) Array version of: `GetPerfQueryDataINTEL`
public static void	glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, IntBuffer queryId)
public static void	glGetPerfQueryIdByNameINTEL(CharSequence queryName, IntBuffer queryId)
public static int	glGetPerfQueryIdByNameINTEL(CharSequence queryName)
public static void	glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, int[] queryId) Array version of: `GetPerfQueryIdByNameINTEL`
public static void	glGetPerfQueryIdByNameINTEL(CharSequence queryName, int[] queryId) Array version of: `GetPerfQueryIdByNameINTEL`
public static void	glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, IntBuffer dataSize, IntBuffer noCounters, IntBuffer noInstances, IntBuffer capsMask)
public static void	glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, int[] dataSize, int[] noCounters, int[] noInstances, int[] capsMask) Array version of: `GetPerfQueryInfoINTEL`
public static native void	nglCreatePerfQueryINTEL(int queryId, long queryHandle)
public static native void	nglGetFirstPerfQueryIdINTEL(long queryId)
public static native void	nglGetNextPerfQueryIdINTEL(int queryId, long nextQueryId)
public static native void	nglGetPerfCounterInfoINTEL(int queryId, int counterId, int counterNameLength, long counterName, int counterDescLength, long counterDesc, long counterOffset, long counterDataSize, long counterTypeEnum, long counterDataTypeEnum, long rawCounterMaxValue)
public static native void	nglGetPerfQueryDataINTEL(int queryHandle, int flags, int dataSize, long data, long bytesWritten)
public static native void	nglGetPerfQueryIdByNameINTEL(long queryName, long queryId)
public static native void	nglGetPerfQueryInfoINTEL(int queryId, int queryNameLength, long queryName, long dataSize, long noCounters, long noInstances, long capsMask)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

GL_PERFQUERY_COUNTER_DATA_BOOL32_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DATA_BOOL32_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.

GL_PERFQUERY_COUNTER_DATA_DOUBLE_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DATA_DOUBLE_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.

GL_PERFQUERY_COUNTER_DATA_FLOAT_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DATA_FLOAT_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.

GL_PERFQUERY_COUNTER_DATA_UINT32_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DATA_UINT32_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.

GL_PERFQUERY_COUNTER_DATA_UINT64_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DATA_UINT64_INTEL Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum.

GL_PERFQUERY_COUNTER_DESC_LENGTH_MAX_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DESC_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.

GL_PERFQUERY_COUNTER_DURATION_NORM_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DURATION_NORM_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_COUNTER_DURATION_RAW_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_DURATION_RAW_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_COUNTER_EVENT_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_EVENT_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_COUNTER_NAME_LENGTH_MAX_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_NAME_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.

GL_PERFQUERY_COUNTER_RAW_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_RAW_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_COUNTER_THROUGHPUT_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_THROUGHPUT_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_COUNTER_TIMESTAMP_INTEL	back to summary
public static final int GL_PERFQUERY_COUNTER_TIMESTAMP_INTEL Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum.

GL_PERFQUERY_DONOT_FLUSH_INTEL	back to summary
public static final int GL_PERFQUERY_DONOT_FLUSH_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.

GL_PERFQUERY_FLUSH_INTEL	back to summary
public static final int GL_PERFQUERY_FLUSH_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.

GL_PERFQUERY_GLOBAL_CONTEXT_INTEL	back to summary
public static final int GL_PERFQUERY_GLOBAL_CONTEXT_INTEL Returned by the capsMask parameter of GetPerfQueryInfoINTEL.

GL_PERFQUERY_GPA_EXTENDED_COUNTERS_INTEL	back to summary
public static final int GL_PERFQUERY_GPA_EXTENDED_COUNTERS_INTEL Accepted by the `pname` parameter of GetBooleanv.

GL_PERFQUERY_QUERY_NAME_LENGTH_MAX_INTEL	back to summary
public static final int GL_PERFQUERY_QUERY_NAME_LENGTH_MAX_INTEL Accepted by the `pname` parameter of GetIntegerv.

GL_PERFQUERY_SINGLE_CONTEXT_INTEL	back to summary
public static final int GL_PERFQUERY_SINGLE_CONTEXT_INTEL Returned by the capsMask parameter of GetPerfQueryInfoINTEL.

GL_PERFQUERY_WAIT_INTEL	back to summary
public static final int GL_PERFQUERY_WAIT_INTEL Accepted by the flags parameter of GetPerfQueryDataINTEL.

Constructor Detail

INTELPerformanceQuery	back to summary
protected INTELPerformanceQuery()

Method Detail

glBeginPerfQueryINTEL	back to summary
public static native void glBeginPerfQueryINTEL(int queryHandle)

glCreatePerfQueryINTEL	back to summary
public static void glCreatePerfQueryINTEL(int queryId, IntBuffer queryHandle)

glCreatePerfQueryINTEL	back to summary
public static int glCreatePerfQueryINTEL(int queryId) Annotations @NativeType:void

glCreatePerfQueryINTEL	back to summary
public static void glCreatePerfQueryINTEL(int queryId, int[] queryHandle) Array version of: `CreatePerfQueryINTEL`

glDeletePerfQueryINTEL	back to summary
public static native void glDeletePerfQueryINTEL(int queryHandle)

glEndPerfQueryINTEL	back to summary
public static native void glEndPerfQueryINTEL(int queryHandle)

glGetFirstPerfQueryIdINTEL	back to summary
public static void glGetFirstPerfQueryIdINTEL(IntBuffer queryId)

glGetFirstPerfQueryIdINTEL	back to summary
public static int glGetFirstPerfQueryIdINTEL() Annotations @NativeType:void

glGetFirstPerfQueryIdINTEL	back to summary
public static void glGetFirstPerfQueryIdINTEL(int[] queryId) Array version of: `GetFirstPerfQueryIdINTEL`

glGetNextPerfQueryIdINTEL	back to summary
public static void glGetNextPerfQueryIdINTEL(int queryId, IntBuffer nextQueryId)

glGetNextPerfQueryIdINTEL	back to summary
public static int glGetNextPerfQueryIdINTEL(int queryId) Annotations @NativeType:void

glGetNextPerfQueryIdINTEL	back to summary
public static void glGetNextPerfQueryIdINTEL(int queryId, int[] nextQueryId) Array version of: `GetNextPerfQueryIdINTEL`

glGetPerfCounterInfoINTEL	back to summary
public static void glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, IntBuffer counterOffset, IntBuffer counterDataSize, IntBuffer counterTypeEnum, IntBuffer counterDataTypeEnum, LongBuffer rawCounterMaxValue)

glGetPerfCounterInfoINTEL	back to summary
public static void glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, int[] counterOffset, int[] counterDataSize, int[] counterTypeEnum, int[] counterDataTypeEnum, long[] rawCounterMaxValue) Array version of: `GetPerfCounterInfoINTEL`

glGetPerfQueryDataINTEL	back to summary
public static void glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, IntBuffer bytesWritten)

glGetPerfQueryDataINTEL	back to summary
public static void glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, int[] bytesWritten) Array version of: `GetPerfQueryDataINTEL`

glGetPerfQueryIdByNameINTEL	back to summary
public static void glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, IntBuffer queryId)

glGetPerfQueryIdByNameINTEL	back to summary
public static void glGetPerfQueryIdByNameINTEL(CharSequence queryName, IntBuffer queryId)

glGetPerfQueryIdByNameINTEL	back to summary
public static int glGetPerfQueryIdByNameINTEL(CharSequence queryName) Annotations @NativeType:void

glGetPerfQueryIdByNameINTEL	back to summary
public static void glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, int[] queryId) Array version of: `GetPerfQueryIdByNameINTEL`

glGetPerfQueryIdByNameINTEL	back to summary
public static void glGetPerfQueryIdByNameINTEL(CharSequence queryName, int[] queryId) Array version of: `GetPerfQueryIdByNameINTEL`

glGetPerfQueryInfoINTEL	back to summary
public static void glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, IntBuffer dataSize, IntBuffer noCounters, IntBuffer noInstances, IntBuffer capsMask)

glGetPerfQueryInfoINTEL	back to summary
public static void glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, int[] dataSize, int[] noCounters, int[] noInstances, int[] capsMask) Array version of: `GetPerfQueryInfoINTEL`

nglCreatePerfQueryINTEL	back to summary
public static native void nglCreatePerfQueryINTEL(int queryId, long queryHandle)

nglGetFirstPerfQueryIdINTEL	back to summary
public static native void nglGetFirstPerfQueryIdINTEL(long queryId)

nglGetNextPerfQueryIdINTEL	back to summary
public static native void nglGetNextPerfQueryIdINTEL(int queryId, long nextQueryId)

nglGetPerfCounterInfoINTEL	back to summary
public static native void nglGetPerfCounterInfoINTEL(int queryId, int counterId, int counterNameLength, long counterName, int counterDescLength, long counterDesc, long counterOffset, long counterDataSize, long counterTypeEnum, long counterDataTypeEnum, long rawCounterMaxValue)

nglGetPerfQueryDataINTEL	back to summary
public static native void nglGetPerfQueryDataINTEL(int queryHandle, int flags, int dataSize, long data, long bytesWritten)

nglGetPerfQueryIdByNameINTEL	back to summary
public static native void nglGetPerfQueryIdByNameINTEL(long queryName, long queryId)

nglGetPerfQueryInfoINTEL	back to summary
public static native void nglGetPerfQueryInfoINTEL(int queryId, int queryNameLength, long queryName, long dataSize, long noCounters, long noInstances, long capsMask)

public Class INTELPerformanceQuery

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail