GPUDevice: limits-Eigenschaft

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 schreibgeschützte limits-Eigenschaft des GPUDevice-Interfaces gibt ein GPUSupportedLimits-Objekt zurück, das die von der Gerätes unterstützten Limits beschreibt. Alle Grenzwerte werden enthalten sein, und die während der Erstellung des Geräts angeforderten Limits (d.h. wenn GPUAdapter.requestDevice() aufgerufen wird) werden in diesen Werten widergespiegelt.

Hinweis: Nicht alle Limits werden wie erwartet gemeldet, selbst wenn sie von der zugrunde liegenden Hardware unterstützt werden. Siehe GPUAdapter.limits für mehr Details.

Wert

Eine Instanz eines GPUSupportedLimits-Objekts.

Beispiele

Im folgenden Code überprüfen wir den GPUAdapter.limits-Wert von maxBindGroups, um zu sehen, ob er gleich oder größer als 6 ist. Unsere theoretische Beispiel-App benötigt idealerweise 6 Bindungsgruppen. Wenn der zurückgegebene Wert >= 6 ist, fügen wir ein maximales Limit von 6 zum requiredLimits-Objekt hinzu.

Wir überprüfen dann, ob das erwartete Limit auf dem resultierenden Gerät festgelegt wurde, indem wir seinen Wert in die Konsole protokollieren.

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 requiredLimits = {};

  // App ideally needs 6 bind groups, so we'll try to request what the app needs
  if (adapter.limits.maxBindGroups >= 6) {
    requiredLimits.maxBindGroups = 6;
  }

  const device = await adapter.requestDevice({
    requiredLimits,
  });

  console.log(device.limits.maxBindGroups);

  // ...
}

Spezifikationen

Specification
WebGPU
# dom-gpudevice-limits

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch