WebGLRenderingContext: hint() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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_derivativesErweiterung:ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES-
Genauigkeit der Ableitungsberechnung für die eingebauten GLSL-Funktionen:
dFdx,dFdyundfwidth.
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
| Spezifikation |
|---|
| WebGL Specification # 5.14.3 |