GPUDevice

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

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

Die GPUDevice-Schnittstelle der WebGPU API repräsentiert ein logisches GPU-Gerät. Dies ist die Hauptschnittstelle, über die die meisten Funktionen von WebGPU genutzt werden.

Ein GPUDevice-Objekt wird mit der Methode GPUAdapter.requestDevice() angefordert.

EventTarget GPUDevice

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, EventTarget.

features Schreibgeschützt

Ein GPUSupportedFeatures-Objekt, das zusätzliche Funktionalitäten beschreibt, die vom Gerät unterstützt werden.

label

Ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts verwendet werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

limits Schreibgeschützt

Ein GPUSupportedLimits-Objekt, das die vom Gerät unterstützten Grenzen beschreibt.

lost Schreibgeschützt

Enthält ein Promise, das während der gesamten Lebensdauer des Geräts ausstehend bleibt und sich mit einem GPUDeviceLostInfo-Objekt auflöst, wenn das Gerät verloren geht.

queue Schreibgeschützt

Gibt die primäre GPUQueue für das Gerät zurück.

Instanz-Methoden

Erbt Methoden von seinem Elternteil, EventTarget.

createBindGroup()

Erstellt eine GPUBindGroup basierend auf einem GPUBindGroupLayout, das eine Gruppe von Ressourcen definiert, die zusammen gebunden werden und wie diese Ressourcen in Shader-Phasen verwendet werden.

createBindGroupLayout()

Erstellt ein GPUBindGroupLayout, das die Struktur und den Zweck von verwandten GPU-Ressourcen wie Buffern definiert, die in einer Pipeline verwendet werden und als Vorlage bei der Erstellung von GPUBindGroups dient.

createBuffer()

Erstellt einen GPUBuffer, um Rohdaten für GPU-Operationen zu speichern.

createCommandEncoder()

Erstellt einen GPUCommandEncoder, der verwendet wird, um Befehle für die GPU zu kodieren.

createComputePipeline()

Erstellt eine GPUComputePipeline, die die Compute-Shader-Phase steuern kann und in einem GPUComputePassEncoder verwendet werden kann.

createComputePipelineAsync()

Gibt ein Promise zurück, das mit einer GPUComputePipeline erfüllt wird, die die Compute-Shader-Phase steuern kann und in einem GPUComputePassEncoder verwendet werden kann, sobald die Pipeline verwendet werden kann, ohne dass Verzögerungen auftreten.

createPipelineLayout()

Erstellt ein GPUPipelineLayout, das die GPUBindGroupLayouts definiert, die von einer Pipeline verwendet werden. GPUBindGroups, die während der Befehlskodierung mit der Pipeline verwendet werden, müssen kompatible GPUBindGroupLayouts haben.

createQuerySet()

Erstellt ein GPUQuerySet, das verwendet werden kann, um die Ergebnisse von Abfragen bei Durchläufen aufzuzeichnen, wie z.B. Occlusion- oder Zeitstempel-Abfragen.

createRenderBundleEncoder()

Erstellt einen GPURenderBundleEncoder, der verwendet werden kann, um Bündel von Befehlen vorab aufzuzeichnen. Diese können in GPURenderPassEncoders über die Methode executeBundles() beliebig oft wiederverwendet werden.

createRenderPipeline()

Erstellt eine GPURenderPipeline, die die Vertex- und Fragment-Shader-Phasen steuern kann und in einem GPURenderPassEncoder oder GPURenderBundleEncoder verwendet werden kann.

createRenderPipelineAsync()

Gibt ein Promise zurück, das mit einer GPURenderPipeline erfüllt wird, die die Vertex- und Fragment-Shader-Phasen steuern kann und in einem GPURenderPassEncoder oder GPURenderBundleEncoder verwendet werden kann, sobald die Pipeline verwendet werden kann, ohne dass Verzögerungen auftreten.

createSampler()

Erstellt einen GPUSampler, der steuert, wie Shader die Texturnutzungsdaten transformieren und filtern.

createShaderModule()

Erstellt ein GPUShaderModule aus einem String von WGSL-Quellcode.

createTexture()

Erstellt eine GPUTexture, um Texturdaten zu speichern, die in GPU-Rendering-Operationen verwendet werden.

destroy()

Zerstört das Gerät und verhindert weitere Operationen darauf.

importExternalTexture()

Nimmt ein HTMLVideoElement als Eingabe und gibt ein GPUExternalTexture-Wrapper-Objekt zurück, das einen Schnappschuss des Videos enthält, der in GPU-Rendering-Operationen verwendet werden kann.

popErrorScope()

Hebt einen bestehenden GPU-Fehlerbereich aus dem Fehlerbereich-Stack und gibt ein Promise zurück, das sich auflöst in ein Objekt (GPUInternalError, GPUOutOfMemoryError oder GPUValidationError), das den ersten im Bereich erfassten Fehler beschreibt, oder null, wenn kein Fehler aufgetreten ist.

pushErrorScope()

Schiebt einen neuen GPU-Fehlerbereich auf den Fehlerbereich-Stack des Geräts, um Fehler eines bestimmten Typs zu erfassen.

Ereignisse

uncapturederror

Wird ausgelöst, wenn ein Fehler auftritt, der nicht von einem GPU-Fehlerbereich erfasst wurde, um eine Möglichkeit zu bieten, unerwartete Fehler zu melden. Bekannte Fehlerfälle sollten mit pushErrorScope() und popErrorScope() behandelt werden.

Beispiele

js
async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }

  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  const device = await adapter.requestDevice();

  const shaderModule = device.createShaderModule({
    code: shaders,
  });

  //...
}

Siehe die oben aufgelisteten Seiten der einzelnen Mitglieder und die folgenden Demo-Seiten für weitere Beispiele zur Nutzung von GPUDevice:

Spezifikationen

Specification
WebGPU
# gpudevice

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch