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: Dieses Feature ist verfügbar in Web Workers.

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

Syntax

js
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.

js
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

Siehe auch