WebGLRenderingContext: hint() Methode

Baseline Widely available

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

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

Die WebGLRenderingContext.hint()-Methode der WebGL API gibt Hinweise für bestimmte Verhaltensweisen. Die Interpretation dieser Hinweise hängt von der Implementierung ab.

Syntax

hint(target, mode)

Parameter

target

Legt fest, welches Verhalten gesteuert werden soll. Mögliche Werte:

gl.GENERATE_MIPMAP_HINT: Qualität der Filterung beim Generieren von Mipmap-Bildern mit WebGLRenderingContext.generateMipmap().

Bei Verwendung der OES_standard_derivatives-Erweiterung:

ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES: Genauigkeit der Ableitungsberechnung für die integrierten GLSL-Funktionen: dFdx, dFdy und fwidth.

Bei Verwendung eines WebGL 2 Kontext, sind zusätzlich die folgenden Werte verfügbar:

gl.FRAGMENT_SHADER_DERIVATIVE_HINT: Gleich wie ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES

mode

Legt das Verhalten fest. Der Standardwert ist gl.DONT_CARE. Die möglichen Werte sind:

gl.FASTEST: Das effizienteste Verhalten sollte verwendet werden.
gl.NICEST: Die korrekteste oder qualitativ hochwertigste Option sollte verwendet werden.
gl.DONT_CARE: Es besteht keine Präferenz für dieses Verhalten.

Rückgabewert

Keiner (undefined).

Beispiele

Im folgenden Beispiel wird angedeutet, dass die Qualität der Filterung beim Generieren von Mipmap-Bildern am effizientesten statt in der besten Qualität sein soll.

gl.hint(gl.GENERATE_MIPMAP_HINT, gl.FASTEST);

Spezifikationen

Specification
WebGL Specification # 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser