WEBGL_debug_renderer_info-Erweiterung
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2017 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WEBGL_debug_renderer_info-Erweiterung ist Teil der WebGL-API und stellt zwei Konstanten mit Informationen über den Grafiktreiber für Debugging-Zwecke bereit.
Abhängig von den Datenschutzeinstellungen des Browsers ist diese Erweiterung möglicherweise nur in privilegierten Kontexten verfügbar. Im Allgemeinen sollten Informationen über den Grafiktreiber nur in Ausnahmefällen verwendet werden, um Ihre WebGL-Inhalte zu optimieren oder GPU-Probleme zu untersuchen. Mit der Methode WebGLRenderingContext.getParameter() können Sie feststellen, welche Funktionen unterstützt werden. Mit dem Kontextattribut failIfMajorPerformanceCaveat können Sie steuern, ob überhaupt ein Kontext zurückgegeben werden soll, wenn die Leistung erheblich beeinträchtigt wäre.
WebGL-Erweiterungen sind über die Methode WebGLRenderingContext.getExtension() verfügbar.
Weitere Informationen finden Sie unter WebGL-Erweiterungen verwenden.
Hinweis:
Abhängig von den Datenschutzeinstellungen des Browsers ist diese Erweiterung möglicherweise nur in privilegierten Kontexten verfügbar oder funktioniert überhaupt nicht. In Firefox ist diese Erweiterung deaktiviert, wenn privacy.resistFingerprinting auf true gesetzt ist.
Diese Erweiterung ist sowohl für WebGL1- als auch für WebGL2-Kontexte verfügbar.
Konstanten
- ext.UNMASKED_VENDOR_WEBGL
-
Vendor-String des Grafiktreibers.
- ext.UNMASKED_RENDERER_WEBGL
-
Renderer-String des Grafiktreibers.
Beispiele
Mithilfe dieser Erweiterung können privilegierte Kontexte Debugging-Informationen über den Grafiktreiber der Benutzerin oder des Benutzers abrufen:
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const debugInfo = gl.getExtension("WEBGL_debug_renderer_info");
const vendor = gl.getParameter(debugInfo.UNMASKED_VENDOR_WEBGL);
const renderer = gl.getParameter(debugInfo.UNMASKED_RENDERER_WEBGL);
console.log(vendor);
console.log(renderer);
Spezifikationen
| Spezifikation |
|---|
| WebGL WEBGL_debug_renderer_info Khronos Ratified Extension Specification |