WebGL
The EXT_disjoint_timer_query extension is part of the WebGL API and provides a way to measure the duration of a set of GL commands, without stalling the rendering pipeline.
WebGL extensions are available using the WebGLRenderingContext.getExtension() method. For more information, see Using WebGL extensions.
[!NOTE] This extension should be available in WebGLRenderingContext contexts only. EXT_disjoint_timer_query_webgl2 is available in WebGL2RenderingContext contexts.
In WebGL 2, the OpenGL method
getQueryObject()is renamed to WebGL2RenderingContext.getQueryParameter. In WebGL 2, other queries (such as occlusion queries and primitive queries) are possible using WebGLQuery objects.
Types
This extension exposes a new type:
GLuint64EXT- : Unsigned 64-bit integer number.
Constants
This extension exposes seven new constants.
ext.QUERY_COUNTER_BITS_EXT- : A WebGL_API/Types indicating the number of bits used to hold the query result for the given target.
ext.CURRENT_QUERY_EXT- : A WebGLQuery object, which is the currently active query for the given target.
ext.QUERY_RESULT_EXT- : A WebGL_API/Types containing the query result.
ext.QUERY_RESULT_AVAILABLE_EXT- : A WebGL_API/Types indicating whether or not a query result is available.
ext.TIME_ELAPSED_EXT- : Elapsed time (in nanoseconds).
ext.TIMESTAMP_EXT- : The current time.
ext.GPU_DISJOINT_EXT- : A WebGL_API/Types indicating whether or not the GPU performed any disjoint operation.
Instance methods
This extension exposes eight new methods.
- EXT_disjoint_timer_query.createQueryEXT()
- : Creates a new WebGLQuery.
- EXT_disjoint_timer_query.deleteQueryEXT()
- : Deletes a given WebGLQuery.
- EXT_disjoint_timer_query.isQueryEXT()
- : Returns
trueif a given object is a valid WebGLQuery.
- : Returns
- EXT_disjoint_timer_query.beginQueryEXT()
- : The timer starts when all commands prior to
beginQueryEXThave been fully executed.
- : The timer starts when all commands prior to
- EXT_disjoint_timer_query.endQueryEXT()
- : The timer stops when all commands prior to
endQueryEXThave been fully executed.
- : The timer stops when all commands prior to
- EXT_disjoint_timer_query.queryCounterEXT()
- : Records the current time into the corresponding query object.
- EXT_disjoint_timer_query.getQueryEXT()
- : Returns information about a query target.
- EXT_disjoint_timer_query.getQueryObjectEXT()
- : Return the state of a query object.
Examples
const ext = gl.getExtension("EXT_disjoint_timer_query");
Specifications
Browser compatibility
See also
- WebGLRenderingContext.getExtension()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
