All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.lwjgl.opengles.INTELPerformanceQuery Maven / Gradle / Ivy

Go to download

A royalty-free, cross-platform API for full-function 2D and 3D graphics on embedded systems - including consoles, phones, appliances and vehicles.

There is a newer version: 3.3.4
Show newest version
/*
 * Copyright LWJGL. All rights reserved.
 * License terms: https://www.lwjgl.org/license
 * MACHINE GENERATED FILE, DO NOT EDIT
 */
package org.lwjgl.opengles;

import java.nio.*;

import org.lwjgl.system.*;

import static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryStack.*;
import static org.lwjgl.system.MemoryUtil.*;

/**
 * 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.

*/ public class INTELPerformanceQuery { /** Returned by the capsMask parameter of GetPerfQueryInfoINTEL. */ public static final int GL_PERFQUERY_SINGLE_CONTEXT_INTEL = 0x0, GL_PERFQUERY_GLOBAL_CONTEXT_INTEL = 0x1; /** Accepted by the flags parameter of GetPerfQueryDataINTEL. */ public static final int GL_PERFQUERY_WAIT_INTEL = 0x83FB, GL_PERFQUERY_FLUSH_INTEL = 0x83FA, GL_PERFQUERY_DONOT_FLUSH_INTEL = 0x83F9; /** Returned by GetPerfCounterInfoINTEL function as counter type enumeration in location pointed by counterTypeEnum. */ public static final int GL_PERFQUERY_COUNTER_EVENT_INTEL = 0x94F0, GL_PERFQUERY_COUNTER_DURATION_NORM_INTEL = 0x94F1, GL_PERFQUERY_COUNTER_DURATION_RAW_INTEL = 0x94F2, GL_PERFQUERY_COUNTER_THROUGHPUT_INTEL = 0x94F3, GL_PERFQUERY_COUNTER_RAW_INTEL = 0x94F4, GL_PERFQUERY_COUNTER_TIMESTAMP_INTEL = 0x94F5; /** Returned by glGetPerfCounterInfoINTEL function as counter data type enumeration in location pointed by counterDataTypeEnum. */ public static final int GL_PERFQUERY_COUNTER_DATA_UINT32_INTEL = 0x94F8, GL_PERFQUERY_COUNTER_DATA_UINT64_INTEL = 0x94F9, GL_PERFQUERY_COUNTER_DATA_FLOAT_INTEL = 0x94FA, GL_PERFQUERY_COUNTER_DATA_DOUBLE_INTEL = 0x94FB, GL_PERFQUERY_COUNTER_DATA_BOOL32_INTEL = 0x94FC; /** Accepted by the {@code pname} parameter of GetIntegerv. */ public static final int GL_PERFQUERY_QUERY_NAME_LENGTH_MAX_INTEL = 0x94FD, GL_PERFQUERY_COUNTER_NAME_LENGTH_MAX_INTEL = 0x94FE, GL_PERFQUERY_COUNTER_DESC_LENGTH_MAX_INTEL = 0x94FF; /** Accepted by the {@code pname} parameter of GetBooleanv. */ public static final int GL_PERFQUERY_GPA_EXTENDED_COUNTERS_INTEL = 0x9500; static { GLES.initialize(); } protected INTELPerformanceQuery() { throw new UnsupportedOperationException(); } static boolean isAvailable(GLESCapabilities caps) { return checkFunctions( caps.glBeginPerfQueryINTEL, caps.glCreatePerfQueryINTEL, caps.glDeletePerfQueryINTEL, caps.glEndPerfQueryINTEL, caps.glGetFirstPerfQueryIdINTEL, caps.glGetNextPerfQueryIdINTEL, caps.glGetPerfCounterInfoINTEL, caps.glGetPerfQueryDataINTEL, caps.glGetPerfQueryIdByNameINTEL, caps.glGetPerfQueryInfoINTEL ); } // --- [ glBeginPerfQueryINTEL ] --- public static native void glBeginPerfQueryINTEL(int queryHandle); // --- [ glCreatePerfQueryINTEL ] --- public static native void nglCreatePerfQueryINTEL(int queryId, long queryHandle); public static void glCreatePerfQueryINTEL(int queryId, IntBuffer queryHandle) { if (CHECKS) { check(queryHandle, 1); } nglCreatePerfQueryINTEL(queryId, memAddress(queryHandle)); } public static int glCreatePerfQueryINTEL(int queryId) { MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { IntBuffer queryHandle = stack.callocInt(1); nglCreatePerfQueryINTEL(queryId, memAddress(queryHandle)); return queryHandle.get(0); } finally { stack.setPointer(stackPointer); } } // --- [ glDeletePerfQueryINTEL ] --- public static native void glDeletePerfQueryINTEL(int queryHandle); // --- [ glEndPerfQueryINTEL ] --- public static native void glEndPerfQueryINTEL(int queryHandle); // --- [ glGetFirstPerfQueryIdINTEL ] --- public static native void nglGetFirstPerfQueryIdINTEL(long queryId); public static void glGetFirstPerfQueryIdINTEL(IntBuffer queryId) { if (CHECKS) { check(queryId, 1); } nglGetFirstPerfQueryIdINTEL(memAddress(queryId)); } public static int glGetFirstPerfQueryIdINTEL() { MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { IntBuffer queryId = stack.callocInt(1); nglGetFirstPerfQueryIdINTEL(memAddress(queryId)); return queryId.get(0); } finally { stack.setPointer(stackPointer); } } // --- [ glGetNextPerfQueryIdINTEL ] --- public static native void nglGetNextPerfQueryIdINTEL(int queryId, long nextQueryId); public static void glGetNextPerfQueryIdINTEL(int queryId, IntBuffer nextQueryId) { if (CHECKS) { check(nextQueryId, 1); } nglGetNextPerfQueryIdINTEL(queryId, memAddress(nextQueryId)); } public static int glGetNextPerfQueryIdINTEL(int queryId) { MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { IntBuffer nextQueryId = stack.callocInt(1); nglGetNextPerfQueryIdINTEL(queryId, memAddress(nextQueryId)); return nextQueryId.get(0); } finally { stack.setPointer(stackPointer); } } // --- [ glGetPerfCounterInfoINTEL ] --- 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 void glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, IntBuffer counterOffset, IntBuffer counterDataSize, IntBuffer counterTypeEnum, IntBuffer counterDataTypeEnum, LongBuffer rawCounterMaxValue) { if (CHECKS) { check(counterOffset, 1); check(counterDataSize, 1); check(counterTypeEnum, 1); check(counterDataTypeEnum, 1); check(rawCounterMaxValue, 1); } nglGetPerfCounterInfoINTEL(queryId, counterId, counterName.remaining(), memAddress(counterName), counterDesc.remaining(), memAddress(counterDesc), memAddress(counterOffset), memAddress(counterDataSize), memAddress(counterTypeEnum), memAddress(counterDataTypeEnum), memAddress(rawCounterMaxValue)); } // --- [ glGetPerfQueryDataINTEL ] --- public static native void nglGetPerfQueryDataINTEL(int queryHandle, int flags, int dataSize, long data, long bytesWritten); public static void glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, IntBuffer bytesWritten) { if (CHECKS) { check(bytesWritten, 1); } nglGetPerfQueryDataINTEL(queryHandle, flags, data.remaining(), memAddress(data), memAddress(bytesWritten)); } // --- [ glGetPerfQueryIdByNameINTEL ] --- public static native void nglGetPerfQueryIdByNameINTEL(long queryName, long queryId); public static void glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, IntBuffer queryId) { if (CHECKS) { checkNT1(queryName); check(queryId, 1); } nglGetPerfQueryIdByNameINTEL(memAddress(queryName), memAddress(queryId)); } public static void glGetPerfQueryIdByNameINTEL(CharSequence queryName, IntBuffer queryId) { if (CHECKS) { check(queryId, 1); } MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { ByteBuffer queryNameEncoded = stack.ASCII(queryName); nglGetPerfQueryIdByNameINTEL(memAddress(queryNameEncoded), memAddress(queryId)); } finally { stack.setPointer(stackPointer); } } public static int glGetPerfQueryIdByNameINTEL(CharSequence queryName) { MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { ByteBuffer queryNameEncoded = stack.ASCII(queryName); IntBuffer queryId = stack.callocInt(1); nglGetPerfQueryIdByNameINTEL(memAddress(queryNameEncoded), memAddress(queryId)); return queryId.get(0); } finally { stack.setPointer(stackPointer); } } // --- [ glGetPerfQueryInfoINTEL ] --- public static native void nglGetPerfQueryInfoINTEL(int queryId, int queryNameLength, long queryName, long dataSize, long noCounters, long noInstances, long capsMask); public static void glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, IntBuffer dataSize, IntBuffer noCounters, IntBuffer noInstances, IntBuffer capsMask) { if (CHECKS) { check(dataSize, 1); check(noCounters, 1); check(noInstances, 1); check(capsMask, 1); } nglGetPerfQueryInfoINTEL(queryId, queryName.remaining(), memAddress(queryName), memAddress(dataSize), memAddress(noCounters), memAddress(noInstances), memAddress(capsMask)); } /** Array version of: {@link #glCreatePerfQueryINTEL CreatePerfQueryINTEL} */ public static void glCreatePerfQueryINTEL(int queryId, int[] queryHandle) { long __functionAddress = GLES.getICD().glCreatePerfQueryINTEL; if (CHECKS) { check(__functionAddress); check(queryHandle, 1); } callPV(__functionAddress, queryId, queryHandle); } /** Array version of: {@link #glGetFirstPerfQueryIdINTEL GetFirstPerfQueryIdINTEL} */ public static void glGetFirstPerfQueryIdINTEL(int[] queryId) { long __functionAddress = GLES.getICD().glGetFirstPerfQueryIdINTEL; if (CHECKS) { check(__functionAddress); check(queryId, 1); } callPV(__functionAddress, queryId); } /** Array version of: {@link #glGetNextPerfQueryIdINTEL GetNextPerfQueryIdINTEL} */ public static void glGetNextPerfQueryIdINTEL(int queryId, int[] nextQueryId) { long __functionAddress = GLES.getICD().glGetNextPerfQueryIdINTEL; if (CHECKS) { check(__functionAddress); check(nextQueryId, 1); } callPV(__functionAddress, queryId, nextQueryId); } /** Array version of: {@link #glGetPerfCounterInfoINTEL GetPerfCounterInfoINTEL} */ public static void glGetPerfCounterInfoINTEL(int queryId, int counterId, ByteBuffer counterName, ByteBuffer counterDesc, int[] counterOffset, int[] counterDataSize, int[] counterTypeEnum, int[] counterDataTypeEnum, long[] rawCounterMaxValue) { long __functionAddress = GLES.getICD().glGetPerfCounterInfoINTEL; if (CHECKS) { check(__functionAddress); check(counterOffset, 1); check(counterDataSize, 1); check(counterTypeEnum, 1); check(counterDataTypeEnum, 1); check(rawCounterMaxValue, 1); } callPPPPPPPV(__functionAddress, queryId, counterId, counterName.remaining(), memAddress(counterName), counterDesc.remaining(), memAddress(counterDesc), counterOffset, counterDataSize, counterTypeEnum, counterDataTypeEnum, rawCounterMaxValue); } /** Array version of: {@link #glGetPerfQueryDataINTEL GetPerfQueryDataINTEL} */ public static void glGetPerfQueryDataINTEL(int queryHandle, int flags, ByteBuffer data, int[] bytesWritten) { long __functionAddress = GLES.getICD().glGetPerfQueryDataINTEL; if (CHECKS) { check(__functionAddress); check(bytesWritten, 1); } callPPV(__functionAddress, queryHandle, flags, data.remaining(), memAddress(data), bytesWritten); } /** Array version of: {@link #glGetPerfQueryIdByNameINTEL GetPerfQueryIdByNameINTEL} */ public static void glGetPerfQueryIdByNameINTEL(ByteBuffer queryName, int[] queryId) { long __functionAddress = GLES.getICD().glGetPerfQueryIdByNameINTEL; if (CHECKS) { check(__functionAddress); checkNT1(queryName); check(queryId, 1); } callPPV(__functionAddress, memAddress(queryName), queryId); } /** Array version of: {@link #glGetPerfQueryIdByNameINTEL GetPerfQueryIdByNameINTEL} */ public static void glGetPerfQueryIdByNameINTEL(CharSequence queryName, int[] queryId) { long __functionAddress = GLES.getICD().glGetPerfQueryIdByNameINTEL; if (CHECKS) { check(__functionAddress); check(queryId, 1); } MemoryStack stack = stackGet(); int stackPointer = stack.getPointer(); try { ByteBuffer queryNameEncoded = stack.ASCII(queryName); callPPV(__functionAddress, memAddress(queryNameEncoded), queryId); } finally { stack.setPointer(stackPointer); } } /** Array version of: {@link #glGetPerfQueryInfoINTEL GetPerfQueryInfoINTEL} */ public static void glGetPerfQueryInfoINTEL(int queryId, ByteBuffer queryName, int[] dataSize, int[] noCounters, int[] noInstances, int[] capsMask) { long __functionAddress = GLES.getICD().glGetPerfQueryInfoINTEL; if (CHECKS) { check(__functionAddress); check(dataSize, 1); check(noCounters, 1); check(noInstances, 1); check(capsMask, 1); } callPPPPPV(__functionAddress, queryId, queryName.remaining(), memAddress(queryName), dataSize, noCounters, noInstances, capsMask); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy