EXT_disjoint_timer_query: getQueryObjectEXT() method
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The EXT_disjoint_timer_query.getQueryObjectEXT() method
of the WebGL API returns the state of a
query object.
Syntax
js
getQueryObjectEXT(query, pname)
Parameters
query-
A
WebGLQueryobject from which to return information. pname-
A
GLenumspecifying which information to return. Must beext.QUERY_RESULT_EXTorext.QUERY_RESULT_AVAILABLE_EXT.
Return value
Depends on pname:
- If
pnameisext.QUERY_RESULT_EXT: AGLuint64EXTcontaining the query result. - If
pnameisext.QUERY_RESULT_AVAILABLE_EXT: AGLbooleanindicating whether or not a query result is available.
Examples
js
const ext = gl.getExtension("EXT_disjoint_timer_query");
const query = ext.createQueryEXT();
ext.beginQueryEXT(ext.TIME_ELAPSED_EXT, query);
// Draw
ext.endQueryEXT(ext.TIME_ELAPSED_EXT);
// At some point in the future, after returning control to the browser
const available = ext.getQueryObjectEXT(query, ext.QUERY_RESULT_AVAILABLE_EXT);
const disjoint = gl.getParameter(ext.GPU_DISJOINT_EXT);
if (available && !disjoint) {
// See how much time the rendering of the object took in nanoseconds.
const timeElapsed = ext.getQueryObjectEXT(query, ext.QUERY_RESULT_EXT);
}
Specifications
| Specification |
|---|
| WebGL EXT_disjoint_timer_query Extension Specification |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getQueryObjectEXT | ||||||||||||