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 an. Die Interpretation dieser Hinweise hängt von der Implementierung ab.

Syntax

hint(target, mode)

Parameter

target

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

gl.GENERATE_MIPMAP_HINT: Qualität der Filterung beim Erzeugen 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 eingebauten GLSL-Funktionen: dFdx, dFdy und fwidth.

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

gl.FRAGMENT_SHADER_DERIVATIVE_HINT: Dasselbe wie ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES

mode

Legt das Verhalten fest. Der Standardwert ist gl.DONT_CARE. Mögliche 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 gibt keine Präferenz für dieses Verhalten.

Rückgabewert

Keiner (undefined).

Beispiele

Das folgende Beispiel gibt an, dass bei der Erzeugung von Mipmap-Bildern die effizienteste Qualität der Filterung anstelle der besten Qualität verwendet werden soll.

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

Spezifikationen

Specification
WebGL Specification # 5.14.3