GPUSupportedLimits

Instanzeigenschaften

Die folgenden Grenzwerte werden durch Eigenschaften eines GPUSupportedLimits-Objekts dargestellt. Ausführliche Beschreibungen dazu, worauf sich die Grenzwerte beziehen, finden Sie im Abschnitt Grenzwerte der Spezifikation.

Alle Eigenschaften sind schreibgeschützt.

Beschreibung

Auf das GPUSupportedLimits-Objekt des aktuellen Adapters greifen Sie über die Eigenschaft GPUAdapter.limits zu.

Anstatt die genauen Grenzwerte jeder GPU anzugeben, melden Browser üblicherweise abgestufte Werte für die einzelnen Grenzwerte. Dadurch stehen weniger eindeutige Informationen für beiläufiges Fingerprinting zur Verfügung. Die Abstufungen eines bestimmten Grenzwerts könnten beispielsweise bei 2048, 8192 und 32768 liegen. Wenn der tatsächliche Grenzwert Ihrer GPU 16384 beträgt, meldet der Browser dennoch 8192.

Da verschiedene Browser dies unterschiedlich handhaben und sich die abgestuften Werte im Laufe der Zeit ändern können, lässt sich kaum genau vorhersagen, welche Grenzwerte zu erwarten sind. Gründliche Tests sind daher empfehlenswert.

Wenn Sie GPUAdapter.requestDevice() aufrufen, um ein GPUDevice anzufordern, das bestimmte Mindestanforderungen („Grenzwerte“) erfüllt, übergeben Sie ein Objekt mit denselben Eigenschaftsnamen wie GPUSupportedLimits.

Grenzwerte für Storage Buffer und Texturen außerhalb des Kompatibilitätsmodus

Wenn Sie ein Device erstellen, werden die angeforderten Grenzwerte maxStorageBuffersInFragmentStage, maxStorageBuffersInVertexStage, maxStorageTexturesInFragmentStage und maxStorageTexturesInVertexStage nicht als separate Werte beibehalten, sofern der WebGPU-Kompatibilitätsmodus nicht verwendet wird. Stattdessen erhöhen sie die Grenzwerte maxStorageBuffersPerShaderStage beziehungsweise maxStorageTexturesPerShaderStage, falls sie höher sind, und werden anschließend an diese angeglichen.

Beispiele

Im folgenden Code fragen wir den Wert von maxBindGroups über GPUAdapter.limits ab, um zu prüfen, ob er mindestens 6 beträgt. Unsere hypothetische Beispielanwendung benötigt idealerweise 6 Bind Groups. Wenn der zurückgegebene Wert >= 6 ist, fügen wir dem Objekt requiredLimits daher einen maximalen Grenzwert von 6 hinzu. Anschließend fordern wir mit GPUAdapter.requestDevice() ein Device mit dieser Grenzwertanforderung an:

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,
  });

  // …
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API