WebGL2RenderingContext: getQuery()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGL2RenderingContext.getQuery()-Methode der WebGL 2 API gibt die derzeit aktive WebGLQuery für das target zurück oder null.

Syntax

js
getQuery(target, pname)

Parameter

target

Ein GLenum, das das Ziel der Query spezifiziert. Mögliche Werte:

gl.ANY_SAMPLES_PASSED

Gibt eine Occlusion-Query an: Diese Queries erkennen, ob ein Objekt sichtbar ist (ob die umfassten Zeichnungsbefehle den Tiefentest bestehen und wenn ja, wie viele Samples bestehen).

gl.ANY_SAMPLES_PASSED_CONSERVATIVE

Dasselbe wie oben, aber weniger genau und schneller.

gl.TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN

Anzahl der Primitiven, die in Transform-Feedback-Puffer geschrieben werden.

pname

Ein GLenum, das das Ziel des Query-Objekts spezifiziert. Muss gl.CURRENT_QUERY sein.

Rückgabewert

Ein WebGLQuery-Objekt.

Beispiele

js
const currentQuery = gl.getQuery(gl.ANY_SAMPLES_PASSED, gl.CURRENT_QUERY);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.12

Browser-Kompatibilität

Siehe auch